Better Keep Inventory

Better Keep Inventory

Better Keep Inventory is a plugin that builds more functionality on top of the "Keep Inventory" gamerule idea. The gamerule is very limited with the only configuration available is enabling/disabling it and having it work in specific worlds. This plugin can handle those scenarios for you and more! Per world configuration and keeping your inventory in specific scenarios such as natural deaths, mob deaths or player deaths. Whether your items are kept or dropped for whatever reason is up to you!

Features

• Per world configuration
• Permissions
• Reloadable config without restarting the server
• Keep/Drop on PVP, Natural or Mob caused death!
• Paper and Sponge support

Planned

• Configurable message on keep inventory
• Drop/keep only certain items
• Limited keep inventory uses per specified time/lifetime

Usage

Just install the plugin to your plugins folder for your platform (Paper or Sponge)

A player death is classified as a player other than yourself causing your death, whether it be from a sword, arrow, or hitting off a cliff. As long as Minecraft classifies it as being killed by another player it is labelled a player death in the plugin.

A natural death is when you die from starvation, fall damage, drowning, or from the void. It should cover death from the /kill command too.

A mob death is when you are killed by a hostile mob, creeper, skeleton, spider etc.

Commands

There is one command /betterkeepinventory reload which reloads the config file and applies the changes made. It requires the permission betterkeepinventory.commands. You can also run /bki reload for short.

Permissions

By default, every player will have the keep inventory functionality enabled. To only give it to specific people you can set the option require-permission to true and give only the players you want to have the keep inventory ability the permission betterkeepinventory.keep. To do that you will need a permission plugin like LuckPerms.

Configuration

The Paper plugin uses a .yml file for configuration and the Sponge plugin uses a .json file. For world specific settings the Sponge config needs the full world name such as minecraft:overworld. Default world names are also different between Paper and Sponge

# NOTE: DO NOT HAVE THE KEEP INVENTORY GAMERULE ENABLED WITH THIS PLUGIN

# Global default settings that affect all worlds. Set all of them to false for vanilla functionality (No keep inventory)

# "keep" refers to what should be kept when the player dies which is not configurable

# Should the permission "betterkeepinventory.keep" be required for a player to "keep" on death
# If false everyone will "keep"
require-permission: false
# Should the player "keep" when killed by another player
keep-on-player-death: false
# Should the player "keep" on a natural death. Fall damage, starving, drowning etc
keep-on-natural-death: true
# Should the player "keep" when killed by a mob
keep-on-mob-death: true
# Should the player "keep" if they commited suicide. With arrows, end crystal etc
keep-on-suicide: false

# "keep" settings

# When the player dies should their inventory be kept
keep-inventory-items-on-death: true
# When the player dies should their EXP level be kept.
# The higher level you are the more EXP needed to level up so dying with 10 levels and 50% keep EXP will not respawn the player with 5 levels
# The value can also be a number from 0 to 1, with 1 meaning that all EXP is kept and 0 is none
# 0.5 - Keeps only half the EXP
keep-exp-on-death: 1.0

# World specific settings. These will override the above global settings for the specified world
worlds:
  # The name of the world
  world:
    # Should these settings override the global ones. Set to false to disable the override
    enabled: false
    require-permission: false
    keep-on-killed-by-player: false
    keep-on-natural-death: true
    keep-on-mob-death: true
    keep-inventory-items-on-death: true
    keep-exp-on-death: 0.5
  world_nether:
    enabled: false
    require-permission: true
    keep-on-killed-by-player: false
    keep-inventory-items-on-death: true
    keep-exp-on-death: 1.0
    # The "keep-on-natural-death" and "keep-on-mob-death" options have been left out. These two will default to the global
    # defaults set at the top of the file while the other settings that are specified will have whatever option is set
    # above inside the world section

require-permission: false
keep-on-player-death: false
keep-on-natural-death: false
keep-on-mob-death: false
keep-on-suicide: false
keep-inventory-items-on-death: true
keep-exp-on-death: 1.0

worlds:
  world_nether:
    enabled: true
    require-permission: false
    keep-on-killed-by-player: true
    keep-on-natural-death: true
    keep-on-mob-death: true
    keep-on-suicide: false
    keep-inventory-items-on-death: true
    keep-exp-on-death: 1.0

Support

Support can be provided on my discord server or you can report any bugs on the GitHub repository here