~/projects/syncrun

GAMES2025

SyncRun

A Minecraft minigame plugin that links two or more players together so their health and hunger stay synchronized as a shared pool.

TIMELINE
Sep 2025
TEAM
Solo
CONTEXT
Personal project
Diagram of three linked players showing identical hearts and hunger after one of them takes damage, fed by one shared pool.

Overview

SyncRun is a Minecraft minigame plugin that links players’ vitals together: linked players share synchronized health and hunger, so damage or hunger loss taken by one player is mirrored onto the others. It also disables armor for linked players to keep the shared-damage mechanic consistent.

Features

  • /sync link and /sync remove to link or unlink players from the shared-vitals pool
  • Synchronized health and hunger across all linked players, applied on join, respawn, and in response to damage/regen/food-level-change events
  • Armor disabling for players while sync is active, enforced by a dedicated listener

How it works

VitalsSync listens for health, hunger, join, and respawn events and propagates the most recent health/hunger values to all linked players, using a per-player ignore list to avoid feedback loops when applying a synced change triggers another event. ArmorDisabler strips or blocks armor while sync mode is active, and SyncCommand manages which players are currently linked.