SharedInventoryLink

<div align="center"> # 🔗 SharedInventoryLink **Real-time inventory synchronization for Paper servers** (https://img.shields.io/badge/Paper-1.20--1.21+-blue?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==)](https://papermc.io) (https://img.shields.io/badge/Java-17+-orange?style=flat-square)](https://adoptium.net) (https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE) (https://img.shields.io/badge/Discord-allay__gaming__x-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.com) > Link two or more players' inventories so they always share the same items — in real-time, across armor, hotbar, off-hand, and more. --- </div> ## 🌟 What is SharedInventoryLink? **SharedInventoryLink** is a lightweight Paper plugin that links the inventories of players in a group. When one player picks up an item, crafts something, or equips armor — every linked teammate instantly sees the same change. Perfect for **co-op survival**, **adventure maps**, **duos/trios PvP**, and any gamemode where shared resources are part of the fun. --- ## ✨ Features | Feature | Description | |---|---| | 🔄 **Real-time Sync** | Inventory updates are pushed within 1 tick (50ms) | | 👥 **Group System** | Define named groups in `config.yml` — each group shares one inventory | | 🌍 **Global Sync Mode** | Optionally sync ALL players on the server to one shared inventory | | 🛡️ **Full Slot Support** | Syncs main inventory, armor slots, and off-hand | | ☠️ **No Death Duplication** | Items never drop on death — no dupe exploits possible | | 🤝 **Join Sync** | Players who join mid-session instantly receive the group's inventory | | 📋 **PlaceholderAPI** | Built-in PAPI placeholders for tab lists and chat plugins | | ⚡ **Bypass Permission** | Staff/admins can opt out of syncing | | 🔧 **Hot Reload** | `/sinv reload` reloads config with zero restarts | --- ## 📦 Installation 1. Download `SharedInventoryLink.jar` 2. Drop it into your server's `/plugins` folder 3. Restart the server 4. Edit `plugins/SharedInventoryLink/config.yml` 5. Run `/sinv reload` — done! **Requirements:** - Paper (or its forks: Purpur, Folia) **1.20 – 1.21+** - Java 17 or higher - *(Optional)* PlaceholderAPI for placeholders --- ## ⚙️ Configuration ```yaml # Global sync: share inventory with every player on the server global-sync: enabled: false # Group sync: only listed players share inventories groups: team_red: - PlayerA - PlayerB team_blue: - PlayerC - PlayerD # What to sync sync: main-inventory: true # Hotbar + main storage armor: true # Helmet, chestplate, leggings, boots off-hand: true # Off-hand slot on-pickup: true # Sync when item is picked up on-consume: true # Sync when food/potion is consumed on-drop: true # Sync when item is manually dropped on-click: true # Sync on inventory click / crafting sync-delay-ticks: 1 # Delay before sync fires (1 tick = 50ms) ``` --- ## 💬 Commands | Command | Alias | Description | Permission | |---|---|---|---| | `/sharedinventory help` | `/sinv help` | Show help menu | `sharedinventorylink.admin` | | `/sharedinventory reload` | `/sinv reload` | Reload config | `sharedinventorylink.admin` | | `/sharedinventory status` | `/sinv status` | Show your sync group | `sharedinventorylink.admin` | | `/sharedinventory info` | `/sinv info` | Plugin info & version | `sharedinventorylink.admin` | --- ## 🔑 Permissions | Permission | Default | Description | |---|---|---| | `sharedinventorylink.admin` | OP | Access to all admin commands | | `sharedinventorylink.reload` | OP | Reload configuration | | `sharedinventorylink.bypass` | false | Skip inventory sync entirely | --- ## 📊 PlaceholderAPI Placeholders > Requires (https://www.spigotmc.org/resources/placeholderapi.6245/) to be installed. | Placeholder | Returns | |---|---| | `%sharedinventorylink_group%` | Player's group name, or `None` | | `%sharedinventorylink_tag%` | Formatted group tag e.g. `` | | `%sharedinventorylink_in_group%` | `true` or `false` | | `%sharedinventorylink_global%` | `true` if global sync is on | --- ## 🛡️ Anti-Duplication System SharedInventoryLink includes a full **death-safe inventory system**: - When a grouped player dies, **all item drops are cancelled** — nothing falls on the ground - The dead player's empty inventory is **locked** and never synced to teammates - On respawn, the player **automatically receives** the group's current inventory - Manual drops (pressing Q) still work and sync correctly to the group This means **zero item duplication** regardless of how players die or respawn. --- ## 🗺️ Use Cases - 🏝️ **Co-op survival** — a couple or friends sharing one inventory pool - ⚔️ **Team PvP** — duos/trios where resource sharing is a mechanic - ���