Better Keep Inventory

# Better Keep Inventory (https://img.shields.io/discord/810752039470235688?style=for-the-badge&logo=discord&label=Discord&labelColor=grey&color=green)](https://discord.imjustdoom.com) (https://img.shields.io/twitter/follow/ImJustDoom?style=for-the-badge&logo=x&label=Follow!&color=gray)](https://x.com/ImJustDoom) (https://img.shields.io/badge/Backers-%20?style=for-the-badge&logo=ko-fi&color=gray)](https://ko-fi.com/justdoom) (https://img.shields.io/github/stars/JustDoom/BetterKeepInventory?style=for-the-badge&logo=github)](https://github.com/JustDoom/BetterKeepInventory) 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 (https://luckperms.net/). ### 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 ```yml # 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