Enchantment Creator

Official compatibility

Element	Reference
TypeWriter	Required. Use the official TypeWriter release supported by the extension release.
Related extensions	Install the related extensions listed on this page before using entries that depend on them.

The Enchantment Creator Extension gives you full control over enchanting mechanics. Design entirely new enchantments with custom lore, or restrict the availability of existing vanilla enchantments.

• Source Code — View source on GitHub.

Features

• Custom Enchantments — Create enchantments with unique names and configurable max levels.
  • Lore Integration — Auto-managed lore lines with color formatting.
  • Vanilla Blacklisting — Prevent specific vanilla enchantments from appearing.
  • Enchanted Books — Generate and distribute custom enchantment books.
  • World Integration — Books appear in loot chests (treasureChance) and librarian trades (tradeChance).
  • Slots & Exclusivities — Configurable active slots per definition and anvil-enforced incompatibilities (exclusiveWith).

Entries

• Definitions — Enchantment Definition: Standard custom enchantment with cooldown triggers. Custom Enchantment Definition: Modular enchantment with mechanics system. Blacklist: Ban vanilla enchantments from tables.
  • Systems — Enchantment Events: Available game events that trigger mechanics. Enchantment Mechanic: Modular mechanic composition system. Command Manifest: /enchantcreator give admin command.
  • Actions — Give Book: Grant a custom enchanted book. Harvest: AOE crop harvest with replant. Bow: 14 arrow-based effects. Combat: 14 melee effects. Armor: 15 defense effects. Tools: 15 tool/mining effects. Special: 10 utility effects.

User guide

• 1. Define — Add definition entries: enchantment_definition, vanilla_enchantment_blacklist_definition. These define the structures, entities, or rules the extension operates on. → enchantment_definition → vanilla_enchantment_blacklist_definition
• 2. Trigger Actions — Use action entries to interact with the extension: give_enchantment_book. Trigger them from commands, NPCs, events, or other entries. → give_enchantment_book

Technical Details

This extension requires the official Basic extension for core mechanics.

Compatibility matrix

Artifact	Engine	Server	Java	BTC-CORE / BTC Velocity	Folia
Public	Official Typewriter	Paper 1.21.x	Runtime Java 21; build JDK 25 with Java 21 bytecode	No	No
Custom	BORNTOCRAFT-Typewriter	BTC Paper/Folia stack	Java 25	Yes	Yes

The public artifact deliberately has no BTC-CORE or BTC Velocity dependency. The custom artifact keeps its BTC adapters and regional scheduling separately. Both artifacts use the same Typewriter page model. Registry keys are based on id; the previous name is retained as a legacy alias when loading existing pages and items.

Troubleshooting

The extension is not visible

Check that the installed release matches the supported TypeWriter release and that the related extensions listed in the compatibility section are present.

An entry is missing

In the Typewriter Web panel, use the Search bar or the + button to find or create the entry with its exact identifier. Entry IDs and field names are case-sensitive; do not translate them.

The entry saves but nothing happens

Check that the entry is connected to the trigger, command, objective, event, or menu interaction required by its type. Test with optional permissions and criteria removed, then add them back one at a time.

An integration does not work

Verify the dependency and version shown in the extension card, then check the server log for the first error. Do not replace a missing dependency with a similarly named plugin unless the extension source explicitly supports it.