Inventory-Sync

Inventory Sync

--(1.21.11)-green.svg)

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

* Offline Protection: Easily create your own inventory groups and manage them with full ownership controls. * Offline Protection: Secure your group with a robust invite system. Send clickable invite messages to friends. * Offline Protection: 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

* Zero Leaking: Choose exactly where inventory syncing is allowed using `WHITELIST` or `BLACKLIST` modes. * Zero Leaking: 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. * Zero Leaking: 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

* Legacy Linking: Syncs Legacy Linking, Legacy Linking, Legacy Linking, and Legacy Linking instantly. * Legacy Linking: Includes configurable safeguards like "Wipe on Join/Leave" and empty inventory requirements to prevent duplication exploits. * Legacy Linking: 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

* 1.8 to Latest: Click [ACCEPT] or [DENY] directly in chat for invitations. * 1.8 to Latest: Clear, color-coded messages keep you informed of every action. * 1.8 to Latest: Suppress join/leave, offline, or world transition notifications for a cleaner chat experience. * 1.8 to Latest: 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 InventorySync!

* 🧪 Sync Effects: When one friend takes damage, everyone feels the pain! * 🧪 Sync Effects: 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.