Skip to content

Getting Started

Jump to bottom
Kingra007 edited this page Jun 14, 2026 · 2 revisions

Welcome to Handoff Relay.

Handoff Relay allows a Minecraft world to be passed between players while preserving progression, inventory, location, experience, timer state, and world continuity.

This guide covers installation, creating a handoff world, configuring participants, and transferring the world between players.

Requirements

Minecraft

  • Minecraft 1.21.11

Mod Loader

  • Fabric Loader

Dependencies

  • Fabric API

Installation

Singleplayer

  1. Install Fabric Loader.
  2. Install Fabric API.
  3. Copy the Handoff Relay .jar file into your Minecraft mods folder.
  4. Launch Minecraft using the Fabric profile.

Example:

.minecraft/mods/
├── fabric-api.jar
└── handoff-relay-1.0.0.jar

Dedicated Server

  1. Install a Fabric server.
  2. Install Fabric API.
  3. Copy Handoff Relay into the server mods folder.
  4. Start the server.

Example:

server/
├── mods/
│   ├── fabric-api.jar
│   └── handoff-relay-1.0.0.jar

Creating Your First Handoff World

Create a new world normally through Minecraft.

Join the world as the first player.

This player becomes the:

Handoff Creator

The creator is responsible for configuring the handoff session.

Configuring a Handoff Session

Set Turn Length

Example:

/handoff time 60

This gives each participant:

60 minutes

of play time.

Set Participant Count

Example:

/handoff players 10

Players will see:

You are Player 1 of 10.

The count automatically increases after successful handoffs.

Set a Spectator

Optional:

/handoff spectator EventObserver

The approved spectator account:

  • joins in spectator mode
  • does not consume a player slot
  • can observe the session

Example Setup

For a ten-player event:

/handoff time 60
/handoff players 10
/handoff spectator EventObserver

This creates:

  • 10 participants
  • 60 minute turns
  • 1 approved spectator

Playing a Handoff Session

Player 1

Player 1 joins.

The timer starts automatically.

Player 1 plays until:

00:00

Timer Expiry

When the timer expires:

  • player state is saved
  • inventory is saved
  • XP is saved
  • location is saved
  • world progression remains intact
  • the player is disconnected

Example:

Your handoff time is up.

Player 2

Player 2 receives the world.

Upon joining:

  • inventory is restored
  • XP is restored
  • health is restored
  • hunger is restored
  • potion effects are restored
  • location is restored
  • a fresh timer begins

Example:

Play for 60:00, have fun
You are Player 2 of 10.

World Transfer (Singleplayer)

After your turn:

  1. Exit Minecraft.
  2. Locate your save folder.

Example:

.minecraft/saves/
  1. Find the handoff world folder.
  2. Compress the world folder into a ZIP file.
  3. Send the ZIP to the next participant.

The next player:

  1. Extracts the ZIP into their saves folder.
  2. Launches Minecraft.
  3. Opens the world.
  4. Continues the handoff.

World Transfer (Dedicated Server)

No file transfer is required.

The server remains online.

When one player's timer expires:

  1. The player is disconnected.
  2. The next player joins.
  3. The saved state is restored automatically.

Reconnecting

If the active player disconnects before their timer expires:

Welcome back. You have XX:XX remaining.

The timer continues from where it left off.

No progress is lost.

Spectator Workflow

Approved spectators may join at any time.

Spectators:

  • automatically enter spectator mode
  • cannot interfere with gameplay
  • do not consume participant slots
  • do not affect timers

Integrity Protection

Handoff Relay includes multiple protections to preserve fair gameplay.

Features include:

  • anti-creative enforcement
  • anti-flight enforcement
  • dangerous command blocking
  • single active-player enforcement
  • expired player lockout
  • LAN cheat detection
  • backup recovery
  • integrity lock protection

These protections help ensure all participants experience the same rules.

Recommended Event Format

Example:

Players: 10
Turn Length: 60 Minutes
Spectator: EventObserver

Commands:

/handoff time 60
/handoff players 10
/handoff spectator EventObserver

This format works well for:

  • YouTube series
  • Twitch events
  • challenge runs
  • community survival projects
  • charity events
  • multiplayer relay challenges

Support

Found a bug or have a feature request?

Please use the GitHub issue tracker:

https://github.com/Kingra007/handoff-relay/issues

Include:

  • Handoff Relay version
  • Minecraft version
  • Fabric Loader version
  • Singleplayer or server
  • Steps to reproduce
  • Expected behaviour
  • Actual behaviour

Version

Documentation applies to:

Handoff Relay v1.0.0

Clone this wiki locally