📖About 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