Artificial Enchantments API
I don't know my version or loader
Artificial Enchantments
A shared plugin library for Paper 1.21+ servers that lets other plugins create real, client-visible custom enchantments — no lore hacks, no packet trickery.
What It Does
Artificial Enchantments is a server-side library that multiple plugins can depend on simultaneously. Instead of every enchantment plugin shipping its own (conflicting) enchantment system, they all hook into this one shared registry.
For players: Enchantments show up natively in the client — you see them in item tooltips, anvil interfaces, and the enchantment table. They look and feel like vanilla enchantments because they are registered in the native Paper registry.
For server owners: Install this once, and any plugin that depends on it Just Works™. No conflicts, no duplicate listeners, no "why does my sword have 3 different lore-based sharpness enchantments" headaches.
Requirements
- Paper 1.21+ (Purpur and Folia supported)
- Java 21+
Installation
- Download the latest release from the Files tab on this page.
- Drop
artificial-enchantments-x.x.x.jarinto your server'splugins/folder. - Start (or restart) your server.
- Install any plugin that depends on Artificial Enchantments.
That's it. There is no configuration file — this is a library, not a plugin with commands or settings.
Why This Exists
Most custom enchantment plugins before 1.21 used one of two approaches:
- Lore-based: Fake enchantments stored in item lore. Looks janky, breaks constantly, incompatible with other plugins.
- Shaded registries: Each plugin ships its own copy of an enchantment library. They conflict with each other, duplicate event listeners, and corrupt each other's state.
Artificial Enchantments solves this by sitting between the server and enchantment plugins as a single, shared authority. Every plugin that uses it talks to the same registry, the same event dispatch spine, and the same native Paper enchantment system.
Compatibility
| Platform | Status |
|---|---|
| Paper | ✅ Supported |
| Purpur | ✅ Supported |
| Folia | ✅ Supported |
| Spigot | ❌ Not supported (requires Paper 1.21+ API) |
For Plugin Developers
If you're building a plugin that uses Artificial Enchantments, check out the GitHub repository for:
- API documentation
- Gradle/Maven setup instructions
- Code examples
- Javadoc reference
Do not shade this library into your plugin. It must remain a separate plugin JAR in the plugins/ folder. Every dependent plugin references it via compileOnly.
Support
- Bug reports & feature requests: GitHub Issues
- Source code: GitHub
License
MIT License
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as artificial-enchantments-1.1.0.jar — drop this file into the mods folder
- Download size: 455 KB
- Download link checked 23 Aug 2026 — working
These come from our own check of the pack file, not from the source page.