
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 玩家可以链接他们自己的基岩版账号:
- 基岩版玩家通常显示为带有 Floodgate 前缀的用户名(例如
"."或自定义前缀)。 - Java 玩家可以运行:
/link <bedrockUsernameWithPrefix> - 基岩版玩家必须接受该请求:
/link accept <javaPlayerName> - 接受后,基岩版账号将获得 Java 端的游戏物品栏(如果启用了实时同步,则同步生效)。
- 提示: 请向玩家提供 Floodgate 前缀说明,以便他们输入正确的基岩版用户名。
这非常适合在 Java 和基岩版之间切换且希望拥有单一共享游戏物品栏的玩家。
? 命令
/link <player>— 向<player>发送链接请求/link accept <player>— 接受来自<player>的待处理请求/link deny <player>— 拒绝来自<player>的待处理请求/inventorylink reload— 重载config.yml(权限:inventorylink.admin)
权限节点
inventorylink.link— 默认值:trueinventorylink.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 — 保留许可证信息,作者不承担责任。欢迎贡献。
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
46
Beds Always Explode
rabiesland
使床在所有维度中爆炸的模组
诅咒玩法机制
30
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧