Inventory Sync

InventorySync revolutionizes multiplayer gameplay by allowing players to share inventories, armor, and experience in real-time. Whether you're exploring with friends, working as a concerted team, or running a cooperative event, this plugin ensures everyone stays perfectly in sync.

---

TESTED MINECRAFT VERSION (1.18.x-1.21.11)

NOT FULLY TESTED ON OTHER MINECRAFT VERSIONS

🌟 Key Features

👥 Smart Group System

• Create & Control: Easily create your own inventory groups and manage them with full ownership controls.
• Invite-Only Access: Secure your group with a robust invite system. Send clickable invite messages to friends.
• Visual Management: Use the /invsync gui command to open a beautiful in-game GUI where you can view members and kick unwanted players (Owner only).
• Offline Protection: Configurable auto-kick for members who stay offline too long, ensuring the group's progress isn't stalled.

🌍 World Management

• Restrict Worlds: Choose exactly where inventory syncing is allowed using WHITELIST or BLACKLIST modes.
• Smart Pause: When a player enters a restricted world, their group inventory is safely "frozen" and cleared. It is restored instantly when they return to an enabled world.
• Strict Kick: Enable "Kick Mode" to automatically remove players from their group if they enter an unauthorized world.
• Zero Leaking: Guaranteed protection against moving items from Creative/Hub worlds into Survival groups.

🔄 Secure & Real-Time Syncing

• Complete Synchronization: Syncs Inventory, Armor, Off-hand, and Experience instantly.
• Safety First: Includes configurable safeguards like "Wipe on Join/Leave" and empty inventory requirements to prevent duplication exploits.
• Death Handling: Choose whether to keep inventories on death or wipe them for the whole group.
• Legacy Linking: Still supports simple 1-to-1 player linking for quick duo sessions.

⚡ User-Friendly Experience

• Interactive Chat: Click [ACCEPT] or [DENY] directly in chat for invitations.
• Feedback: Clear, color-coded messages keep you informed of every action.
• Message Control: Suppress join/leave, offline, or world transition notifications for a cleaner chat experience.
• Cross-Version Support: Seamlessly works on Minecraft versions from 1.8 to Latest.

---

🛠 Commands

Group Commands

Command	Description	Permission
/invsync create <name>	Create a new inventory group.	inventorysync.group
/invsync invite <player>	Invite a player to your group (Owner only).	inventorysync.group
/invsync join <group>	Join a group you have been invited to.	inventorysync.group
/invsync leave	Leave your current group (⚠️ Clears Inventory).	inventorysync.group
/invsync gui	Open the Group Management GUI.	inventorysync.group
/invsync info <group>	View information about a group.	inventorysync.group
/invsync deny <group>	Deny a pending group invitation.	inventorysync.group
/invsync delete <group>	Delete your group (Owner only).	inventorysync.group

Direct Link Commands

Command	Description	Permission
/invsync link <player>	Request a 1-to-1 link with another player.	inventorysync.link
/invsync accept <player>	Accept a link request.	inventorysync.link
/invsync unlink	Unlink yourself from a direct link.	inventorysync.link

Admin Commands (Alias: /isadmin)

Command	Description	Permission
/invsyncadmin groups	List all active groups.	inventorysync.admin
/invsyncadmin info <group>	View detailed info about a group.	inventorysync.admin
/invsyncadmin deletegroup <group>	Force delete a specific group.	inventorysync.admin
/invsyncadmin cleargroup <group>	Clear inventories of all members in a group.	inventorysync.admin
/invsyncadmin transfer <group> <player>	Transfer group ownership.	inventorysync.admin
/invsyncadmin list	List all direct 1-to-1 links.	inventorysync.admin
/invsyncadmin clear	Clear ALL direct links.	inventorysync.admin
/invsyncadmin forcelink <p1> <p2>	Force link two players directly.	inventorysync.admin
/invsyncadmin forceunlink <player>	Force unlink a player.	inventorysync.admin
/invsyncadmin reload	Reload the plugin configuration.	inventorysync.admin
/invsyncadmin reset <player>	Reset a player's group creation status.	inventorysync.admin

---

🔐 Permissions

• inventorysync.use: Basic access to the plugin (Default: true).
• inventorysync.group: Access to all Group-related commands (Default: true).
• inventorysync.link: Access to Direct Link commands (Default: true).
• inventorysync.admin: Access to Admin commands (Default: OP).

---

⚙️ Configuration

The plugin is highly configurable! Check config.yml to tweak:

• Max group size.
• Sync settings (armor, experience, offhand).
• Inventory wipe rules (on create, join, leave).
• Death handling behaviors.
• World Management (Pause/Kick modes, restricted worlds).
• Offline auto-kick timers.
• Message suppression (Join/Leave, Death, Offline, World Changes).

---

🎮 Enhance Your Experience

Want to take the challenge to the next level? Pair InventorySync with Health-Sync!

• ❤️ Sync Health: When one friend takes damage, everyone feels the pain!
• 🍖 Sync Hunger: Starve together or feast together.
• 🧪 Sync Effects: Share potion effects across the entire group.

Combining both plugins creates the ultimate cooperative survival challenge!

🤝 Support

Found a bug or have a suggestion? Join our support community Discord Server.