Speedrunner Swap
The Ultimate Challenge Plugin

Minecraft: 1.21.x+ | API: Paper/Spigot | Game Modes: 2 in 1 | Status: Ready to Play

Two epic game modes in one powerful plugin! Experience the classic high-stakes chase of Speedrunners vs Hunters or the innovative teamwork of Multi-Runner Control Swap. The ultimate challenge awaits.

───────────────────────────────

Inspired by the Originals

Speedrunners vs Hunters
Video:

️ Multi-Runner Control
Video:

───────────────────────────────

Game Modes Explained

Speedrunners vs Hunters Mode

• The classic high-adrenaline chase. A team of Speedrunners must beat the Ender Dragon while being relentlessly pursued by Hunters who can track their every move. At set intervals, control swaps between the Speedrunners, forcing constant communication and strategy.
  • Periodic Control Swaps among Runners
    
    
  • Compass Tracking for Hunters
    
    
  • ⚔️ Intense PvP & Elimination
    
    
  • Goal: Defeat the Ender Dragon

Multi-Runner Control Mode

• A true test of cooperation. A team of players shares control of a single character in a queue-based system. Work together to manage a shared inventory, health, and position to conquer the game. There are no hunters—only the challenge itself.
  • Queue-Based Swaps among all players
    
    
  • Shared Body & Inventory
    
    
  • Purely Cooperative (No PvP)
    
    
  • Goal: Defeat the Ender Dragon as one

───────────────────────────────

✨ Universal Features

• ️ Full GUI Control: Manage teams, game settings, and modes from a clean and intuitive interface.
  
  
• Customizable Swaps: Set fixed or random intervals, grace periods, and jitter to tailor the chaos.
  
  
• ️ Safe Swap System: Prevents players from swapping into lava, fire, or other deadly situations.
  
  
• Voice Chat Support: Automatically mutes inactive players in Discord to keep communications clear.

───────────────────────────────

Exclusive Hunter Mode Features

• Hunter Swapping: Allow Hunters to swap control among themselves too.
  
  
• Advanced Stats: Get detailed end-game statistics for every player.
  
  
• ✨ Swap Power-Ups: Grant random potion effects on each swap.
  
  
• Shrinking Border: Force the final confrontation with a world border.
  
  
• Last Stand Mode: The final Speedrunner gets a temporary boost.
  
  
• Bounty System: Place a special reward on a specific target.
  
  
• Custom Kits: Define starting equipment for both teams.
  
  
• ⚡ Sudden Death: Teleport all remaining players to the End for a final duel.
  
  
• Hot Potato Mode: Trigger a swap every time a Runner takes damage.
  
  
• Compass Jamming: Temporarily disable Hunter compasses.

───────────────────────────────

️ Exclusive Control Mode Features

• In-Game Queue HUD: The active player sees a countdown, while others see their position in the queue.
  
  
• Cross-World Cages: The robust cage system for inactive players works in all dimensions.
  
  
• ️ Multiple Freeze Modes: Choose how inactive players are handled: CAGE, SPECTATOR, LIMBO, or EFFECTS.
  
  
• ⚙️ Smart Timing Logic: The system automatically handles disconnects, grace periods, and more.

───────────────────────────────

️ Quick Start Guide

Step 1: Download
Get the latest SpeedrunnerSwap-*.jar from the releases page.

Step 2: Install
Place the JAR file in your server’s plugins/ directory.

Step 3: Restart
Start or restart your server to generate the configuration files.

Step 4: Configure
Open config.yml to choose your game_mode and customize settings.

Step 5: Play!
Use /swap gui to set up your teams and start the game!

───────────────────────────────

Commands

• /swap start — Starts the game after teams are set. (Works in both modes)
  
  
• /swap stop — Force-ends the current game. (Works in both modes)
  
  
• /swap gui — Opens the main management GUI. (Works in both modes)
  
  
• /swap status — Shows the current game status. (Works in both modes)
  
  
• /swap mode <hunters|control> — Switches the active game mode. (Both)
  
  
• /swap setrunners <players...> — Sets the Speedrunner team. (Both)
  
  
• /swap sethunters <players...> — Sets the Hunter team. (Hunters Mode only)
  
  
• /swap shuffle — Shuffles the player queue. (Control Mode only)
  
  
• Permissions: speedrunnerswap.admin (default: op)

Configuration Snippet (config.yml):

game_mode: "HUNTERS"
swap:
interval_seconds: 60
randomize: false
grace_period_ticks: 60
safe_swap:
enabled: true
hunters:
tracking_enabled: true
compass_updates: true
control:
freeze_mode: "CAGE"
───────────────────────────────

Ready for the Ultimate Challenge?
Two game modes, endless possibilities. Download now and choose your adventure!