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 ```yaml mode: TEAM sync-enderchest: true save-team-state: true debug: false