Enchantment Creator

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.
  • Download Releases — Get the latest JARs.

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.

Quick Start

• 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.