TeamSync

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