ChallengeUtil – Advanced Speedrunning & Challenge Plugin<\/p>\n
**Platform:** Minecraft 1.21.11 (Paper\/Spigot)
\n**Dependencies:** PlaceholderAPI (optional, for team chat prefixes)<\/p>\n
—<\/p>\n
**Overview**<\/p>\n
ChallengeUtil is a comprehensive Minecraft plugin designed for speedrunning servers and challenge gamemodes. It features **instant world resets** (~30 seconds, no server restart!), a built-in timer system, multiple game modes, and various challenge mechanics to create unique and engaging gameplay experiences.<\/p>\n
Perfect for **Velocity\/BungeeCord proxy networks** – players stay connected during world regeneration!<\/p>\n
—<\/p>\n
**Key Features**<\/p>\n
Instant World Reset System
\n– **10-20 second world regeneration** without server restart
\n– **Holodeck Strategy**: Players are smoothly transferred to a waiting room while the speedrun world regenerates
\n– **Random seed generation** for each reset
\n– **Proxy-friendly**: Full Velocity\/BungeeCord support with auto-reconnect
\n– **No disconnections**: Players remain connected throughout the entire reset process
\n– **Async world deletion**: Zero lag during world regeneration<\/p>\n
Advanced Timer System
\n– Real-time timer display above the hotbar (action bar)
\n– Format: `HH:MM:SS` with visual indicators
\n– Color-coded states:
\n – Light Purple when running
\n – Red with pause symbol (\u23f8) when paused
\n– Start, pause, reset, and resume functionality
\n– Persistent through pause\/resume cycles
\n– PlaceholderAPI support for external plugins<\/p>\n
Multiple Game Modes<\/p>\n
**Manhunt Mode**
\nClassic speedrunner vs hunters gameplay:
\n– **Runner Team**: 1+ speedrunners trying to defeat the Ender Dragon
\n– **Hunter Team**: 1+ hunters trying to stop the runners
\n– **Tracking Compass**: Hunters receive a compass that tracks the nearest runner
\n– **Team Protection**: Friendly fire protection within teams (configurable)
\n– **Spectator Mode**: Spectators can watch without interfering
\n– **Dynamic Spawning**: Hunters spawn 10 minutes after `\/start` for balanced gameplay<\/p>\n
**Team Race Mode**
\nCompetitive team-based speedrunning:
\n– **2-10 Teams**: Customizable team count with German names and colors
\n– **Available Teams**: Rot, Blau, Gr\u00fcn, Gelb, Lila, Aqua, Wei\u00df, Orange, Pink, Grau
\n– **Team Tracking Compass**: Each team tracks the nearest enemy team member
\n– **Color-coded UI**: Team names appear in their respective colors
\n– **Win Condition**: First team to defeat the Ender Dragon wins
\n– **Scoreboard Integration**: Real-time team tracking and status<\/p>\n
Challenge Modes<\/p>\n
**Chunk Items Challenge**
\n– Receive random items when entering new chunks
\n– **Player-specific**: Different players get different items from the same chunk
\n– **Persistent**: Each chunk gives the same item to a player on re-entry
\n– **Manhunt Integration**: Hunters receive items only after 10 minutes
\n– **Configurable Exclusions**: Customize which items can drop
\n– **Default Exclusions**: Overpowered items (Elytra, Netherite gear, Totems) excluded by default<\/p>\n
**Friendly Fire = OP Items Challenge**
\nDamage teammates, get rewards:
\n– **Damage Sync**: Both attacker and victim take the same damage
\n– **No Natural Regen**: Natural health regeneration disabled
\n– **Health-Based Rewards**: Lower health = better items
\n – **80-100% HP**: Basic items (Golden Apples, Arrows, Iron)
\n – **50-79% HP**: Medium items (Diamonds, Enchanted Iron gear)
\n – **25-49% HP**: Strong items (Diamond gear with Sharpness V, Totems)
\n – **1-24% HP**: Extremely OP items (Netherite, fully enchanted diamond gear, multiple totems)
\n– **Team Integration**: Works with both Manhunt and Team Race modes<\/p>\n
Advanced Configuration<\/p>\n
**Dual-World System**
\n– **Waiting Room**: Lobby world where players wait during resets (peaceful, frozen time)
\n– **Speedrun World**: Main world that gets regenerated with new seeds
\n– **Automatic Gamerule Management**: Different gamerules for each world
\n– **Smart Teleportation**: Surface-detection spawn system<\/p>\n
**World Generation Settings**
\n– World types: NORMAL, FLAT, LARGE_BIOMES, AMPLIFIED
\n– Structure generation toggle
\n– Configurable difficulty
\n– Random or fixed seed generation
\n– Custom spawn coordinates<\/p>\n
**Proxy Integration**
\n– Full BungeeCord\/Velocity support
\n– Auto-reconnect during world resets
\n– Configurable server names
\n– Companion proxy plugin included<\/p>\n
—<\/p>\n
**Commands**<\/p>\n
Main Commands<\/p>\n
| Command | Aliases | Description | Permission | Team Command Examples **Team Race Mode:** —<\/p>\n **Permissions**<\/p>\n Main Permissions<\/p>\n | Permission | Description | Default | Permission Hierarchy —<\/p>\n Host Control Features<\/p>\n Players with the `challenge.host` permission receive special tools:<\/p>\n **Host Control Item** **Host Control GUI** —<\/p>\n Configuration<\/p>\n The plugin features extensive configuration through `config.yml`:<\/p>\n Proxy Settings World Settings generation: difficulty: NORMAL # PEACEFUL, EASY, NORMAL, HARD<\/p>\n teleport: Gamerules Challenge Settings chunk_items: friendly_fire_item: —<\/p>\n **PlaceholderAPI Integration** (optional)<\/p>\n Available Placeholders<\/p>\n | Placeholder | Description | Example Output | Usage Example —<\/p>\n **Game Modes Comparison**<\/p>\n Mode Compatibility Matrix<\/p>\n | Feature | Manhunt | Team Race | Solo | **Note:** Manhunt and Team Race cannot be enabled simultaneously.<\/p>\n —<\/p>\n **Technical Details**<\/p>\n Performance —<\/p>\n **Installation**<\/p>\n Basic Installation Optional: PlaceholderAPI —<\/p>\n **Usage Examples**<\/p>\n Basic Speedrun Setup Manhunt Setup Team Race Setup —<\/p>\n **Troubleshooting**<\/p>\n Common Issues<\/p>\n **”Waiting room not found”** **Slow resets (>60 seconds)** **Players fall into void** **Same seed every reset** **Compass not working** **Chat prefixes not showing** —<\/p>\n **Perfect For**<\/p>\n – **Speedrunning Servers**: Instant resets for practice or races —<\/p>\n **License**<\/p>\n MIT License – Free to use for any server!<\/p>\n —<\/p>\n **Why Choose ChallengeUtil? —<\/p>\n **Built with \u2764\ufe0f for the Minecraft speedrunning community**<\/p>\n **Download now and revolutionize your speedrunning server!**<\/p>\n","protected":false},"excerpt":{"rendered":" A PaperMC Challenge Util including a timer, a waiting room system, fast world resets and different challenges that can be combined at will.<\/p>\n","protected":false},"featured_media":38400,"template":"","meta":{"_minecraft_slug":"challengeutil","_minecraft_project_id":"EPkgUkCn","_minecraft_author":"link_1503","_minecraft_license":"MIT","_minecraft_downloads":126,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"challengeutil.zip","_minecraft_size_bytes":4761891,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-15T19:02:23.262560Z","_minecraft_date_created":"2026-01-30T04:27:45.300185Z","_minecraft_date_modified":"2026-02-21T00:04:26.300629Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/challengeutil","_minecraft_icon_attachment_id":38400,"_minecraft_imported_at":"2026-06-01T19:50:07+00:00","_minecraft_import_hash":"82535d3da8bfe7f66ef9a38dcf3ea9c1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,126,866,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[41],"class_list":["post-38399","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-management","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-11"],"yoast_head":"\n
\n|———|———|————-|————|
\n| `\/start` | – | Start or resume the timer | `challenge.start` |
\n| `\/pause` | – | Pause the timer | `challenge.pause` |
\n| `\/reset` | – | Reset timer only (no world reset) | `challenge.reset` |
\n| `\/fullreset` | `\/resetworld`, `\/worldreset` | Holodeck reset – regenerate world instantly (3-5 sec) | `challenge.fullreset` |
\n| `\/join` | `\/play`, `\/go` | Join the speedrun world from waiting room | `challenge.join` |
\n| `\/settings` | `\/config`, `\/cfg` | Open settings GUI (waiting room only) | `challenge.settings` |
\n| `\/team
\n**Manhunt Mode:**
\n– `\/team runner` – Join the runner team
\n– `\/team hunter` – Join the hunter team
\n– `\/team spectator` – Join spectators<\/p>\n
\n– `\/team` – List all available teams and member counts
\n– `\/team Rot` – Join Team Rot (Red)
\n– `\/team Blau` – Join Team Blau (Blue)
\n– `\/team Gr\u00fcn` – Join Team Gr\u00fcn (Green)
\n– etc.<\/p>\n
\n|————|————-|———|
\n| `challenge.host` | **Master permission** – grants all admin commands | OP |
\n| `challenge.start` | Start\/resume the timer | OP |
\n| `challenge.pause` | Pause the timer | OP |
\n| `challenge.reset` | Reset timer only | OP |
\n| `challenge.fullreset` | Execute Holodeck reset (world regeneration) | OP |
\n| `challenge.settings` | Open settings GUI | OP |
\n| `challenge.join` | Join speedrun world from waiting room | True (all players) |
\n| `challenge.team` | Join teams in Manhunt\/Team Race | True (all players) |
\n| `challenge.*` | Grant all permissions | OP |<\/p>\n
\nThe `challenge.host` permission includes:
\n– `challenge.start`
\n– `challenge.pause`
\n– `challenge.reset`
\n– `challenge.fullreset`
\n– `challenge.settings`<\/p>\n
\n– **Enchanted Nether Star** automatically given on join
\n– **Right-click** to open Host Control GUI
\n– Quick access to all host commands without typing<\/p>\n
\nInteractive menu with three options:
\n1. **Start Challenge** (Green Wool) – Executes `\/start`
\n2. **Settings** (Comparator) – Opens `\/settings` GUI
\n3. **\u26a0 FULL RESET \u26a0** (Barrier) – Executes `\/fullreset` with warning<\/p>\n
\n“`yaml
\nproxy:
\n lobby-server: lobby1 # Lobby server name in proxy config
\n this-server-name: challenge1 # This server’s name in proxy config
\n“`<\/p>\n
\n“`yaml
\nworld:
\n waiting-room: waiting_room # Fallback world (lobby)
\n speedrun-world: speedrun_world # World that gets regenerated<\/p>\n
\n type: NORMAL # NORMAL, FLAT, LARGE_BIOMES, AMPLIFIED
\n generate-structures: true
\n random-seed: true<\/p>\n
\n waiting-room-spawn:
\n x: 0
\n y: 65
\n z: 0
\n speedrun-spawn:
\n x: 0
\n y: 100 # Auto-finds surface
\n z: 0
\n“`<\/p>\n
\nSeparate gamerule configurations for waiting room (peaceful, frozen time) and speedrun world (normal gameplay).<\/p>\n
\n“`yaml
\nchallenge:
\n allow-respawn: true # false = hardcore mode (spectator on death)<\/p>\n
\n excluded: # Items to exclude from random rewards
\n # – DIAMOND
\n # – EMERALD<\/p>\n
\n enabled: false # Toggle via GUI
\n“`<\/p>\n
\n|————-|————-|—————-|
\n| `%ch_prefix%` | Team prefix with color | `[RUNNER]`, `[HUNTER]`, `[Red]` |
\n| `%ch_suffix%` | Team suffix (reserved) | – |
\n| `%ch_team%` | Raw team name | `runner`, `hunter`, `Rot` |
\n| `%ch_team_color%` | Legacy team color code | `\u00a7d`, `\u00a76`, `\u00a7c` |<\/p>\n
\n**EssentialsX Chat:**
\n“`yaml
\nformat: ‘{ch_prefix}{DISPLAYNAME}{ch_suffix}\u00a7r: {MESSAGE}’
\n“`<\/p>\n
\n|———|———|———–|——|
\n| Timer System | \u2705 | \u2705 | \u2705 |
\n| Instant Reset | \u2705 | \u2705 | \u2705 |
\n| Team System | \u2705 | \u2705 | \u274c |
\n| Tracking Compass | \u2705 (Hunters only) | \u2705 (All teams) | \u274c |
\n| Chunk Items Challenge | \u2705 | \u2705 | \u2705 |
\n| Friendly Fire Challenge | \u2705 | \u2705 | \u274c |
\n| Multiple Teams | \u274c (2 teams) | \u2705 (2-10 teams) | \u274c |
\n| Can Run Simultaneously | \u274c | \u274c | \u2705 |<\/p>\n
\n– **Reset Time**: 10-30 seconds typical
\n– **World Deletion**: Async (non-blocking)
\n– **World Creation**: Sync (main thread, optimized)
\n– **Timer Updates**: Every second (20 ticks)
\n– **Compass Updates**: Every second (20 ticks)<\/p>\n
\n1. Download `ChallengeUtil.jar`
\n2. Place in your server’s `plugins` folder
\n3. Configure `server.properties`:
\n “`properties
\n level-name=waiting_room
\n “`
\n4. Restart your server
\n5. Configure `plugins\/ChallengeUtil\/config.yml`
\n6. Reload or restart<\/p>\n
\n1. Install PlaceholderAPI from SpigotMC
\n2. Restart server
\n3. Placeholders automatically register
\n4. Use in chat plugins (EssentialsX, ChatControl, etc.)<\/p>\n
\n1. Server starts with players in waiting room
\n2. Admin: `\/settings` – Configure challenge settings
\n3. Players: `\/join` – Enter speedrun world
\n4. Admin: `\/start` – Begin timer
\n5. Players: Complete speedrun
\n6. Admin: `\/fullreset` – Instant 3-5 second reset for next run<\/p>\n
\n1. Enable Manhunt mode in `\/settings > Challenges`
\n2. Players join teams:
\n – `\/team runner` (speedrunners)
\n – `\/team hunter` (hunters)
\n3. Admin: `\/start`
\n4. Runners get 10-minute head start
\n5. Hunters spawn and receive tracking compass
\n6. First team to defeat Ender Dragon wins<\/p>\n
\n1. Enable Team Race in `\/settings > Challenges`
\n2. Players: `\/team` to see available teams
\n3. Players join teams: `\/team Rot`, `\/team Blau`, etc.
\n4. Admin: `\/start`
\n5. All teams receive tracking compasses
\n6. Race to defeat the Ender Dragon
\n7. First team wins!<\/p>\n
\n– Verify `level-name=waiting_room` in server.properties
\n– Ensure waiting room world folder exists<\/p>\n
\n– Use Paper instead of Spigot
\n– Use SSD instead of HDD
\n– Reduce world size\/pregenerate less
\n– Check server TPS<\/p>\n
\n– Increase `speedrun-spawn.y` to 120+ in config.yml
\n– Plugin auto-finds surface, but high Y helps<\/p>\n
\n– Set `random-seed: false` in config.yml<\/p>\n
\n– Ensure players are in the same dimension
\n– Check that target players are online
\n– Verify team assignments with `\/team`<\/p>\n
\n– Install PlaceholderAPI
\n– Check if expansion is registered: `\/papi list`
\n– Reload PlaceholderAPI: `\/papi reload`
\n– Verify chat plugin configuration<\/p>\n
\n– **Challenge Servers**: Unique gameplay mechanics
\n– **Manhunt Servers**: Classic hunter vs speedrunner
\n– **Team Competition**: Multi-team races
\n– **Practice Servers**: Quick reset for skill improvement
\n– **Content Creation**: Streamers and YouTubers
\n– **Proxy Networks**: Multiple parallel speedrun instances<\/p>\n
\n**
\n**Instant Resets** – 10-30 seconds, no server restart
\n**Unique Challenges** – Chunk Items, Friendly Fire
\n**Proxy Optimized** – Perfect for networks
\n**Highly Configurable** – Customize everything
\n**PlaceholderAPI** – Full integration
\n**Performance Focused** – Optimized and tested
\n**User-Friendly** – GUI-based configuration
\n**Active Development** – Regular updates <\/p>\n