\n# InventoryLink<\/p>\n
Link two player inventories \u2014 live \u2014 with an opt-in request\/accept flow and strong safeguards. Designed for **PaperMC 1.21.x** and **Java 21**.<\/p>\n
> \u26a0\ufe0f **Irreversible:** When a link is accepted, the accepting player\u2019s current inventory is **cleared and replaced** with the requester\u2019s. This **cannot be undone**. Linking to unknown players is **not recommended**.<\/p>\n
—<\/p>\n
## \u2705 Supported Platforms & Requirements<\/p>\n
– **Minecraft server:** PaperMC **1.21.x** (API 1.21).
\n – Works on Paper-compatible forks that maintain API parity (e.g., Purpur).
\n– **Java runtime:** **Java 21** (server + build).
\n– **Optional Bedrock play:** GeyserMC + Floodgate (for Java\u2194Bedrock account linking use case).<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– **Two-player inventory sharing** via `\/link` \u2192 `\/link accept` \/ `\/link deny`. —<\/p>\n ## \ud83e\udde9 Bedrock Use Case (Java \u2194 Bedrock)<\/p>\n If your server supports Bedrock via **GeyserMC + Floodgate**, a Java player can link their **own Bedrock account**:<\/p>\n – Bedrock players typically appear as usernames with a Floodgate prefix (e.g., `”.”` or a custom prefix). > This is ideal for players who switch between Java and Bedrock and want a single, shared inventory.<\/p>\n —<\/p>\n ## \ud83d\udce6 Commands<\/p>\n – `\/link **Permissions** —<\/p>\n ## \u2699\ufe0f Configuration (`plugins\/InventoryLink\/config.yml`)<\/p>\n “`yml clear-on-death: true # Also clears partner on death; offline partners clear on next join<\/p>\n request-timeout-seconds: 60 # Expire pending \/link requests messages: —<\/p>\n ## \ud83e\udded How it Works<\/p>\n 1. **Request:** `\/link —<\/p>\n ## \ud83d\udce5 Installation<\/p>\n 1. Drop the plugin jar into `plugins\/` on a **Paper 1.21.x** server. —<\/p>\n ## \ud83d\udd12 Safety Notes<\/p>\n – This plugin **deliberately performs destructive inventory operations** on accept and on death (if enabled). —<\/p>\n ## \ud83d\udcc4 License<\/p>\n MIT \u2014 keep the license and don\u2019t hold the author liable. Contributions welcome.<\/p>\n","protected":false},"excerpt":{"rendered":" a plugin that lets players link there inventory together for example a bedrock and java account<\/p>\n","protected":false},"featured_media":86173,"template":"","meta":{"_minecraft_slug":"invlink","_minecraft_project_id":"2cvVReqB","_minecraft_author":"_blackdev_","_minecraft_license":"MIT","_minecraft_downloads":126,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"invlink.zip","_minecraft_size_bytes":15508,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:02:36.493649Z","_minecraft_date_created":"2025-08-24T22:22:57.132294Z","_minecraft_date_modified":"2025-08-24T19:26:16.897642Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/invlink","_minecraft_icon_attachment_id":86173,"_minecraft_imported_at":"2026-06-04T22:08:44+00:00","_minecraft_import_hash":"1dba6c9ccb528063be6de7ccab90591c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,866,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-86172","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n– **Live Sync toggle** (`live-sync: true|false`)
\n – `true`: both players can be online; inventories mirror in real-time (click, drag, drop, pickup).
\n – `false`: only one linked player may be online; the second gets kicked with a configurable message.
\n– **Clear on Death (with offline support):** If one linked player dies, the partner\u2019s inventory & ender chest are cleared. If the partner is offline, the clear is applied on next join.
\n– **Request Expiry:** Link requests expire after a configurable timeout.
\n– **Block Linking While Linked:** Already linked players can\u2019t send or accept new `\/link`.
\n– **Per-player data folder:**
\n `plugins\/InventoryLink\/playerdata\/
\n – `inventory.yml` \u2014 serialized snapshots
\n – `link.yml` \u2014 partner name + flags (e.g., `pendingClearOnJoin`)
\n– **Configurable Messages** using classic `&` color codes.
\n– **Admin Command** to reload config without restarting.<\/p>\n
\n– A Java player can run:
\n “`
\n \/link
\n “`
\n– The Bedrock player must **accept** the request:
\n “`
\n \/link accept
\n “`
\n– After acceptance, the **Bedrock account receives the Java inventory** (and live sync applies if enabled).
\n– **Tip:** Keep your Floodgate prefix documented for players so they can type the correct Bedrock name.<\/p>\n
\n– `\/link accept
\n– `\/link deny
\n– `\/inventorylink reload` \u2014 Reload `config.yml` (permission: `inventorylink.admin`)<\/p>\n
\n– `inventorylink.link` \u2014 default: `true`
\n– `inventorylink.admin` \u2014 default: `op`<\/p>\n
\nlive-sync: true # Allow both linked players online & mirror live
\nsync-debounce-ms: 200 # Debounce mirroring to avoid loops
\nkick-message: “&cYour linked partner is already online. Live sync is disabled on this server.”<\/p>\n
\nblock-command-while-linked: true<\/p>\n
\n already-linked: “&cYou are already inventory-linked and cannot use \/link.”
\n target-already-linked: “&cThat player is already inventory-linked and cannot accept new links.”
\n request-expired: “&cThat link request has expired. Please send a new one.”
\n request-sent: “&aLink request sent to %target%.”
\n request-received: “&e%sender% wants to link inventories with you. &cAccepting will CLEAR your current inventory and cannot be undone. Linking to unknown players is not a good idea.”
\n accept-hint: “&aType \/link accept %sender% or \/link deny %sender%”
\n accepted: “&aYou are now linked with %other%. Inventories are now synced.”
\n denied: “&eYou denied the link request from %other%.”
\n partner-join-kick: “&cYour linked partner is already online. Live sync is disabled on this server.”
\n reloaded: “&aInventoryLink config reloaded.”
\n pending-cleared-on-join: “&eYour inventory was cleared due to your partner’s recent death.”
\n“`<\/p>\n
\n2. **Accept:** The accepting player\u2019s current inventory is **cleared** and replaced with the requester\u2019s.
\n3. **Live Sync (optional):** With `live-sync: true`, both inventories mirror in real-time.
\n4. **Death Sync:** On death, partner is cleared (immediately if online, or on next join).<\/p>\n
\n2. Start the server to generate the config.
\n3. Edit `plugins\/InventoryLink\/config.yml`.
\n4. Apply changes with `\/inventorylink reload` or restart.<\/p>\n
\n– Use where players explicitly consent; consider backups if you run custom item systems.<\/p>\n