Relay Challenge

English： # Relay Challenge Relay Challenge turns a Minecraft survival world into a multiplayer relay adventure. Only one participant—the **Active Player**—can play normally at a time. All other participants become spectators and follow the action. When the configurable timer reaches zero, another player is randomly selected to take over. The relay continues until the Ender Dragon is defeated. ## Features - Randomly selects an Active Player - Automatically rotates players after a configurable duration - Supports hours, minutes, and seconds - Displays the remaining time using a Boss Bar - Allows administrators to pause, resume, stop, or force the next rotation - Places all inactive participants in Spectator Mode - Prevents spectators from travelling too far away from the Active Player - Supports cross-dimensional spectator following - Automatically handles players joining or disconnecting - Restores each participant's original game mode when the challenge ends - Optionally transfers the inventory, hotbar, armor, and offhand items to the next player - Preserves the challenge state across server restarts - Automatically pauses the relay when the Ender Dragon is defeated ## Death Counter Sidebar The sidebar displays every visible participant and their number of deaths during the current challenge. ```text Player1 (0) Player2 (1) Player3 (0) ``` - The Active Player is displayed in green - Backup players are displayed in gray - The Active Player always appears at the top - Death statistics reset when a new challenge begins - The sidebar updates automatically after every rotation Minecraft's sidebar can display a maximum of 15 entries, so only 15 participants can be shown at once. ## Ender Dragon Celebration When the Ender Dragon is defeated: - The automatic relay system is paused - The dragon slayer's name is announced in chat - A title and subtitle are shown to every player - Challenge completion sounds are played - Three waves of colorful fireworks are launched around the dragon slayer - The Boss Bar displays the completed state ## Installation 1. Download the datapack ZIP file. 2. Place it directly inside: ```text .minecraft/saves/<world>/datapacks ``` 3. Do not extract the ZIP. 4. Enter the world and run: ```mcfunction /reload ``` 5. Verify the installation with: ```mcfunction /function relay:help ``` ## Quick Start Add every online player to the challenge: ```mcfunction /function relay:player/join_all ``` Set each turn to 10 minutes: ```mcfunction /function relay:config/time {hours:0,minutes:10,seconds:0} ``` Set the maximum spectator distance to 64 blocks: ```mcfunction /function relay:config/distance {blocks:64} ``` Start the challenge: ```mcfunction /function relay:start ``` ## Administration Commands ```mcfunction /function relay:help /function relay:start /function relay:pause /function relay:resume /function relay:rotate /function relay:stop /function relay:status ``` ### Player Management Add yourself: ```mcfunction /function relay:player/join ``` Add a specific player: ```mcfunction /execute as <player> run function relay:player/join ``` Add every online player: ```mcfunction /function relay:player/join_all ``` Remove yourself: ```mcfunction /function relay:player/leave ``` Remove a specific player: ```mcfunction /execute as <player> run function relay:player/leave ``` Clear the participant list: ```mcfunction /function relay:player/leave_all ``` The participant list can only be changed while the challenge is stopped. ## Configuration ### Turn Duration ```mcfunction /function relay:config/time {hours:1,minutes:30,seconds:0} ``` Valid values: - Hours: `0–999` - Minutes: `0–59` - Seconds: `0–59` - The total duration cannot be zero ### Spectator Distance ```mcfunction /function relay:config/distance {blocks:64} ``` Valid range: `1–100000` blocks. ### Shared Inventory Shared Inventory Mode is disabled by default. Enable it with: ```mcfunction /function relay:config/inventory_on ``` Disable it with: ```mcfunction /function relay:config/inventory_off ``` When enabled, the outgoing player's inventory, hotbar, armor, and offhand item are transferred to the next Active Player. > **Warning:** Shared Inventory Mode overwrites the incoming player's existing items. Empty all participant inventories or create a world backup before enabling it. ## Compatibility - Minecraft: Java Edition 26.1 - Data Pack Format: 101.1 - Works in vanilla Minecraft - Compatible with Fabric - No resource pack is required - Multiplayer recommended - Operator permissions are required for administration commands ## Important Notes - Use `/function relay:stop` before removing or updating the datapack. - Back up your world before enabling Shared Inventory Mode. - Player deaths do not immediately trigger a rotation. - If the Active Player disconnects, another online participant is selected automatically. - If no participants are online, the timer is p