KeepInventory Individual allows you to set KeepInventory for players individually.
This plugin supports MySQL, so that it can save the list of players with KeepInventory enabled, into the Database.
If MySQL is disabled, or no connection is established to it, then the plugin will temporarely store the list into a YAML file, until the connection to a MySQL database is established.
Once connection is established, the plugin will then move the list from the YAML file into the database automatically.
You can also blacklist certain death causes, if you do not want the player to keep their inventory for falling into the void for example. More info about it in the Configs section.
This plugin also has an API, allowing you to use some of it's features in your own projects! Learn more
Usage: /keepinventory <on/off/reload> (player)
The command itself can only be used by opped players, or players with the appropriate permissions assigned to them. | Command|Description |:----------------------------:|:----------------------------:| | /keepinventory on (player)| Enables KeepInventory for you or the player mentioned.| | /keepinventory off (player)| Disables KeepInventory for you or the player mentioned.| | /keepinventory reload| Reloads the config files.| | /keepinventory list | Shows a list of players with KeepInventory enabled.| | /keepinventory help | Shows a list of commands for this plugin.|
These are the permission nodes used for the commands.
|Permission|Usage|Default|
|:----------:|:-----:|:------:|
|ki.admin.cmd.on|Used for /keepinventory on|Opped Players|
|ki.admin.cmd.off|Used for /keepinventory off|Opped Players|
|ki.admin.cmd.other|Used for /keepinventory on/off (Player)|Opped Players|
|ki.admin.cmd.reload|Used for /keepinventory reload|Opped Players|
|ki.admin.cmd.list|Used for /keepinventory list|Opped Players|
|ki.admin.cmd.help|Used for /keepinventory help|Opped Players|
|ki.keepxp|Players with this permission will keep their experience upon death.|Opped Players|
|ki.onjoin.on|Players will have KeepInventory enabled by default as soon as they join. Blacklisted worlds will cancel it.|Opped Players|
|ki.onjoin.off|Players will have KeepInventory disabled by default as soon as they join.|Opped Players|
config.yml
# NOTE: When using the blacklist, please make sure to write the causes in caps like this:
# blacklist:
# - VOID
# - EXPLOSION
# ----------------------------------------------------------------------------------------
# If you want to leave the list empty, please enter the list like this:
# blacklist: []
# ----------------------------------------------------------------------------------------
# You can find a list of all damage causes here:
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityDamageEvent.DamageCause.html
# ----------------------------------------------------------------------------------------
world-blacklist:
enabled: false
blacklist: []
deathcause-blacklist:
enabled: false
blacklist: []
mysql:
enabled: false
host: HOST NAME
port: PORT
database: DATABASE NAME
user: USERNAME
password: PASSWORD
debug:
send-on-join-notification: false
enabled: falsemessages.yml
info:
on-join:
enabled: '&7KeepInventory has been enabled for you by default!'
disabled: '&7KeepInventory has been disabled for you by default!'
blacklisted: '&7KeepInventory disabled, because you''re in a blacklisted world!'
enabled: '&7Successfully enabled KeepInventory for &e{player}&7!'
disabled: '&7Successfully disabled KeepInventory for &e{player}&7!'
reload:
process: '&7Reloading configurations...'
success: '&7Configurations were successfully reloaded!'
error:
no-permission: '&cYou do not have permission to use this command!'
no-such-player: '&cPlayer &e{player} &cdoes not exist.'
invalid-arguments: '&cInvalid arguments. Usage: &e/keepinventory <on/off/reload>
(player)'
not-enough-arguments: '&cNot enough arguments. Usage: &e/keepinventory <on/off/reload>
(player)'
already-enabled: '&cIt is already enabled for &e{player} &c.'
already-disabled: '&cIt is already disabled for &e{player}.'
empty-list: '&cThe list is empty.'
must-be-number: '&cThe argument must be a number!'
page-out-of-bounds: '&cThe list only goes up to {number} pages.'You don't know how to set something up or found some issues?
You can reach out to me here:
All Versions
+ Add Version- Fixed an error where the plugin does not create a directory folder before making config files.
- Changed prefix from being hardcoded to becoming a setting in messages.yml
- Internal messaging and logging overhaul for optimizations
- Updated help command list a bit
- Removed an old permission check that prevented players from using the commands, despite having assigned the right permissions.
### Added new permission nodes **ki.onjoin.on** and **ki.onjoin.off**
If the player joins the server and has either one of the permission nodes mentioned above, it'll automatically have KeepInventory enabled or disabled.
Blacklisted worlds will still prevent the player from having KeepInventory enabled.
### Added new config option **debug.send-on-join-notification**
By default, this config option is set to "false", but if enabled, it'll send the joining player a message about KeepInventory being enabled or disabled for them.
### Added three new messages for the on-join notifications
### Now introducing: **KeepInvAPI**
You can now use KeepInventory Individual inside your project's library!
Right now, it only lets you enable and disable KeepInventory for the specified player. [More info on the wiki](https://app.gitbook.com/o/TALdBMlyaTMjSl1ZY9nI/s/COFyNCzAUI6kydlC9reh/keepinvapi)!
As always, please don't hesitate reaching out to me, if you got any questions or if something is not working right.
And remember, please do not use the review section to seek support.
It's been a while, but I have finally returned with some important fixes!
- Fixed the world-blacklist and the deathcause-blacklist from detecting blacklisted events.
- Various code optimizations
- Fixed PlayerDeathEvent error preventing players from keeping their inventory.
- Added new config option debug.enabled, which prints debug messages of the plugin's behaviour into the server console.
- Reduced messages with ".self" and ".other" into it's own messages.*
- Various code optimizations
- Added api-version to plugin.yml to prevent legacy mode.
- I highly suggest removing those lines in the messages.yml and use the reload command in-game / restart the server to have the new changes.
- Added command argument "list" (ki.admin.cmd.list) to get a list of players who have KeepInventory enabled.
- Added command argument "help" (ki.admin.cmd.help) to get a list of commands for this plugin.
- Added permission node "ki.keepxp" (default to op players) to prevent players from losing their experience levels upon death.
- Various code optimizations were done for better plugin performance.
- Added "World Blacklist" Config Option. This option will prevent players from keeping their inventory if they're in a blacklisted world.
