Open Persistence

Open Persistence

一个开源的 Persistent Players 重制版，针对现代 Minecraft 进行了重建，并包含错误修复和模组兼容性。

当玩家登出多人游戏服务器时，Open Persistence 会留下一个持久化身体——一个看起来像玩家的实体，并携带其所有装备，站在他们断线的地方。当他们重新登录时，其状态会被转移回去，身体随之移除。在玩家离开期间，这个身体可以被其他玩家或生物杀死，掉落玩家的物品栏（并更新其离线存档数据，因此损失是永久性的）。

这使得在生存/PvP 服务器上登出成为一个需要慎重考虑的决定：你的角色会留在世界中，并且在你返回之前一直处于脆弱状态。

功能

• 持久化登出身体 —— 玩家登出时生成一个玩家外形的实体，穿戴并持有玩家的全部物品栏和装备。
• 登录时状态往返 —— 玩家重新加入时，物品栏、盔甲和饰品槽位会被恢复；随后身体会消失。
• 可击杀的身体 —— 身体拥有生命值并可被杀死；这样做会掉落玩家的物品，并将更改写回其离线玩家数据。
• 防消失 —— 身体不会在和平难度或禁用 doMobSpawning / 生物生成游戏规则时消失。它无视消失距离和持久化剔除。
• 饰品支持 —— 额外的装备槽位在登出/登录过程中会被保留。
• 可配置 —— 参见 配置。

支持的版本

Open Persistence 是一个多版本单一项目（使用 Prism 构建系统），并针对每个 Minecraft 版本和模组加载器发布独立的 jar 文件。

Minecraft	加载器	加载器版本	饰品兼容性
1.12.2	Forge	Forge 14.23.5.2847	ModularWarfare（Shining 分支）
1.20.1	Forge · Fabric	Forge 47.4.18 · Fabric 加载器 0.18.6（API 0.92.7+1.20.1）	Curios（Forge）
1.21.1	NeoForge · Fabric	NeoForge 21.1.222 · Fabric 加载器 0.18.6（API 0.116.9+1.21.1）	Curios（NeoForge）
26.1	NeoForge · Fabric	NeoForge 26.1.1.0-beta · Fabric 加载器 0.18.6（API 0.145.2+26.1.1）	Curios（NeoForge）

兼容性

饰品/额外槽位模组作为可选的软依赖集成——Open Persistence 在没有它们的情况下也能正常工作，并在存在时于运行时检测它们。

• Curios （1.20.1+，Forge/NeoForge）—— Curios 槽位中的物品会被复制到身体上，并在登录时恢复。Curios 是仅限 Forge/NeoForge 的模组；在 Fabric 上没有 Curios 集成，饰品处理为无操作。
• ModularWarfare （1.12.2，Shining 分支）—— 原版模组的额外槽位兼容性在旧版构建中得到保留。

配置

选项	默认值	描述
persistCreativePlayers	true	创造模式的玩家是否也会留下持久化身体。
offlinePlayersSleep	false	离线身体是否躺下（睡眠姿势，碰撞箱更小）。
debug	false	为故障排查输出的详细日志。

许可证

基于 GPL-3.0 许可证发布。