Dreams Speedrunner Swap + Task Master

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.

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 v1.6 — Changelog

---

Bug Fixes

- 209 bugs fixed for improved stability and performance. ---

New Features

1. Hunter Swapping Hunters now swap control at configurable intervals, adding unpredictability. 2. Swap Power-Ups Newly-swapped active runner receives a random positive or negative potion effect for a short duration. 3. "Last Stand" Mode The final remaining runner gets a temporary strength and speed boost for a fighting chance. 4. Custom Kits Define custom starting kits for both runners and hunters in the configuration file. 5. "Hot Potato" Swap Mode Swap is triggered by the active runner taking damage, not by a timer. 6. Advanced Stats End-game summary displays stats like time as active runner and kills as hunter. 7. Shrinking World Border The world border shrinks over time, forcing players closer for an action-packed endgame. 8. Bounty System At game start, a random runner becomes the "bounty." The hunter who eliminates them gets a special reward. 9. Sudden Death Mode If the game lasts too long, all players are teleported to the End for a final battle. 10. Compass Jamming After a swap, hunters' compasses are jammed and point in random directions for a short period, giving runners a chance to escape. --- This update supports Markdown formatting.

Optimized everything to reduce the load on your server and added more options to the GUI for greater customizability.

The GUI interface is now fully functional with numerous bug fixes and enhanced features for greater customizability!

- GUI Functionality : Verified and fixed layout, menu interactions, and item displays. - Swap Mechanics : Verified and fixed countdown and proper execution of swaps. - Runner Selection : Implemented and verified the runner selection system, preventing players from setting themselves as the only runner and ensuring proper game start conditions. - Role Conflict : Prevented a single player from being both a speedrunner and a hunter simultaneously. - Hunter Compass Functionality : Fixed inconsistent compass spawning, ensured correct behavior when the speedrunner enters a portal, and updated the target immediately on swap. This also included removing the exact XYZ coordinate display from the hunter's view. - Game End Conditions : Implemented and verified game end conditions, fixing premature game end and ensuring proper teleportation blocking by teleporting all players to a safe spawn point and resetting their states. - Audit Bugs : Audited and fixed bugs and loopholes in the core game mechanics, specifically refining the game start conditions to ensure valid player configurations. - Start Text : Implemented clear text at the start of the game to explain rules and status.

GUI Command Fix*: The /swap gui command, which was previously not working, has been fixed to correctly display the main menu. Runner Selection Logic Improvement*: The system for selecting runners has been improved to prevent players from setting themselves as the only runner and to ensure that games start under valid conditions. Hunter Compass Functionality*: The hunter compass now works as intended. It will be given to all hunters, won't be lost if dropped, will reappear upon respawn, and will update correctly when players enter portals or during swaps. Game End Conditions Fixes*: The game will no longer end prematurely if there are still runners alive, and players will be prevented from teleporting after the game has concluded. Hunter Interface Update*: The display of exact XYZ coordinates has been removed from the hunter's interface. Player in Game Check*: An issue with checking if a player was in the game has been resolved. Player Disconnect Handling*: The way the plugin handles player disconnections has been significantly improved: * When a player leaves the game, their current state (inventory, health, etc.) is now saved if they were actively participating. * If the disconnected player was the active runner, the game will either pause (if configured to do so) or continue, with the runner being removed and an immediate swap triggered if other runners are present. * If a non-active runner disconnects, they are simply removed, and the game continues without interruption. Internal Method Visibility*: An internal change was made to allow the game's event listener to properly save player states when players disconnect.

SpeedrunnerSwap Plugin Update 1.1

New Features

- Win Conditions: Runners win by defeating the Ender Dragon; hunters win by eliminating all runners. - Cross-Dimension Tracking: Compass now handles Nether/Overworld scaling and points to spawn for End dimension. - Particle Trails: Configurable particle effects trail the active runner, visible to hunters in the same world. - Freeze Mechanic: Active runner can freeze nearby hunters by looking at them, applying slowness and jump prevention effects.

Bug Fixes

- Fixed compilation errors for Minecraft 1.21 compatibility (imports, enum values, type conversions). - Optimized performance by adjusting task intervals and limiting updates to game participants.

Initial Release of the Speedrunner Swap Plugin