CraftHub
TeamSync

TeamSync

Synchronize health, hunger, inventory, XP, potion effects, deaths, advancements and more across scoreboard teams or your entire server.

18 downloads

TeamSync

TeamSync is an advanced Paper Minecraft plugin that synchronizes player states in real time — either within scoreboard teams or across the entire server.

Instead of traditional multiplayer where every player has their own independent state, TeamSync turns gameplay into a shared experience where players effectively act as one synchronized entity.

🔧 Game Modes

TEAM MODE

  • Synchronizes players only within the same scoreboard team
  • Each team has its own independent shared state
  • Teams do not affect each other

GLOBAL MODE

  • All players on the server share a single synchronized state
  • Every change affects everyone instantly

❤️ Synchronized Features

  • Health (HP, max HP, absorption)
  • Hunger (food level, saturation, exhaustion)
  • Full inventory
  • Armor and offhand item
  • Potion effects (complete synchronization)
  • Experience (level and progress)
  • Advancements and recipe unlocks
  • Death system (shared team or global death)

💀 Death System

If one synchronized player dies:

  • All synchronized players die instantly
  • Items are dropped normally
  • Death count is shared across the group

📦 Ender Chest Sync (Optional)

  • Shared ender chest per team or globally
  • Fully configurable via config.yml

⚙️ Join & State Handling

  • New players automatically receive the current shared state
  • Team changes move players between states
  • Players without a team operate independently

🚀 Performance & Optimization

TeamSync is built with performance in mind:

  • Event-driven architecture (no constant ticking loops)
  • Cached state system
  • Minimal ItemStack cloning
  • No unnecessary player scanning
  • Protection against infinite sync loops
  • Lightweight and scalable for 200+ players

🧠 Last Update Wins System

Conflicts are resolved using a timestamp-based system:

  • The most recent change always overrides previous state
  • Ensures consistency across all synchronized players

🧩 Commands

  • /team-sync reload
  • /team-sync status
  • /team-sync mode <TEAM|GLOBAL>
  • /team-sync force-sync <player>
  • /team-sync gui

🛠️ Permissions

  • teamsync.admin

⚙️ Configuration

mode: TEAM
sync-enderchest: true
save-team-state: true
debug: false