InvLink

插件

· 作者 _blackdev_

一个允许玩家链接他们库存的插件,例如基岩版和 Java 版账号

0 本站下载 0 关注 更新于 1 年前

最新 1.2.0 · 1.21.8 · Paper / Purpur

一键开服(送7天)

InventoryLink banner

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 — 默认值: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."

? 工作原理

  1. 请求: /link <player> — 目标玩家收到警告以及接受/拒绝的指令。
  2. 接受: 接受者的当前游戏物品栏将被清空并替换为请求者的内容。
  3. 实时同步(可选): 当 live-sync: true 时,双方的游戏物品栏实时镜像。
  4. 死亡同步: 玩家死亡时,搭档将被清空(如果在线则立即执行,否则在下次登录时执行)。

? 安装方法

  1. 将插件 jar 文件放入 Paper 1.21.x 服务器的 plugins/ 目录中。
  2. 启动服务器以生成配置文件。
  3. 编辑 plugins/InventoryLink/config.yml。
  4. 通过 /inventorylink reload 应用更改或重启服务器。

? 安全须知

  • 本插件在接受链接时(如果启用死亡清空功能)会故意执行破坏性的游戏物品栏操作。
  • 仅在玩家明确同意的情况下使用;如果您使用了自定义物品系统,建议考虑备份数据。

? 许可证

MIT — 保留许可证信息,作者不承担责任。欢迎贡献。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源