Open Persistence

Open source reimplementation of Persistent Players, with fixes and Mod Compatibility

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.

The Open Persistence Team

profile avatar
  • 38
    Followers
  • 6
    Projects
  • 138.1K
    Downloads

More from MisterNorwoodView all