Перейти к содержимому
Mineforgian

KeepInventory Individual

A plugin that makes KeepInventory individual to players.

Загрузки
5K
Подписчики
17
Обновлён
24 февраля 2025 г.
Лицензия
GPL-3.0-only

Опубликован 17 декабря 2023 г.

About 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

Commands

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.

Permissions 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

Configs

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: false

messages.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.'

Support

You don't know how to set something up or found some issues?

You can reach out to me here:

Ченджлог

1.6.1Релиз1.21.2, 1.21.3, 1.21.4 · 24 февраля 2025 г.

  • Fixed an error where the plugin does not create a directory folder before making config files.
1.6Релиз1.20, 1.21 · 25 января 2025 г.

  • 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

1.5.1Релиз1.21.2, 1.21.3, 1.21.4 · 14 декабря 2024 г.

  • Removed an old permission check that prevented players from using the commands, despite having assigned the right permissions.
1.5Релиз1.20, 1.21 · 28 ноября 2024 г.

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!

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.

1.4.3Релиз1.21.1, 1.21.2, 1.21.3 · 23 ноября 2024 г.

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

1.4.2Релиз1.20.3, 1.20.4, 1.21 · 17 апреля 2024 г.

  • Fixed typo in response to already having KeepInventory disabled.
1.4.1Релиз1.20.2, 1.20.3, 1.20.4 · 13 апреля 2024 г.

  • Fixed PlayerDeathEvent error preventing players from keeping their inventory.
1.4Релиз1.20.2, 1.20.3, 1.20.4 · 4 апреля 2024 г.

  • 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.

Комментарии

Загружаем…