Open Persistence
Open source reimplementation of Persistent Players for 1.12.2, with fixes and Mod Compatibility
About this Mod
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.
Available Versions
How to Install Open Persistence on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Open Persistence". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.20.1, 1.12.2
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Open Persistence server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Open Persistence compatible with fabric and forge and neoforge?
Open Persistence officially supports fabric, forge, neoforge for Minecraft 1.21.1, 1.20.1, 1.12.2. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Open Persistence – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Open Persistence consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install Open Persistence with just one click on your server.