Synchro

插件

· 作者 CloudDev

同步物品栏、护甲、生命值、饥饿值、经验值、效果、末影箱、进度、睡眠和死亡状态,将它们整合为一个可配置的共享合作生存状态。

0 本站下载 0 关注 更新于 5 个月前

最新 1.7.0 · 1.21.11 · Bukkit / Folia

一键开服(送7天)

Synchro

Synchro 将多人生存模式转变为共享的玩家状态。物品栏、盔甲、生命值、饥饿值、效果、经验值、进度、末影箱、着火状态、睡眠和死亡都可以同步,使一群玩家作为一个合并的角色进行游戏。

如果你想要一种每个行动都对所有人至关重要的合作挑战,Synchro 正是为这种服务器风格而构建的。

亮点

  • 共享物品栏、盔甲、末影箱、进度、生命值、饥饿值、饱和度、经验值和药水效果
  • 单人睡眠即可跳过夜晚,无需整个团队进入床铺
  • 同步着火刻、死亡、重生处理以及死后物品栏状态
  • 通过版本化共享状态和延迟应用保护机制防止竞态条件
  • 更安全的物品栏处理,适用于合成、熔炉提取、漏斗、拾取、掉落、桶、载具、物品展示框和 /give 命令
  • 每个模块都有 config.yml 开关,支持 /synchro reload 重载
  • 管理工具包括强制同步、恢复、调试日志、状态查看和版本检查
  • 可选的 Modrinth 和 GitHub 更新通知(针对拥有管理员权限的玩家)
  • Folia 感知调度路径,并兼容 Bukkit/Paper 回退

命令

  • /synchro enable
  • /synchro disable
  • /synchro sync [module]
  • /synchro status
  • /synchro reload
  • /synchro restore
  • /synchro debug <on|off>
  • /synchro version

支持的同步模块包括 all、inventory、armor、effects、potion-effects、health、hunger、experience、xp、ender-chest 和 fire-ticks。

权限

  • synchro.admin - 使用 Synchro 管理命令并接收更新通知

配置

默认情况下所有模块均已启用。在 config.yml 中将某个模块设置为 false 并运行 /synchro reload 即可仅禁用该部分的同步功能。

sync:
  inventory: true
  armor: true
  potion-effects: true
  health: true
  hunger: true
  experience: true
  death: true
  ender-chest: true
  advancements: true
  one-player-sleep: true
  fire-ticks: true

debug:
  enabled: false

update-checker:
  enabled: true
  check-interval-minutes: 60
  notify-permission: synchro.admin
  modrinth-project: "I0rM9fEI"
  github-repo: "St1ch/Synchro"

典型工作流程

  1. 安装 Synchro 并启动服务器一次以生成 config.yml。
  2. 两名或更多玩家加入服务器并运行 /synchro status。
  3. 如有需要,使用 /synchro sync 初始化共享状态。
  4. 根据你的合作挑战类型调整 config.yml 中的模块开关。
  5. 修改配置后运行 /synchro reload。
  6. 在测试边缘情况时使用 /synchro debug on,正常游玩时请将其关闭。

更新通知

当发现新版本时,拥有 synchro.admin 权限的玩家在加入时会收到通知。Modrinth 检查使用项目 I0rM9fEI,GitHub 发布检查使用 St1ch/Synchro。

检查器由 update-checker.check-interval-minutes 缓存,因此不会在每次加入时调用远程 API。

API 用法

其他插件可以使用 Synchro 的 API:

import org.redstone.SynchroAPI;

if (SynchroAPI.isSyncEnabled()) {
    // Do something.
}
SynchroAPI.setSyncEnabled(false);
SynchroAPI.manualSync();

开发

使用以下命令构建插件:

.\gradlew.bat build

构建好的 jar 文件将位于 build/libs 中。

兼容性

  • Minecraft: 1.18 至 1.21.x
  • 核心:Bukkit, Spigot, Paper, Folia
  • Java: 17

注意事项

  • Synchro 围绕共享生存状态设计,而非每个玩家独立的物品栏。
  • 更新检查器使用 Modrinth 和 GitHub 的公共 API,并且仅向具有配置权限的玩家发送通知。
  • 一些复杂的物品栏行为依赖于服务器刻 timing;调试日志有助于诊断异常的插件堆栈交互。

许可证

本项目根据 MIT License 分发。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源