🌟 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

# 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 PlaceholderAPI to be installed.

Placeholder	Returns
%sharedinventorylink_group%	Player's group name, or None
%sharedinventorylink_tag%	Formatted group tag e.g. [team_red]
%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
• 🗺️ Adventure maps — force inventory parity between players
• 🎮 Minigames — kit distribution that stays in sync automatically

---

🚀 Recommended Hosting — Slug Hosting

🎮 SharedInventoryLink is proudly tested and recommended on Slug Hosting — affordable, high-performance Minecraft server hosting with an intuitive control panel, DDoS protection, and instant setup.

📝 Changelog

v1.0.0

• Initial release
• Group & global sync system
• Full armor + off-hand support
• Anti-death-duplication system
• PlaceholderAPI integration
• Hot reload command

---