Check enchantment group selection in a random-book reward

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

A random-book reward should draw from the intended group, not every available enchantment. Test the distribution path with disposable books before connecting it to a public crate or shop.

Check the installed content

AdvancedEnchantments separates enchantment definitions, groups, book presentation and permissions. Keep test equipment away from player inventories until both application and activation work. Use the reference for your installed plugin version instead of assuming a configuration from another server will match.

Work through the change

1. Record the reward command and intended group identifier. Compare that identifier with the installed group definitions and the current command reference.
2. Run the documented random-book workflow on staging with a small quantity and a fixed test recipient. Keep valuable currency charges and public announcements disabled for the trial.
3. Inspect each issued book for group and valid enchantment level. Check that the intended group actually contains eligible enchantments rather than relying only on its display colour.
4. Repeat through the real reward integration with an ordinary test player. Compare its command substitution and quantity with the successful direct test, then test the unavailable-group case safely.

Verify the result

Every issued book should belong to the selected group and reach the correct player in the correct quantity. A missing group should produce a diagnosable error instead of granting an unintended reward.

If the result differs

If direct issuance works but the crate fails, inspect its placeholders, quoting and execution context. If the wrong group is used in both paths, correct the group reference before changing randomisation or reward prices.

Keep a recovery path

Restore the original reward action and keep the new group out of public distribution until the trial passes. Remove disposable books and record any real reward already issued; rollback cannot recover sold or applied books.

References and related help

Check the maintainer reference: AdvancedEnchantments documentation, AdvancedEnchantments documentation.

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