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 fork) |
| 1.20.1 | Forge · Fabric | Forge 47.4.18 · Fabric loader 0.18.6 (API 0.92.7+1.20.1) |
Curios (Forge) |
| 1.21.1 | NeoForge · Fabric | NeoForge 21.1.222 · Fabric loader 0.18.6 (API 0.116.9+1.21.1) |
Curios (NeoForge) |
| 26.1 | NeoForge · Fabric | NeoForge 26.1.1.0-beta · Fabric loader 0.18.6 (API 0.145.2+26.1.1) |
Curios (NeoForge) |
兼容性
饰品/额外槽位模组作为可选软依赖项集成 —— 即使没有它们,Open Persistence 也能正常运行,并在检测到这些模组存在时在运行时进行适配。
- Curios (1.20.1+ on Forge/NeoForge) —— Curios 槽位中的物品会被复制到躯体上,并在登录时恢复。Curios 是仅限 Forge/NeoForge 的模组;在 Fabric 上无 Curios 集成,饰品处理功能为空操作。
- ModularWarfare (1.12.2, Shining fork) —— 原版模组的额外槽位兼容性在旧版构建中得到保留。
配置
| 选项 | 默认值 | 描述 |
|---|---|---|
persistCreativePlayers |
true |
创造模式下的玩家是否也留下持久化躯体。 |
offlinePlayersSleep |
false |
离线躯体是否躺下(睡眠姿势,碰撞箱更小)。 |
debug |
false |
用于故障排查的详细日志记录。 |
许可证
遵循 GPL-3.0 许可证授权。
Open Persistence
An open-source reimplementation of Persistent Players, rebuilt for modern Minecraft with bug fixes and mod compatibility.
When a player logs out of a multiplayer server, Open Persistence leaves behind a persistent body — an entity that looks like the player and holds all of their gear, standing where they disconnected. When they log back in, their state is transferred back and the body is removed. While they are away, the body can be killed by other players or mobs, dropping the player's inventory (and updating their offline save data, so the loss sticks).
This makes logging out a meaningful decision on survival/PvP servers: your character stays in the world and remains vulnerable until you return.
Features
- Persistent logout bodies — a player-shaped entity spawns on logout, wearing and holding the player's full inventory and equipment.
- State round-trip on login – inventory, armor, and accessory slots are restored when the player rejoins; the body is then despawned.
- Killable bodies — the body has health and can be slain; doing so drops the player's items and writes the change back to their offline player data.
- Despawn-proof — the body will not vanish on peaceful difficulty or when
doMobSpawning/ mob-spawning gamerules are disabled. It ignores despawn distance and persistence culling. - Accessory support — extra equipment slots are preserved across logout/login.
- Configurable — see Configuration.
Supported versions
Open Persistence is built as a single multiversion project (using the Prism build system) and ships a separate jar per Minecraft version and mod loader.
| Minecraft | Loaders | Loader versions | Accessory compat |
|---|---|---|---|
| 1.12.2 | Forge | Forge 14.23.5.2847 |
ModularWarfare (Shining fork) |
| 1.20.1 | Forge · Fabric | Forge 47.4.18 · Fabric loader 0.18.6 (API 0.92.7+1.20.1) |
Curios (Forge) |
| 1.21.1 | NeoForge · Fabric | NeoForge 21.1.222 · Fabric loader 0.18.6 (API 0.116.9+1.21.1) |
Curios (NeoForge) |
| 26.1 | NeoForge · Fabric | NeoForge 26.1.1.0-beta · Fabric loader 0.18.6 (API 0.145.2+26.1.1) |
Curios (NeoForge) |
Compatibility
Accessory/extra-slot mods are integrated as optional soft dependencies — Open Persistence works fine without them, and detects them at runtime when present.
- Curios (1.20.1+ on Forge/NeoForge) — items in Curios slots are copied onto the body and restored on login. Curios is a Forge/NeoForge-only mod; on Fabric there is no Curios integration and accessory handling is a no-op.
- ModularWarfare (1.12.2, Shining fork) — the original mod's extra-slot compatibility is preserved on the legacy build.
Configuration
| Option | Default | Description |
|---|---|---|
persistCreativePlayers |
true |
Whether players in creative mode also leave a persistent body behind. |
offlinePlayersSleep |
false |
Whether offline bodies lie down (sleeping pose, smaller hitbox). |
debug |
false |
Verbose logging for troubleshooting. |
License
Licensed under the GPL-3.0.
下载 Open Persistence
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Open Persistence
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Open Persistence
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Open Persistence
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Open Persistence
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Open Persistence
下载 Open Persistence
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Open Persistence
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Open Persistence
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Open Persistence
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
Open Persistence 1.1.0,适用于 Minecraft 1.20.1 Forge。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
缓冲的原始输入和线程化的事件轮询
模组
一个用于收集生物掉落物的多区块模组。
模组
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
原版世界生成优化模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧