TeamSync

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper

标签： adventure equipment game-mechanics

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