Skip to main content
Feature flags give you fine-grained control over how PerPlayerKit behaves on your server. Every flag lives under the feature key in config.yml and can be toggled independently — turn on automatic rekitting for a PvP server, add full-heal-on-kit-load for a casual experience, or strip all potion effects on respawn for a competitive environment, all without touching any other part of the plugin.

​
Full Configuration Block

config.yml
feature:
  set-health-on-kit-load: false
  set-hunger-on-kit-load: false
  set-saturation-on-kit-load: false
  remove-potion-effects-on-kit-load: false

  heal-on-enderchest-load: false
  feed-on-enderchest-load: false
  set-saturation-on-enderchest-load: false
  remove-potion-effects-on-enderchest-load: false

  rekit-on-respawn: true
  rekit-on-respawn-delay: 0
  rekit-on-kill: false

  broadcast-kit-messages: true
  broadcast-on-player-action: true

  send-update-message-on-join: true
  old-death-drops: false

​
Kit Loading

These flags fire whenever a player loads a kit or enderchest. Use them to standardise the player’s state at the moment gear is applied.
FlagDefaultDescription
set-health-on-kit-loadfalseRestores the player to full health when they load a kit.
set-hunger-on-kit-loadfalseFills the player’s hunger bar to maximum when they load a kit.
set-saturation-on-kit-loadfalseResets saturation to maximum when they load a kit.
remove-potion-effects-on-kit-loadfalseClears all active potion effects when they load a kit.
heal-on-enderchest-loadfalseRestores the player to full health when they load an enderchest.
feed-on-enderchest-loadfalseFills the hunger bar when they load an enderchest.
set-saturation-on-enderchest-loadfalseResets saturation when they load an enderchest.
remove-potion-effects-on-enderchest-loadfalseClears all active potion effects when they load an enderchest.

​
Automation

These flags control when PerPlayerKit automatically re-applies a player’s kit without requiring a manual command.

​
rekit-on-respawn

Set to true (the default) to have PerPlayerKit automatically load the player’s last-used kit the moment they respawn after death. This is the primary automation flag for PvP servers — players return to the action fully geared without any extra steps.
rekit-on-respawn-delay is measured in ticks, not seconds. There are 20 ticks per second, so a value of 40 equals a 2-second delay. Use a non-zero delay if another plugin (such as a spawn-protection or spawn-items plugin) also gives items on respawn and the two systems conflict.
config.yml
feature:
  rekit-on-respawn: true
  rekit-on-respawn-delay: 0   # set to e.g. 40 for a 2-second delay

​
rekit-on-kill

When enabled, the player who lands the killing blow automatically reloads their last-used kit. The simple boolean form enables it in every world:
config.yml
feature:
  rekit-on-kill: false

​
Advanced World Filtering

For more control, replace the boolean with the expanded object form to restrict or exclude specific worlds:
config.yml
feature:
  rekit-on-kill:
    enabled: false
    world-whitelist: []
    world-blacklist: []
The plugin resolves the active world based on the killer’s current world using this priority order:
1

Check the whitelist

If world-whitelist contains one or more world names, rekit-on-kill only activates in those worlds. The blacklist is ignored entirely.
2

Check the blacklist

If world-whitelist is empty but world-blacklist has entries, rekit-on-kill activates everywhere except the listed worlds.
3

Allow all worlds

If both lists are empty, rekit-on-kill activates in every world.
Example — enable only in dedicated arena worlds:
config.yml
feature:
  rekit-on-kill:
    enabled: true
    world-whitelist:
      - "pvp_arena"
      - "duel_world"
    world-blacklist: []
Example — enable everywhere except lobby and spawn:
config.yml
feature:
  rekit-on-kill:
    enabled: true
    world-whitelist: []
    world-blacklist:
      - "spawn"
      - "lobby"
If your existing config uses the old boolean form (rekit-on-kill: true), it will continue to work after a plugin update. PerPlayerKit will automatically add the new keys with default values — no manual migration is required.

​
Broadcast & Notifications

FlagDefaultDescription
broadcast-kit-messagestrueBroadcasts a server-wide message when a player loads a kit or enderchest (e.g. “Player loaded a kit”). Set to false to silence these specific announcements.
broadcast-on-player-actiontrueBroadcasts messages for other player actions such as copying a kit, repairing gear, or opening the kit room. This flag does not affect kit-loading messages — those are controlled by broadcast-kit-messages.
send-update-message-on-jointrueNotifies players with the perplayerkit.admin permission when a new version of PerPlayerKit is available. Disable this if you manage updates through a separate monitoring system.

​
Miscellaneous

FlagDefaultDescription
old-death-dropsfalseWhen true, items dropped on death fall in a tight cluster rather than scattering across the ground. Useful for servers where players want to quickly retrieve their gear after dying.