
InventoryLink
实时链接两个玩家的游戏物品栏 —— 通过可选的请求/接受流程以及强大的安全措施。专为 PaperMC 1.21.x 和 Java 21 设计。
⚠️ 不可逆: 当链接被接受时,接受者的当前游戏物品栏将被清空并替换为请求者的内容。此操作无法撤销。不建议与陌生玩家建立链接。
✅ 支持的平台与要求
- Minecraft 服务器: PaperMC 1.21.x (API 1.21)。
- 适用于保持 API 一致性的 Paper 兼容分支(例如 Purpur)。
- Java 运行时: Java 21(服务端 + 构建环境)。
- 可选的基岩版游玩支持: GeyserMC + Floodgate(用于 Java↔基岩版账号链接场景)。
✨ 功能特性
- 双人游戏物品栏共享:通过
/link → /link accept / /link deny 实现。
- 实时同步开关 (
live-sync: true|false)
true:双方玩家均可在线;游戏物品栏实时镜像(点击、拖拽、放置、拾取)。
false:仅允许一个已链接的玩家在线;另一名玩家将被踢出,并显示可配置的消息。
- 死亡后清空(支持离线状态): 如果一名已链接的玩家死亡,其搭档的游戏物品栏和末影箱将被清空。如果搭档处于离线状态,则在下一次登录时执行清空操作。
- 请求过期机制: 链接请求在可配置的超时时间后失效。
- 禁止重复链接: 已经建立链接的玩家无法发送或接受新的
/link 请求。
- 按玩家独立的数据文件夹:
plugins/InventoryLink/playerdata/<PlayerName>/
inventory.yml — 序列化快照
link.yml — 搭档名称及标志位(例如 pendingClearOnJoin)
- 使用经典
& 颜色代码的可配置消息。
- 管理员命令:无需重启即可重载配置文件。
? 基岩版使用场景(Java ↔ 基岩版)
如果您的服务器通过 GeyserMC + Floodgate 支持基岩版,Java 玩家可以链接他们自己的基岩版账号:
这非常适合在 Java 和基岩版之间切换且希望拥有单一共享游戏物品栏的玩家。
? 命令
/link <player> — 向 <player> 发送链接请求
/link accept <player> — 接受来自 <player> 的待处理请求
/link deny <player> — 拒绝来自 <player> 的待处理请求
/inventorylink reload — 重载 config.yml(权限:inventorylink.admin)
权限节点
inventorylink.link — 默认值:true
inventorylink.admin — 默认值:op
⚙️ 配置 (plugins/InventoryLink/config.yml)
live-sync: true # 允许两名已链接玩家同时在线并实时镜像
sync-debounce-ms: 200 # 防抖延迟以避免循环
kick-message: "&cYour linked partner is already online. Live sync is disabled on this server."
clear-on-death: true # 死亡时也清空搭档;离线搭档将在下次登录时清空
request-timeout-seconds: 60 # 待处理的 /link 请求在此秒数后过期
block-command-while-linked: true
messages:
already-linked: "&cYou are already inventory-linked and cannot use /link."
target-already-linked: "&cThat player is already inventory-linked and cannot accept new links."
request-expired: "&cThat link request has expired. Please send a new one."
request-sent: "&aLink request sent to %target%."
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."
accept-hint: "&aType /link accept %sender% or /link deny %sender%"
accepted: "&aYou are now linked with %other%. Inventories are now synced."
denied: "&eYou denied the link request from %other%."
partner-join-kick: "&cYour linked partner is already online. Live sync is disabled on this server."
reloaded: "&aInventoryLink config reloaded."
pending-cleared-on-join: "&eYour inventory was cleared due to your partner's recent death."
? 工作原理
- 请求:
/link <player> — 目标玩家收到警告以及接受/拒绝的指令。
- 接受: 接受者的当前游戏物品栏将被清空并替换为请求者的内容。
- 实时同步(可选): 当
live-sync: true 时,双方的游戏物品栏实时镜像。
- 死亡同步: 玩家死亡时,搭档将被清空(如果在线则立即执行,否则在下次登录时执行)。
? 安装方法
- 将插件 jar 文件放入 Paper 1.21.x 服务器的
plugins/ 目录中。
- 启动服务器以生成配置文件。
- 编辑
plugins/InventoryLink/config.yml。
- 通过
/inventorylink reload 应用更改或重启服务器。
? 安全须知
- 本插件在接受链接时(如果启用死亡清空功能)会故意执行破坏性的游戏物品栏操作。
- 仅在玩家明确同意的情况下使用;如果您使用了自定义物品系统,建议考虑备份数据。
? 许可证
MIT — 保留许可证信息,作者不承担责任。欢迎贡献。

InventoryLink
Link two player inventories — live — with an opt-in request/accept flow and strong safeguards. Designed for PaperMC 1.21.x and Java 21.
⚠️ Irreversible: When a link is accepted, the accepting player’s current inventory is cleared and replaced with the requester’s. This cannot be undone. Linking to unknown players is not recommended.
✅ Supported Platforms & Requirements
- Minecraft server: PaperMC 1.21.x (API 1.21).
- Works on Paper-compatible forks that maintain API parity (e.g., Purpur).
- Java runtime: Java 21 (server + build).
- Optional Bedrock play: GeyserMC + Floodgate (for Java↔Bedrock account linking use case).
✨ Features
- Two-player inventory sharing via
/link → /link accept / /link deny.
- Live Sync toggle (
live-sync: true|false)
true: both players can be online; inventories mirror in real-time (click, drag, drop, pickup).
false: only one linked player may be online; the second gets kicked with a configurable message.
- Clear on Death (with offline support): If one linked player dies, the partner’s inventory & ender chest are cleared. If the partner is offline, the clear is applied on next join.
- Request Expiry: Link requests expire after a configurable timeout.
- Block Linking While Linked: Already linked players can’t send or accept new
/link.
- Per-player data folder:
plugins/InventoryLink/playerdata/<PlayerName>/
inventory.yml — serialized snapshots
link.yml — partner name + flags (e.g., pendingClearOnJoin)
- Configurable Messages using classic
& color codes.
- Admin Command to reload config without restarting.
? Bedrock Use Case (Java ↔ Bedrock)
If your server supports Bedrock via GeyserMC + Floodgate, a Java player can link their own Bedrock account:
This is ideal for players who switch between Java and Bedrock and want a single, shared inventory.
? Commands
/link <player> — Send a link request to <player>
/link accept <player> — Accept a pending request from <player>
/link deny <player> — Deny a pending request from <player>
/inventorylink reload — Reload config.yml (permission: inventorylink.admin)
Permissions
inventorylink.link — default: true
inventorylink.admin — default: op
⚙️ Configuration (plugins/InventoryLink/config.yml)
live-sync: true # Allow both linked players online & mirror live
sync-debounce-ms: 200 # Debounce mirroring to avoid loops
kick-message: "&cYour linked partner is already online. Live sync is disabled on this server."
clear-on-death: true # Also clears partner on death; offline partners clear on next join
request-timeout-seconds: 60 # Expire pending /link requests
block-command-while-linked: true
messages:
already-linked: "&cYou are already inventory-linked and cannot use /link."
target-already-linked: "&cThat player is already inventory-linked and cannot accept new links."
request-expired: "&cThat link request has expired. Please send a new one."
request-sent: "&aLink request sent to %target%."
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."
accept-hint: "&aType /link accept %sender% or /link deny %sender%"
accepted: "&aYou are now linked with %other%. Inventories are now synced."
denied: "&eYou denied the link request from %other%."
partner-join-kick: "&cYour linked partner is already online. Live sync is disabled on this server."
reloaded: "&aInventoryLink config reloaded."
pending-cleared-on-join: "&eYour inventory was cleared due to your partner's recent death."
? How it Works
- Request:
/link <player> — Target receives warnings + accept/deny instructions.
- Accept: The accepting player’s current inventory is cleared and replaced with the requester’s.
- Live Sync (optional): With
live-sync: true, both inventories mirror in real-time.
- Death Sync: On death, partner is cleared (immediately if online, or on next join).
? Installation
- Drop the plugin jar into
plugins/ on a Paper 1.21.x server.
- Start the server to generate the config.
- Edit
plugins/InventoryLink/config.yml.
- Apply changes with
/inventorylink reload or restart.
? Safety Notes
- This plugin deliberately performs destructive inventory operations on accept and on death (if enabled).
- Use where players explicitly consent; consider backups if you run custom item systems.
? License
MIT — keep the license and don’t hold the author liable. Contributions welcome.
评论 0
登录后参与评分
还没有评论,来抢沙发吧