# KeepBody
\n
\nInspired by the offline body mechanic in Rust, this plugin brings a similar experience to your Minecraft server. When a player logs out, a Citizens NPC (player-type) is spawned at their location as an offline “body”.
\nUpon login, the NPC’s state (location, HP, inventory) is synced back to the player and the NPC is removed.<\/p>\n
—<\/p>\n
## Requirements
\n| | |
\n|—|—|
\n| Server | Spigot or Paper 1.21.1+ |
\n| Java | 21+ |
\n| Required Plugin | Citizens |<\/p>\n
—<\/p>\n
## Features
\n– **Offline body** \u2014 Spawns an NPC with the player’s skin and equipment at logout
\n– **State sync** \u2014 Restores location, HP, and inventory to the player on login
\n– **NPC death** \u2014 If the NPC is killed while the player is offline, items drop naturally and the player dies on next login
\n– **Inventory access** \u2014 Right-clicking the NPC opens its inventory (configurable)<\/p>\n
—<\/p>\n
## Required Plugin
\n| Plugin | Checked version | Download |
\n|—|—|—|
\n| Citizens | 2.0.35-SNAPSHOT | https:\/\/ci.citizensnpcs.co\/job\/citizens2\/ |<\/p>\n
> Citizens must be placed in the `plugins\/` folder. KeepBody declares it as a required dependency so Citizens is always enabled first.<\/p>\n
—<\/p>\n
## Installation
\n1. Download Citizens and place it in `plugins\/`
\n2. Download KeepBody and place `KeepBody-1.0-SNAPSHOT.jar` in `plugins\/`
\n3. Start the server<\/p>\n
—<\/p>\n
## Configuration (`plugins\/KeepBody\/config.yml`)
\n“`yaml
\n# Whether right-clicking the NPC allows editing its inventory
\n# true: items can be added\/removed \/ false: inventory cannot be opened
\nallow-inventory-edit: true
\n# Whether the NPC lies down (uses SleepTrait) at the player’s logout position
\nsleep-npc: true
\n# Whether to keep the NPC frozen in place when hit
\n# true: velocity and position are restored each hit so the NPC never moves
\nimmobilize-npc: false
\n# Whether the NPC is invincible (takes no damage while the player is offline)
\n# Hurt animation and knockback still occur; only HP tracking is skipped
\ninvincible-npc: false
\n# Language setting: ‘en’ (English) or ‘ja’ (Japanese)
\nlanguage: ‘en’
\n# Ghost NPC cleanup interval in seconds
\n# A “ghost” is an untracked “(Offline)” NPC left behind by a crash or reload.
\n# This interval controls how often the plugin scans for and removes them,
\n# and respawns any missing body NPCs for currently-offline players.
\nghost-cleanup-interval: 300
\n# Debug mode
\n# true: show debug messages in console and in-game (OP only)
\ndebug: false
\n# In-game messages. Color codes using ‘&’ are supported (e.g. &cRed, &aGreen).
\nmessages:
\n en:
\n inventory-name: “%s’s inventory”
\n barrier-name: “&cUnavailable”
\n npc-spawned: “Spawned body of %s.”
\n npc-died: “Body of %s has died.”
\n inventory-opened: “‘%s’ opened the body of ‘%s’.”
\n ja:
\n inventory-name: “%s\u306e\u30a4\u30f3\u30d9\u30f3\u30c8\u30ea”
\n barrier-name: “&c\u4f7f\u7528\u4e0d\u53ef”
\n npc-spawned: “%s \u306e\u30dc\u30c7\u30a3\u30fc\u3092\u751f\u6210\u3057\u307e\u3057\u305f\u3002”
\n npc-died: “%s \u306e\u30dc\u30c7\u30a3\u30fc\u304c\u6b7b\u4ea1\u3057\u307e\u3057\u305f\u3002”
\n inventory-opened: “‘%s’ \u304c ‘%s’ \u306e\u30dc\u30c7\u30a3\u30fc\u3092\u958b\u304d\u307e\u3057\u305f\u3002”
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
KeepBody is a plugin that prevents players from disappearing when they log out.(Rust Like)<\/p>\n","protected":false},"featured_media":89943,"template":"","meta":{"_minecraft_slug":"keepbody","_minecraft_project_id":"cwhjdENS","_minecraft_author":"topi-k","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":29,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"keepbody.zip","_minecraft_size_bytes":103588,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T22:06:43.084664Z","_minecraft_date_created":"2026-04-17T21:01:00.469121Z","_minecraft_date_modified":"2026-05-11T14:57:30.373110Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/keepbody","_minecraft_icon_attachment_id":89943,"_minecraft_imported_at":"2026-06-05T03:16:20+00:00","_minecraft_import_hash":"94c584bf84a3912ed7d04bf5ed776d75","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,127,129,92],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-89942","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n