Remove an item from every kit

Deletes every copy of a or banned item from stored kits and enderchest kits.

/purgeitem <item> <all confirm|player ...>

Permission: perplayerkit.admin. Works in game and from the console.

For specific players

/purgeitem TNT PlayerOne PlayerTwo

Names or , online or not. An unresolvable name cancels the whole purge; a mistyped name is never quietly skipped.

/purgeitem TNT all confirm

confirm is required; without it the command prints a warning.

There is no undo.Take a backup or run /kitdata export playerkits before-purge first.

Scope	Detail
Inside containers	Shulker boxes of every color, plus chests, barrels, and dispensers stored as items. Bundles too, including containers inside them.
Every database	Behaves identically on SQLite, MySQL, PostgreSQL, Redis, and YAML.
All 99 slots	Every slot is scanned whatever `kits.max-slots` is set to. An item cannot hide in a slot you turned off.
Online players too	Kits held in memory are refreshed. Their next `/k1` uses the cleaned version.

Not touched	What to do instead
What players are currently holding	Only stored kits change. Live inventories are yours to handle.
The kit room	Edit it yourself in the kit room editor.
Public kits	Re-save them with `/savepublickit`.

Take a snapshot

/kitdata export playerkits before-purge

Stop the item coming back

Remove it from the kit room and enable item-filter with kit-room-only: true, or it returns when someone saves a kit holding it.

Test on one player

/purgeitem TNT PlayerOne

Check their kits before going wider.

Purge the server

/purgeitem TNT all confirm

Runs in the background; the console summary lists items removed, entries changed, deleted, and scanned.

A kit left empty is deleted. Only one purge runs at a time.