PerPlayerKeepInventory

A modern Paper plugin that allows each player to independently control their own death item and experience drop, without modifying global game rules.

Say goodbye to the server-wide keepInventory game rule! PerPlayerKeepInventory offers granular control for server administrators and players. Players can freely choose to enable or disable their own death drops, and their settings are securely saved and persist after server restarts.

✨ Features

• 👤 Per-Player Settings: Each player's death drop status is stored and calculated independently, without interfering with others.
• ⚙️ Predictable Behavior: Automatically falls back to the world's keepInventory game rule when a player has no custom setting.
• 🛡️ Granular Permission Control: Provides a complete set of permission nodes for precise control over who can view or modify their own or others' status.
• 💾 Data Persistence: Uses the player's PersistentDataContainer to store settings, ensuring safety and reliability as data is saved and loaded with the player.

📥 Download & Installation

1. Download the latest .jar file from this page.
2. Place the downloaded .jar file into your Paper server's plugins/ directory.
3. Restart or reload your server.
4. The plugin will automatically generate a default configuration file (config.yml), which you can adjust as needed.

Prerequisite: This plugin requires a server running Paper 1.21.8 or higher. Other versions are untested.

📖 Commands & Permissions

The plugin's main command is /keepinv by default (can be changed in the configuration file, requires a server restart to take effect).

Command List

Command	Description	Required Permission (Default)
/keepinv get [player]	Check your own (or a specified player's) death drop status.	keepinv.get (self) keepinv.get.others (others)
/keepinv set <true|false> [player]	Set the death drop status for yourself (or a specified player).	keepinv.set (self) keepinv.set.others (others)
/keepinv toggle [player]	Toggle the death drop status for yourself (or a specified player).	keepinv.toggle (self) keepinv.toggle.others (others)
/keepinv reset [player]	Reset your own (or a specified player's) setting to inherit the world's default rule.	keepinv.reset (self) keepinv.reset.others (others)
/keepinv help	Display this help information.	None

Permission Nodes

All permissions can be viewed in plugin.yml. By default (default: op), only server operators (admins) have access.

Permission Node	Description
keepinv.use	Permission to use the base /keepinv command.
keepinv.get	Permission to view your own status.
keepinv.get.others	Permission to view another player's status.
keepinv.set	Permission to set your own status.
keepinv.set.others	Permission to set another player's status.
keepinv.toggle	Permission to toggle your own status.
keepinv.toggle.others	Permission to toggle another player's status.
keepinv.reset	Permission to reset your own setting.
keepinv.reset.others	Permission to reset another player's setting.

⚙️ Configuration

After the first run, the plugin will generate a config.yml file in the plugins/PerPlayerKeepInventory/ directory.

# PerPlayerKeepInventory Configuration File
rootCommandNodeName: "keepInv" # The name of the main command. Takes effect after a server restart.