All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Dreams Speedrunner Swap + Task Master

Dreams Speedrunner Swap + Task Master

by muj4b • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

🌀 Speedrunner Swap + Task Master 🌀

Five Epic Game Modes in One Plugin

Minecraft API Game Modes Task Master Tasks

Experience Dream's legendary challenges in one powerful plugin! Play the classic Speedrunners vs Hunters, the cooperative Multi-Runner Control Swap, the shared-body Task Master sabotage mode, the new Task Master Duo two-body sabotage variant, or the no-swap Task Race mode where everyone plays at once. Dream mode can also run with a second shared hunter body for team-vs-team body swapping.


🎬 Inspired by Dream's Original Videos

🏹 Speedrunners vs Hunters 🎛️ Multi-Runner Control 🎯 Task Master (NEW!)

🎯 NEW: Task Master Mode (BETA)

The Ultimate Mind Game - As Seen in Dream's Latest Video!

One body. Multiple players. Secret tasks. Pure chaos.

In Task Master mode, players take turns controlling a single character while racing to complete their secret objectives. Every minute, control swaps to the next player. Will you help others to hide your true goal? Will you sabotage their progress? The choice is yours, but only the first to complete their task wins!

🏁 NEW: Task Race Mode

Task Race uses the same secret task pool, but removes the shared-body swap loop entirely. Two or more runners can play at the same time on their own characters, and the first player to finish their task wins instantly.

⚔️ NEW: Task Master Duo

Task Master Duo keeps the shared-body chaos, but splits the round into two active bodies instead of one. One group shares body A, another group shares body B, and both bodies rotate on the same interval while trying to finish their secret tasks first. That means you still get the sabotage, deception, and swap pressure from classic Task Master, but now another shared body is in the world interfering with you at the same time.

🏹 NEW: Shared Hunter Body Option

Dream mode can now optionally give hunters their own shared body too. That means one runner body and one hunter body can exist at the same time, each rotating between the players assigned to that side. If you want classic manhunt, leave it off. If you want Dream/George sharing the runner and Sapnap/Bad sharing the hunter, enable it from the swap settings GUI or config.yml.

🎲 100+ Unique Tasks Included!

Click to see all task categories (100+ tasks!)

🔥 Special Multi-Step Tasks (Like Dream's Video)

  • Fall from surface to bedrock and die from fall damage
  • Kill an iron golem in the Nether with a bed explosion
  • Kill one of every colored sheep with an iron shovel
  • Sleep in a Nether fortress bed
  • Die holding exactly 10 diamonds
  • Get a full stack of rotten flesh
  • Kill a mob by dropping an anvil on it
  • Take 100 damage without dying
  • Name 5 different mobs
  • Collect all 9 wood types

⛏️ Underground & Mining Challenges

  • Mine 1000 blocks total
  • Find 12 diamonds
  • Create 100-block strip mine at Y=11
  • Die in lava below Y=5
  • Place torch on bedrock
  • Fill chest with all ore types
  • Explode 50 TNT
  • Dig through bedrock to void
  • Build 3x3x3 obsidian room
  • Find and break mob spawner

⚔️ Combat & Mob Challenges

  • Kill 50 hostile mobs
  • Kill 10 zombies with golden sword
  • Kill 5 creepers without explosions
  • Get killed by baby zombie
  • Kill skeleton with its own arrow
  • Survive 5 creeper explosions
  • Kill enderman with water
  • Tame wolf and have it kill 10 sheep
  • Kill witch with splash potions
  • Find and kill spider jockey

🔥 Nether Challenges

  • Bridge across lava lake
  • Collect 16 glowstone dust
  • Kill ghast by reflecting fireball
  • Loot Nether fortress chest
  • Collect 10 magma cream
  • Trade 16 gold with piglins
  • Kill 20 piglins
  • Ride strider across lava ocean
  • Brew fire resistance potion
  • Get killed by wither skeleton

🏗️ Crafting & Building

  • Craft full diamond armor set
  • Build 50-block high tower
  • Build automatic redstone farm
  • Craft and place 10 paintings
  • Build 2 nether portals in overworld
  • Enchanting table with 15 bookshelves
  • Create 5 infinite water sources
  • Build house with 5 rooms
  • Craft 100 items total
  • Create 3x3 map wall

🌾 Food & Farming

  • Breed 20 animals
  • Cook 64 pieces of meat
  • Harvest 100 wheat
  • Create bee farm with 3 hives
  • Tame 10 wolves
  • Collect every flower type
  • Craft and place cake
  • Eat 25 different foods
  • Get poisoned 5 times
  • Achieve max saturation with golden carrots

🚂 Transportation Challenges

  • Travel 1000 blocks from spawn
  • Ride minecart 500 blocks
  • Fly 1000 blocks with elytra
  • Cross ocean by boat
  • Ride pig 100 blocks
  • Build 50-block ice road
  • Jump 5 blocks high on horse
  • Swim 500 blocks
  • Create 30-block bubble elevator
  • Travel 100 blocks with ender pearls

📦 Collection Challenges

  • Collect 64 bones
  • Collect 32 ender pearls
  • Find a music disc
  • Reach level 30 experience
  • Fill entire inventory with unique items
  • Collect 64 string
  • Collect 32 gunpowder
  • Collect every dye color
  • Find 2 saddles
  • Find Totem of Undying

💎 Trading & Villager Challenges

  • Trade with 5 different villagers
  • Max out a villager's trade
  • Cure zombie villager
  • Build and spawn iron golem
  • Defeat a raid
  • Collect 64 emeralds
  • Build villager breeder
  • Transport villager 500 blocks
  • Get Hero of the Village
  • Trade for enchanted book

🎪 Unique & Special Challenges

  • Sleep in bed 10 times
  • Die 5 different ways
  • Watch sunset from Y=100
  • Create 10 snow golems
  • Throw diamond in lava
  • Drown with Respiration III
  • Kill yourself with own TNT
  • Travel 10000 blocks one direction
  • Take 50 hearts damage without dying
  • Place 1000 blocks

✨ Task Master Features

Feature Description
🎲 100+ Pre-Built Tasks Extensive task library inspired by Dream's challenges
➕ Custom Task Creator Add your own tasks via GUI or config file
🕵️ Secret Objectives Tasks hidden from other players to maintain mystery
📊 Task Balancing All tasks designed for similar completion times
🎚 Difficulty Buckets Pick Easy, Medium, or Hard pools for assignments
↩️ First-Turn Rerolls Players can spend a configurable reroll before start or during their opening turn
🎭 Strategic Deception Hide your true objective while sabotaging others
🏆 Instant Victory First to complete their task wins immediately

🎮 All Game Modes

🏹 Speedrunners vs Hunters

The classic chase. Speedrunners must defeat the Ender Dragon while being hunted. Control swaps between runners at intervals.

  • 🔄 Periodic control swaps
  • 🧭 Compass tracking
  • ⚔️ Intense PvP
  • 🎯 Goal: Defeat Ender Dragon

🎛️ Multi-Runner Control

Pure cooperation. Multiple players share control of one character in a queue system to beat the game together.

  • 🔄 Queue-based swaps
  • 🤝 Shared body & inventory
  • 👥 No PvP, pure co-op
  • 🎯 Goal: Beat the game as one

🎯 Task Master (BETA)

Strategic competition. Complete your secret task while sharing control and preventing others from completing theirs.

  • 🎲 100+ included tasks
  • ➕ Custom task support
  • 🕵️ Hidden objectives
  • 🎯 Goal: Complete your task first

🏁 Task Race

Parallel competition. Every runner keeps their own body, inventory, and progress while racing to finish a hidden task first.

  • 👥 2+ runners at once
  • 🚫 No periodic swaps
  • 🕵️ Hidden objectives
  • 🎯 Goal: Finish before everyone else

✨ Universal Features

Feature Description
🖥️ Full GUI Control Manage teams, settings, task pools, spawn, and cosmetics without touching files
🔄 Customizable Swaps Set intervals, randomization, grace periods, and jitter
🏹 Shared Hunter Body Optional Dream-mode hunter queue so runners and hunters can each share a separate body
🛡️ Safe Swap System Prevents swapping into dangerous situations
🎤 Voice Chat Integration Auto-mute inactive players via Simple Voice Chat support
📚 Task Pool Manager Enable/disable every objective, adjust difficulty filters, and reload tasks.yml live

🚀 Quick Start

Step Action Details
1 📥 Download Get SpeedrunnerSwap-*.jar from releases
2 📁 Install Place in server's plugins/ directory
3 🔄 Restart Start server to generate configs
4 ⚙️ Configure Run /swap gui → Mode Selector (shift-click a mode to save it as the server default)
5 🎮 Play! Use /swap gui to start!

📝 Commands

Command Description
/swap gui Opens the full management hub (mode selector, team setup, settings, task pool, stats, kits, etc.).
/swap start · /swap stop · /swap pause · /swap resume · /swap status Runtime controls for starting, stopping, pausing and inspecting the current match.
/swap mode <dream|sapnap|task|taskrace> Switches the active gameplay mode. Automatically blocks switching mid-match unless --force is provided.
/swap setrunners <players…> · /swap sethunters <players…> · /swap clearteams Quick team assignment helpers (mirrors the GUI team selector).
/swap interval <seconds> · /swap randomize <on|off> Fast tweaks for the base swap interval and randomisation without opening the menu.
/swap tasks list Prints all registered Task Master objectives with their enabled state and difficulty.
/swap tasks enable|disable <id> Toggle individual tasks from chat (same functionality is available in the GUI Task Pool).
/swap tasks difficulty <easy|medium|hard> Chooses the Task Master difficulty filter.
/swap tasks reroll Assigns fresh secret tasks to the currently selected runners (only before the round starts).
/swap tasks endwhenoneleft <on|off|toggle> Controls the “end when one runner remains” rule.
/swap tasks reload Reloads tasks.yml without restarting the server.
/swap complete [confirm] Shows your current secret task or, with confirm, manually completes it (and ends the game).
/swap complete reroll confirm Spends your configurable one-time task reroll when the current round rules allow it.
/swap creator · /swap help Plugin credits and in-game help.

Permissions:

  • speedrunnerswap.command lets trusted players open the GUI, start/stop rounds, and manage teams.
  • speedrunnerswap.admin is required for mode changes, interval/randomize tweaks, task management, reloads, and /swap clearteams.
  • /swap complete and /swap complete reroll confirm are available to runners who have been assigned a Task Master objective.

⚙️ Configuration & GUI Coverage

The plugin ships with a comprehensive config.yml, but every option can be adjusted from the in-game GUI. Here’s how the configuration maps to the menu structure:

GUI Section Key Config Areas Highlights
⚙️ Swap & Timing swap.* Interval, randomisation, experimental limits, jitter, grace period, hunter swap, hot potato, preserve runner progress.
🛡️ Safety & Freeze safe_swap.*, freeze_mode, freeze_mechanic.*, cancel.*, single_player_sleep, spawn.*, limbo.* Safe-swap radii, freeze mechanics, spawn handling, limbo/spawn location setters.
🎯 Hunter Tools tracker.* Compass enable/disable, update ticks, portal retry attempts/delay, compass jamming duration & distance.
🧪 Power-ups power_ups.* Toggle system, choose positive/negative effects, duration & level ranges.
🌍 World Border world_border.* Enable shrink, starting/ending size, shrink duration, warning distance/interval.
🏹 Bounty System bounty.* Master toggle, cooldown, glow length, reward durations, manual assign/clear.
🛡 Last Stand & Sudden Death last_stand.*, sudden_death.* Configure runner clutch buffs and sudden-death arena, timers, and effects.
📊 Statistics & UI stats.*, ui.update_ticks.*, timer_visibility.* Enable tracking, broadcast cadence, timer visibility, action bar/title update rates.
✨ Particle Trail particle_trail.* Toggle runner particle trail, tick interval, particle id, and RGB colour (new GUI controls).
🎙 Voice Chat voice_chat.* Simple Voice Chat integration toggles.
🎒 Kits kits.* & kits.yml Enable runner/hunter kits and quick testing buttons.
🎯 Task Master task_manager.* Pause behaviour, reconnection grace, max duration, include defaults, difficulty filter, player reroll rules, per-task enable/disable, custom task creator, task pool management, assignments viewer.

📝 Tip: Use /swap gui (or the /swap hotkey in the tab completions) to reach any of these menus instantly—every slider, toggle, and button writes back to config.yml (or tasks.yml / kits.yml) for persistence.


🎨 Creating & Managing Custom Tasks

GUI Workflow

  1. Open /swap gui → Task Master.
  2. Task Settings now exposes the round difficulty plus player-reroll rules.
  3. Custom Tasks lets you add new objectives (ID + description) and remove existing ones.
  4. Task Pool provides page-based toggles to enable/disable any built-in or custom task, adjust the difficulty filter, and reload tasks.yml live.

Command Workflow

  • /swap tasks list – review all definitions.
  • /swap tasks enable|disable <id> – quick toggles from console or chat.
  • /swap tasks difficulty <easy|medium|hard> – change the pool filter.
  • /swap tasks reroll – reassign secret tasks prior to a round.
  • /swap complete reroll confirm – let a player spend their opening-round reroll.
  • /swap tasks reload – re-read tasks.yml after editing.

Design Tips

  • Aim for goals that take 10–30 minutes so races stay competitive.
  • Use exact numbers (e.g. collect 32 ender pearls) to avoid ambiguity.
  • Mix tasks that encourage sabotage with those that reward cooperation.
  • Keep descriptions concise, the GUI shows the entire text to players.

🌟 Community Creator Showcase

🎥 Videos Made With Speedrunner Swap + Task Master

A huge thank you to every creator who has featured, played, or made a video using the plugin! ❤️ Check out their videos below and show them some support!

Creator Video Creator Video
▶️ Watch on YouTube ▶️ Watch on YouTube
Creator Video Creator Video
▶️ Watch on YouTube ▶️ Watch on YouTube
Creator Video Creator Video
▶️ Watch on YouTube ▶️ Watch on YouTube
Creator Video Creator Video
▶️ Watch on YouTube ▶️ Watch on YouTube
Creator Video Creator Video
▶️ Watch on YouTube ▶️ Watch on YouTube
Creator Video Creator Video
▶️ Watch on YouTube ▶️ Watch on YouTube

📺 Featured on Bilibili

▶️ Watch on Bilibili

🎬 Made a video using the plugin? Share it in the Discord, you might be featured here!


🙌 Credits & Support

Inspired by Dream, Sapnap & GeorgeNotFound's legendary videos

Developed by muj3b


🎉 Experience Dream's Challenges Today! 🎉

100+ tasks included • Custom task support • Four game modes • Endless possibilities

Task Master mode is in BETA - Report issues and suggest new tasks on our Discord!

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.3 26.2 26.1.x +1
Bukkit Paper Purpur Spigot
14h ago 1
1.21.11
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.x
Bukkit Paper Purpur Spigot
14h ago 1
1.21.8
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
1.21.x
Paper
14h ago 1
Added support for 26+ versions, yet to be tested:

Bug fixes:

  • Preserved independent hunter groups and existing configuration.
  • Improved world lookup while retaining legacy world-name support.
  • Fixed menu, title, and action-bar colors.
  • Updated potion registry handling.
  • Added namespaced kit materials and safer handling of invalid items, armor, and unavailable task materials.
## 4.3.6 - Independent Hunter Groups

### Added
  • Multiple shared hunter bodies against one permanent speedrunner.
  • Separate player queues, inventories, locations, health, effects, and timers for each hunter group.
  • Hunter-group setup menus and /swap huntergroups commands.
  • Saved group assignments and configurable per-group swap intervals.

### Fixed
  • Single-runner games incorrectly pausing during swaps.
  • Disconnect/rejoin and death/respawn handoff issues.
  • Cancelled teleports, inventory-copying risks, and waiting-player restrictions.
  • Round cleanup restoring original respawn points and potion effects.
  • Timer cleanup when stopping, restarting, or disabling the plugin.

Code level tests done, Minecraft testing pending
## 4.3.5

  • Added config options for vanilla death messages during active games.
  • Added config options for vanilla advancement messages during active games.
  • Added both options to the Broadcast Settings GUI.
  • Server owners can now choose whether advancements like [Stone Age] and normal death messages show while a Speedrunner Swap game is running.
  • Existing behavior is preserved by default: death messages and advancement messages stay hidden during games unless disabled in config or GUI.

### What server owners should know

  • To show death messages during games, set broadcasts.suppress_death_messages_during_games: false.
  • To show advancement messages during games, set broadcasts.suppress_advancements_during_games: false.
  • These can also be changed in /swap gui → Settings → Broadcast Settings.
## 4.3.4

  • Fixed Task Master / Task Race runtime assignments so old saved task data can no longer pull unrelated joiners into a live round.
  • Fixed late join behavior so players are only added mid-round when late joiners are enabled and they join the active game world.
  • Fixed rerolled task win announcements so they use the player’s current rerolled task instead of the original task.
  • Added editable tasks.yml support for the Task Master task pool.
  • Default objectives are now seeded into tasks.yml on first startup so server owners can remove, disable, or retune tasks without editing code.
  • Custom tasks created from the GUI now save into tasks.yml.
  • Fixed difficulty filtering so it no longer silently falls back to every enabled task when the selected difficulty has no eligible tasks.
  • Added difficulty/category metadata for default tasks so Easy / Medium / Hard filtering works properly.
  • Updated GUI and /swap tasks commands to show eligible task counts.
  • Blocked task pool changes, reloads, and difficulty changes during live rounds to avoid breaking active assignments.
  • Fixed /swap tasks reroll so Task Master Duo rerolls both shared-body groups instead of only the runner body.

### What server owners should know

  • After updating, check plugins/SpeedrunnerSwap/tasks.yml.
  • To remove a task, delete it from tasks.yml or set enabled: false.
  • To change what difficulty pool a task appears in, edit its difficulty value.
  • Use /swap tasks reload or the Task Pool GUI reload button after editing tasks.yml.
  • Stop the current round before changing task pool settings.

## 4.3.3
### Added
  • Added Task Master Duo, a new task mode with 2 shared bodies active in the same round.
  • Added GUI support for selecting Task Master Duo from the mode selector and task hub.
  • Added config/interval support for Task Master Duo through swap.default_intervals.task_duel.
  • Added command support for /swap mode taskduel.

### Fixed
  • Task competitions now end with proper task-winner handling instead of using runner-vs-hunter win titles for task modes.
  • Inactive players in the second shared body now follow the same chat, movement, inventory, and damage restrictions as inactive runners.
  • Dream-only tracker compass behavior now stays scoped to Dream mode, so Task Master Duo players are not treated like tracker hunters.
  • Voice chat muting now correctly handles the second shared body in Task Master Duo.

### What server owners need to know
  • Task Master Duo uses runners as body A and hunters as body B.
  • Both shared bodies use the normal swap interval system.
  • You can switch to it with /swap mode taskduel or from the GUI.

## 4.3.2
### Added
  • Dream mode can now use a shared hunter body.
  • Hunters can rotate through one shared hunter body while runners keep using the shared runner body.
  • Added GUI + config support for:
  • enabling/disabling shared hunter control
  • setting the shared hunter swap interval

### Fixed
  • Tracking compasses now stay on the active hunter only when shared hunter control is enabled.
  • Rejoining, respawning, or changing worlds no longer gives tracking compasses to inactive hunters.
  • Inactive hunters now properly follow the same freeze/cage restrictions as inactive runners.
  • Voice chat muting now correctly respects both the runner side and hunter side in shared-body setups.

### What server owners need to know
  • This only affects Dream mode.
  • If you want the new setup, enable swap.shared_hunter_control.enabled in the config or turn it on in the GUI.
  • If shared hunter control is enabled, the old legacy hunter shuffle should be left off unless you specifically want the old behavior instead.

## 4.3.1
### Added
  • Task difficulty can now be chosen more clearly before starting from the GUI.
  • Players can now reroll their own task when rerolls are enabled for the round.
  • Added GUI/config/command support for player task rerolls.

### Fixed
  • Task Master no longer affects players outside the game on multiverse setups.
  • Start/end cleanup is now limited to actual participants instead of touching unrelated players.
  • Rejoining players in Task Master no longer get stuck in the bedrock box.
  • task_manager.max_game_duration now actually ends the round when the timer is reached.
  • Pause-on-disconnect now properly waits for missing task-mode players instead of resuming too early.
  • Task Race respawns no longer leak shared spawn behavior across different players.
  • Late-join task assignment no longer wipes existing player assignments.

### What server owners need to know
  • If you use Multiverse, this update is important.
  • If you want timed task rounds, task_manager.max_game_duration now works properly.
  • If you want players to reroll tasks, configure the reroll settings in the task manager section or use the GUI.
## 4.3
  • Added a brand-new Task Race mode for 2+ simultaneous runners:
  • Runners keep their own bodies, inventories, and world state instead of sharing one swapped character.
  • The round now supports secret-task racing without periodic swaps or inactive-runner lockouts.
  • Existing swap-based Task Master mode remains available unchanged for sabotage-style shared-body play.
  • Updated task competition support across the plugin:
  • Task detection and /swap complete now work in both task competition modes.
  • Task disconnect handling, late joiner support, and end_when_one_left logic now cover both task variants.
  • Voice chat muting and inactive-runner restrictions no longer incorrectly affect the no-swap mode.
  • Improved the GUI and commands for production use:
  • Added Task Race to the mode selector and task hub.
  • The Task hub now makes you explicitly choose between swap-based Task Master and no-swap Task Race.
  • Main control screens now avoid offering misleading swap-only controls while Task Race is active.
  • Added /swap mode taskrace aliases and updated status/help output accordingly.
  • Docs and release polish:
  • README and config comments now document the fourth gameplay mode.
## SpeedrunnerSwap 4.1

Added **full multiworld / Multiverse compatibility** support.

### Changes
  • Runner respawns now stay tied to the active game session world instead of falling back to the server’s default world.
  • Added post-respawn enforcement to handle plugins like Multiverse setups that apply a second teleport after respawn.
  • Added a new **Multiworld** settings section in the GUI.
  • Added same-world player filtering in team selection menus.
  • Added session-world assignment restrictions so players from the wrong world can’t be assigned by mistake.
  • Added session-world status info to the main GUI and /swap status.
  • /swap setrunners and /swap sethunters now respect multiworld restrictions and explain skipped players.
  • Added soft dependency support for Multiverse-Core and Multiverse-Inventories.

### How to use
1. Open /swap gui
2. Go to Settings
3. Open Multiworld
4. Configure:
  • Multiworld Compatibility
  • Session-World Respawns
  • Post-Respawn Enforcement
  • Same-World Team Selector
  • Restrict Assignments
  • Update Session World

### Recommended setup
  • Leave **Multiworld Compatibility** enabled
  • Leave **Session-World Respawns** enabled
  • Leave **Post-Respawn Enforcement** enabled
  • Leave **Restrict Assignments** enabled
  • Use **Same-World Team Selector** if you want team setup to only show players in your current world

  • Fixed reconnect reliability in live games (1.21+)**
  • Team membership checks are now UUID-safe, preventing stale player references after disconnect/rejoin.
  • Rejoined players are re-synchronized into runner/hunter lists based on config assignments.
  • Auto-resume now only triggers when the game was paused due to disconnects and all required teams are online.
  • Queue coherence now rebinds the active runner to the current online player instance.
## SpeedrunnerSwap v4.0.7

### Added

  • New configurable end-game messaging system**
  • messages.end_game.runner.*
  • messages.end_game.hunter.*
  • messages.end_game.none.*
  • messages.end_game.broadcast

New GUI section:
  • Settings -> End Game Messages

You can edit titles, subtitles, and broadcast text directly in-game.

  • Broadcast placeholders**
  • %winner%
  • %winner_team%

  • New End cage safety options**
  • freeze_mechanic.cage.avoid_cage_in_end
  • freeze_mechanic.cage.end_min_distance_from_origin
  • freeze_mechanic.cage.end_safe_coordinate
  • freeze_mechanic.cage.end_min_distance_from_dragon

### Changed

End cage handling now avoids dragon-fight interference by placing cages far from active dragon space (default 500-block safety behavior).

Default avoid_cage_in_end is false (keeps normal End gameplay flow while still applying safety placement).

  • Fixed respawning in the nether glitch
### Voice Chat Integration
  • Fixed inactive runners being unable to hear each other when using Simple Voice Chat.
  • The plugin now respects SVC’s proximity chat by keeping players visible when Voice Chat Integration is enabled.
  • Properly wired up voice chat mute status updates during swaps and at game end.

### Spawn Location Defaults
  • Fixed players teleporting to 0, 64, 0 when spawn location wasn’t manually configured.
  • Spawn and limbo locations now default to the world spawn point instead of coordinates 0, 0, 0.
  • CAGE mode now creates the bedrock cage near world spawn instead of at origin.

### Notes
  • If you previously set spawn/limbo locations manually, your settings are preserved.
  • For the voice chat fix to work, enable “Voice Chat Integration” in /swap GUI → Settings.
  • Fixed a critial bug in ChatInputHandler.java the Paper chat handler was missing a check. Which is now fixed.

Now the Restrict Inactive Chat will work properly.
New config addition and GUI:
chat:
restrict_inactive_runners: true

You can change whether or not you can type in chat or not now!
  • Fixed multiple bugs and stability issues.
  • Updated to the latest Minecraft 1.21.x APIs.
  • Resolved compatibility problems across Purpur, Bukkit, Spigot, and Paper.
  • Preliminary build: not fully verified on all servers. Please report results in the Discord.

#### Notes
  • If you encounter errors, include your server type, version, and logs in your report.
  • Compatibility targets: Paper/Purpur/Spigot/Bukkit for 1.21–1.21.8.
  • Fixed inventory bug


  • only tested on paper 1.21.8 may work on other versions or loaders
# Dreams Speedrunner Swap + Task Master v4.0.0

  • Highlights**
  • Portal-safe swaps: Hunters always chase the correct runner.
  • Tracker lifecycle overhaul: Automatic restarts, compass updates, and GUI sync.
  • Instant freeze system refresh: Runner states update with settings changes.
  • Hot-potato stability: Listener cleanup and improved reliability.

  • Gameplay & Mechanics**
  • Portal swaps deferred with retry caching and clear feedback.
  • Swaps blocked for runners in SPECTATOR mode during freeze.
  • Queue coherence maintained after joins/quits and swaps.
  • Freeze mode GUI actions instantly refresh mechanics.
  • Inactive runners instantly transition between EFFECTS, SPECTATOR, LIMBO, CAGE.

  • Tracking & Compass**
  • Tracker validates enablement and hunter presence, stops if hunters offline.
  • GUI toggles immediately start/stop tracking and refresh compasses.
  • No duplicate compasses—checks inventory, off-hand, ender chest.
  • Cached portal locations and auto-refresh keep hunters tracking the right runner.

  • Quality & Safety**
  • Swap debounce: Prevents overlapping swaps and cleans up retry state.
  • Configurable messaging/logs for deferred swaps.
  • Task Master works now!
  • GUI STILL DOES NOT WORK, PLEASE PLAY USING COMMANDS INSTEAD.
  • Should work with Purpur, Paper, Spigot, and Bukkit (not all were tested)
  • Dying bug fixed
### Changelog

  • Added Dreams New gamemode!
  • Fixed 37 bugs.
  • Currently untested—please submit any bugs in our discord server.
  • Performance Tweaks
  • Added new beta features, try them out in the GUI
Cleaned up files.
1. GUI Navigation: Fixed -5/+5 interval buttons in Sapnap GUI.
2. Commands: Added singular aliases (/swap setrunner, /swap sethunter).
3. Mystery Mode: Suppressed death messages and advancement notifications.
4. Sleep Mechanics: Active runner can sleep alone to skip night.
5. Configuration: Added single-player sleep toggles in both GUIs.
6. Defaults: Sapnap mode enables single-player sleep by default; Dreams mode disables it.
# SpeedrunnerSwap v3.0.2 - Bug Fixes

## 🐛 Bug Fixes

### Queue Display Fix
  • Fixed**: Queue position showing incorrect number (2) at game start
  • Issue**: Queue was counting all online runners including the active runner
  • Solution**: Modified queue calculation to exclude the active runner from count
  • Result**: Queue now shows correct position for waiting runners

### Hostile Mob Targeting Fix
  • Fixed**: Endermen and other hostile mobs not targeting new speedrunner after swaps
  • Issue**: Mobs would lose their target when players swapped, breaking combat flow
  • Solution**: Added automatic target transfer system during player swaps
  • Features**:
  • Transfers targeting from previous runner to new runner
  • Works with all hostile mobs (zombies, skeletons, spiders, etc.)
  • Special handling for Endermen targeting mechanics
  • Cross-dimensional support (Overworld, Nether, End)

## Technical Changes
  • Updated getQueuePosition() method to exclude active runner from count
  • Added updateHostileMobTargeting() method for mob target management
  • Integrated hostile mob targeting into the swap process
  • Maintained compatibility with Paper/Spigot API 1.21.8

## 📦 Installation
  • Download: speedrunnerswap-3.0.2.jar
  • Compatible with: Paper/Spigot 1.21.8+ (with fallbacks for older versions)
  • No configuration changes required
Optimized caging to lag less with servers.
# 🚀 SpeedrunnerSwap v3.0.0 Changelog

## 🔧 **Major Improvements and Fixes**

### 🏠 **Caging System Enhancements**
  • Suffocation Prevention**:
  • Fixed potential suffocation issue by teleporting players to a safe Y-level
  • Players now spawn slightly above the cage floor to prevent block suffocation
  • Added robust safety checks for player teleportation

### 💬 **Messaging and Visibility**
  • Queue Display Improvements**:
  • Moved "Queued" messages from chat spam to action bar
  • Queue position now displayed above health/hunger bar
  • Clean, non-intrusive queue information

### 🎬 **Title and Display System**
  • Enhanced Caged Player Titles**:
  • Large, aesthetic title for caged players
  • Shows time until next swap
  • Displays active runner's sneaking/sprinting status
  • Configurable visibility options

### 🐉 **Ender Dragon Management**
  • Health Persistence**:
  • Implemented DragonManager to prevent artificial health restoration
  • Dragon health now maintains consistency across swaps
  • Allows natural healing from End Crystals
  • Prevents unexpected health resets

### 🛡️ **PvP and Safety**
  • Cage PvP Protection**:
  • Complete damage immunity for caged players
  • Specific PvP cancellation in shared cages
  • Players in the same cage cannot damage each other
  • Invisible to each other for added safety

### 🌍 **Cross-Dimensional Support**
  • Improved Cage Mechanics**:
  • Works seamlessly across Overworld, Nether, and End
  • One shared cage per world dimension
  • Adaptive height calculation for different world types

### 🔒 **API Compatibility**
  • Version 1.21.8 Support**:
  • Updated for latest Paper/Spigot API
  • Added fallback mechanisms for older versions
  • Improved cross-version compatibility

### 🎮 **Game Mode Enhancements**
  • Freeze Mode Improvements**:
  • More robust CAGE mode implementation
  • Better handling of player states during swaps
  • Configurable freeze mechanics

## 🐛 **Bug Fixes**
  • Resolved chat spam issues
  • Fixed potential suffocation in cages
  • Improved dragon health management
  • Enhanced player state preservation during swaps

## 🚀 **Performance**
  • Optimized cage creation and enforcement
  • Efficient world and player state management
  • Minimal performance overhead

## 🔮 **Future-Proofing**
  • Modular design for easy future updates
  • Comprehensive error handling
  • Flexible configuration options


  • Upgrade Recommendations**:
  • Backup your existing configuration
  • Review and adjust cage and swap settings
  • Test thoroughly in different world environments

  • Known Compatibility**:
  • Minecraft: 1.21.8
  • Platforms: Paper, Spigot
  • Modes: Hunters vs Runners, Multi-Runner Control


🎉 **Enjoy the most stable and feature-rich SpeedrunnerSwap experience yet!** 🎉
Stability and improvements on code
Just optimized and fixed a couple of errors when swapping in different dimensions.
Plugin is now stable!

This is the most tested and stable update released. GUI, Swapping, and compass works perfectly now!

Try it out!
Removed temp files making it run smoother.
## Changelog

  • GUI:** Now stable and fully working.
  • Config:** Now working.
  • Bug Fixes:** 407 bugs were fixed in the process.


Enjoy!
Dreams Speedrunner Swap + Task Master Icon
Download Dreams Speedrunner Swap + Task Master
Select game version
Select platform