Artificial Enchantments
一个适用于 Paper 1.21+ 服务器的共享插件库,允许其他插件创建真实的、客户端可见的自定义附魔——无需使用 Lore hack,也无需进行数据包操作。
功能说明
Artificial Enchantments 是一个服务端库,允许多个插件同时依赖它。与其让每个附魔插件都自带一套(且相互冲突的)附魔系统,不如让它们全部接入这个共享注册表。
对于玩家: 附魔会原生显示在客户端中——你可以在物品提示框、铁砧界面以及附魔台界面看到它们。因为它们注册在了原生的 Paper 注册表中,所以它们的视觉效果和操作手感都与原版附魔一致。
对于服务器管理员: 只需安装一次,任何依赖此库的插件即可直接运行™。没有冲突,没有重复的事件监听器,也没有“为什么我的剑上有 3 种基于 Lore 的不同锋利度附魔”这种令人头疼的问题。
要求
- Paper 1.21+(支持 Purpur 和 Folia)
- Java 21+
安装方法
- 从本页面顶部的 Files 选项卡下载最新版本。
- 将
artificial-enchantments-x.x.x.jar 放入服务器目录下的 plugins/ 文件夹中。
- 启动(或重启)服务器。
- 安装任何依赖于 Artificial Enchantments 的插件。
就是这样。没有配置文件——这是一个库,而不是带有命令或设置的独立插件。
设计初衷
在 1.21 版本之前,大多数自定义附魔插件采用以下两种方法之一:
- Lore 方式: 将假附魔存储在物品描述文本中。看起来很粗糙,经常出错,且不兼容其他插件。
- 阴影注册表: 每个插件都自带一份附魔库副本。它们之间会产生冲突,导致事件监听器重复,并互相破坏状态。
Artificial Enchantments 通过在服务器和附魔插件之间充当单一的共享权威机构来解决这个问题。所有使用该库的插件都连接到同一个注册表、同一套事件分发核心以及同一套原生 Paper 附魔系统。
兼容性
| 平台 |
状态 |
| Paper |
✅ 支持 |
| Purpur |
✅ 支持 |
| Folia |
✅ 支持 |
| Spigot |
❌ 不支持(需要 Paper 1.21+ API) |
给插件开发者
如果您正在构建使用 Artificial Enchantments 的插件,请查看 GitHub 仓库 获取以下内容:
- API 文档
- Gradle/Maven 设置说明
- 代码示例
- Javadoc 参考
不要将此库阴影打包到您的插件中。 它必须作为独立的插件 JAR 保留在 plugins/ 文件夹中。每个依赖插件都通过 compileOnly 引用它。
支持
许可证
MIT License
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.jar into your server's plugins/ 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
License
MIT License
评论 0
登录后参与评分
还没有评论,来抢沙发吧