Keep It Personal

Description

Minecraft's keepInventory game rule provides an important feature for players, but it unfortunately fails to account for mixed preferences in servers. Keep It Personal is a Fabric mod which seeks to remedy this by providing commands to individually customize what players drop on death. With these commands, players can:

• Choose what they drop on death without affecting others
• Customize what parts of their inventory are dropped

Keep It Personal is designed to be lightweight and compatible; it's entirely server-side and is fully compatible with vanilla clients.

Installation

To install this mod, simply add the JAR to the mods directory in the root directory of the server.

Usage

This mod uses a single command, /kip, along with multiple subcommands as outlined below.

Death Preferences

The following table contains the options a player can choose to keep on death.

Name	Description
armor	The player's equipped helmet, breastplate, leggings, and boots
offhand	The item held in the player's off-hand
hotbar	Items in the player's hotbar
inventory	Items in the player's main inventory, excluding the options above
cursed	Items in the player's inventory that are enchanted with Curse of Vanishing
experience	The player's experience

Subcommands

View All Preferences

To view a list of your current preferences, run /kip.

View Individual Preference

To view whether you have selected a specific preference, run /kip <preference>.

Keep Everything on Death

To keep everything in your inventory on death, run /kip everything.

Clear All Preferences

To clear your preferences and drop everything on death, run /kip nothing.

Set a Specific Preference

To set a specific preference, run /kip <preference> <true | false>, where true indicates that you wish to keep the preferred items on death, and false indicates you wish to drop them.

Configuration

Keep It Personal can be configured in the config/keep_it_personal.toml file. If you are unfamiliar with TOML, it is highly recommended that you learn the specification for ease of configuration.

Disable Specific Preferences

If you want to disable a specific set of preferences from being used by anyone, you can use the preferences.disabled property. For example, the following
disables every preference but experience.

[preferences]
disabled = ['armor', 'offhand', 'hotbar', 'inventory', 'cursed']

Defaults

By default, no preferences are disabled.

Enable Specific Preferences

If you want a specific set of preferences to always be enabled, you can similarly use the preferences.enabled property. For example, the following forces armor and offhand to be enabled.

[preferences]
enabled = ['armor', 'offhand']

Defaults

By default, no preferences are enabled.

Permissions

This mod optionally supports fabric-permissions-api for command permissions. Each command can be controlled with a specific permission. The following table contains the full list of permissions.

Permission	Description
keep_it_personal.kip	View all the preferences they have selected
keep_it_personal.kip.<preference>	View and update a specific preference
keep_it_personal.kip.everything	Add every available preference to selected preferences
keep_it_personal.kip.nothing	Remove every available preference from selected preferences

Permission Configuration Properties

For servers which do not use fabric-permissions-api or also use OP permission levels, you may specify a default permission level for these commands. This is set as permissions.permissionLevel in the configuration file.

The permission level can be either a numeric or text value, with text being the preferred option.

Name	Text Value	Numeric Value
All	all	0
Moderators	moderators	1
Gamemasters	gamemasters	2
Admins	admins	3
Owners	owners	4

For example, to let players with the moderators permission level or above be able to use this command, you would specify the following in keep_it_personal.toml.

[permissions]
permissionLevel = 'moderators'

By default, the permission level is all. Note that the permission level overrides permissions set in the fabric-permissions-api.

Defaults

The default permission level is 0 which is given to every player. If you wish to control permissions with a permission
manager, you should update the permission level accordingly.

External Compatibility

Currently, support for other mods which extend the player inventory is unknown but likely unsupported. Support for Trinkets is currently in progress, however, and other mods may be supported in the future.