Skip to content

FurryMileon/dreams-speedrunner-swap

 
 

Repository files navigation

🌀 Speedrunner Swap + Task Master 🌀

Three 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, or the brand-new mind-bending Task Master mode where deception and strategy reign supreme.


🎬 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!

🎲 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
🎭 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

✨ 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
🛡️ 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
/swap setrunners <players…> · /swap sethunters <players…> · /swap clearteams Quick team assignment helpers (mirrors the GUI team selector).
/swap interval <seconds> · `/swap randomize <on off>`
/swap tasks list Prints all registered Task Master objectives with their enabled state and difficulty.
`/swap tasks enable disable `
`/swap tasks difficulty <easy medium
/swap tasks reroll Assigns fresh secret tasks to the currently selected runners (only before the round starts).
`/swap tasks endwhenoneleft <on off
/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 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 is 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, 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 guiTask Master.
  2. Custom Tasks lets you add new objectives (ID + description) and remove existing ones.
  3. 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 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.

🙌 Credits & Support

Inspired by Dream, Sapnap & GeorgeNotFound's legendary videos

Developed by muj3b

Donate


🎉 Experience Dream's Challenges Today! 🎉

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

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

About

Speedrunner Swap lets multiple Minecraft speedrunners share inventory, health, and position, swapping control at set or random intervals while hunters track and try to stop them. Includes a simple GUI, safe swaps, hunter compass, and works on 1.21+. Inspired by Dream, made for teamwork and challenge.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages

  • Java 99.9%
  • Other 0.1%