Skip to main content
PerPlayerKit includes a set of optional safeguards designed to close common vectors for item duplication and kit abuse on competitive PvP servers. All four flags default to false so they never interfere with a fresh installation — enable only the ones appropriate for your server’s rules and format.

​
Full Configuration Block

config.yml
anti-exploit:
  only-allow-kitroom-items: false
  import-filter: false
  block-spaces-in-commands: false
  prevent-shulkers-dropping-items: false

​
Configuration Reference

​
only-allow-kitroom-items
boolean
default:"false"
When true, players can only save items to their personal kits if those items already exist in the kit room. Any item not present in the kit room is silently rejected when a player tries to include it in a kit. This ensures that the kit room acts as the single authoritative source of approved gear.
​
import-filter
boolean
default:"false"
Extends only-allow-kitroom-items to cover the kit import button. When true, the import feature strips any items from the imported kit that are not present in the kit room before saving. This prevents players from duplicating unapproved items by importing kits that were saved before the restriction was in place.
import-filter has no effect unless only-allow-kitroom-items is also set to true. Enable both flags together to fully close the import duplication vector.
​
block-spaces-in-commands
boolean
default:"false"
When true, the plugin rejects commands that contain space characters in positions where they could be used to bypass command-filter checks. Enable this if players on your server have found ways to circumvent word-based command restrictions by inserting spaces into arguments.
​
prevent-shulkers-dropping-items
boolean
default:"false"
When true, shulker boxes managed by PerPlayerKit (such as regear shulkers) will not drop their contents when broken. This is primarily an anti-lag measure — it stops players from littering the ground with items by rapidly breaking regear shulkers, which can cause significant entity lag on busy servers.
Enable only-allow-kitroom-items (and import-filter) on any server where kit fairness matters — ranked PvP, tournament play, or any format with a controlled item pool. Restricting kits to kit-room items makes it trivially easy for staff to audit and update the approved gear list in one place.
1

Populate the kit room

Add every item you want to allow in player kits to the kit room. This becomes the approved item list.
2

Enable the restriction

Set both only-allow-kitroom-items: true and import-filter: true in config.yml, then reload the plugin with /ppk reload.
3

Test with a player account

Try saving a kit that contains a non-kit-room item to confirm it is rejected. Then verify that a kit containing only approved items saves successfully.
If players report that items are mysteriously disappearing from their kits after you change settings, only-allow-kitroom-items or import-filter is the most likely cause. Check that every item those players use is present in the kit room. Items removed from the kit room after kits have been saved will be filtered out the next time a player loads or re-saves their kit.