# Artificial Enchantments<\/p>\n
A shared plugin library for Paper 1.21+ servers that lets other plugins create **real, client-visible custom enchantments** \u2014 no lore hacks, no packet trickery.<\/p>\n
## What It Does<\/p>\n
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.<\/p>\n
**For players:** Enchantments show up natively in the client \u2014 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.<\/p>\n
**For server owners:** Install this once, and any plugin that depends on it Just Works\u2122. No conflicts, no duplicate listeners, no “why does my sword have 3 different lore-based sharpness enchantments” headaches.<\/p>\n
## Requirements<\/p>\n
– **Paper 1.21+** (Purpur and Folia supported)
\n– **Java 21+**<\/p>\n
## Installation<\/p>\n
1. Download the latest release from the **Files** tab on this page.
\n2. Drop `artificial-enchantments-x.x.x.jar` into your server’s `plugins\/` folder.
\n3. Start (or restart) your server.
\n4. Install any plugin that depends on Artificial Enchantments.<\/p>\n
That’s it. There is no configuration file \u2014 this is a library, not a plugin with commands or settings.<\/p>\n
## Why This Exists<\/p>\n
Most custom enchantment plugins before 1.21 used one of two approaches:<\/p>\n
– **Lore-based:** Fake enchantments stored in item lore. Looks janky, breaks constantly, incompatible with other plugins.
\n– **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.<\/p>\n
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.<\/p>\n
## Compatibility<\/p>\n
| Platform | Status |
\n|—|—|
\n| Paper | \u2705 Supported |
\n| Purpur | \u2705 Supported |
\n| Folia | \u2705 Supported |
\n| Spigot | \u274c Not supported (requires Paper 1.21+ API) |<\/p>\n
## For Plugin Developers<\/p>\n
If you’re building a plugin that uses Artificial Enchantments, check out the GitHub repository for:<\/p>\n
– API documentation
\n– Gradle\/Maven setup instructions
\n– Code examples
\n– Javadoc reference<\/p>\n
**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`.<\/p>\n
## Support<\/p>\n
– **Bug reports & feature requests:** GitHub Issues
\n– **Source code:** GitHub<\/p>\n
## License<\/p>\n
MIT License<\/p>\n","protected":false},"excerpt":{"rendered":"
centralized singleton enchantment managment api (folia comaptible)<\/p>\n","protected":false},"featured_media":20221,"template":"","meta":{"_minecraft_slug":"artificial-enchantments-api","_minecraft_project_id":"3r7G1rGR","_minecraft_author":"modpotato","_minecraft_license":"MIT","_minecraft_downloads":8,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"artificial-enchantments-api.zip","_minecraft_size_bytes":839218,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T12:17:12.438614Z","_minecraft_date_created":"2026-05-08T01:18:25.893133Z","_minecraft_date_modified":"2026-05-04T11:57:03.236275Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/artificial-enchantments-api","_minecraft_icon_attachment_id":20221,"_minecraft_imported_at":"2026-05-31T20:50:55+00:00","_minecraft_import_hash":"495444d2f52837d9884dcedda1073de0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,873,127,128],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-20220","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-library","mod_category-paper","mod_category-purpur","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n