Check an ItemsAdder consumable before distributing it to players

Applies to: ItemsAdder; match the linked maintainer documentation to your installed platform and release.
Documentation checked 9 November 2026.

A custom food or drink can display correctly while consuming the wrong amount or applying an unintended effect. Test its behaviour with disposable items and an ordinary account.

Check the installed content

ItemsAdder content uses namespaced identifiers for items and other assets. A definition, its generated resource pack and the copy downloaded by a player are different checkpoints. Keep content IDs stable and consult the documentation matching your ItemsAdder and Minecraft releases.

Work through the change

1. Copy the consumable definition to a staging ID and record the intended stack size, consumption result and effect. Consult the installed Minecraft and ItemsAdder component requirements.
2. Start with one supported consumable behaviour and omit command rewards or chained actions. Obtain a small number of test items rather than adding the item to live shops.
3. Consume the item while hungry and under the other conditions the design allows. Check the remaining stack, returned container and any effect duration.
4. Repeat after relogging and after a normal staging restart. Compare a fresh copy with one obtained before the definition change to identify updater differences.

Verify the result

The player should consume the intended quantity and receive only the planned effect or return item. The action should not leave a reusable reward loop or duplicate containers.

If the result differs

If the appearance works but use does not, inspect behaviour or component loading errors rather than pack delivery. If only older copies differ, check the release-supported item update policy before replacing player inventory.

Keep a recovery path

Restore the previous consumable definition and withdraw the staging item from test rewards. Record any test copies already distributed; a configuration rollback does not reverse effects or remove consumables from inventories.

References and related help

Check the maintainer reference: ItemsAdder documentation, ItemsAdder documentation.

Before changing live data, read how to keep a completed recovery copy. For startup errors, use the log collection guide.