Fix an AdvancedEnchantments book assigned to a missing group

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

A book can be misclassified when its enchantment points to a group that is absent or named differently. Follow the reference from enchantment to group before editing shop prices.

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 affected enchantment ID and the group value in its definition. Back up the enchantment and group files together so the relationship can be restored.
2. Find the matching group in groups.yml, using the exact identifier expected by the installed release. Compare case and spelling rather than only the visible colour or display label.
3. Correct the relationship on staging without changing the enchantment ID or existing equipment. Obtain a disposable fresh book through the documented administrator workflow.
4. Compare the new book in the intended menu and application interface. Test with an ordinary account and check any shop or reward integration that selects books by group.

Verify the result

The book should use the intended existing group and remain available through the correct distribution path. Other groups should retain their display and selection behaviour.

If the result differs

If its group looks correct but the shop fails, inspect the shop integration separately. If only old books differ, check their stored data and the release-supported update behaviour before reissuing equipment.

Keep a recovery path

Restore both saved files if the relationship remains uncertain. Keep test books out of the live economy; a group configuration rollback does not remove previously distributed books or undo applications.

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.