Artificial Enchantments API

插件

· 作者 modpotato

集中式单体附魔管理 API(兼容 Folia)

0 本站下载 0 关注 更新于 6 个月前

最新 v1.1.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

Artificial Enchantments

一个适用于 Paper 1.21+ 服务器的共享插件库,允许其他插件创建真实的、客户端可见的自定义附魔——无需使用 Lore hack,也无需进行数据包操作。

功能说明

Artificial Enchantments 是一个服务端库,允许多个插件同时依赖它。与其让每个附魔插件都自带一套(且相互冲突的)附魔系统,不如让它们全部接入这个共享注册表。

对于玩家: 附魔会原生显示在客户端中——你可以在物品提示框、铁砧界面以及附魔台界面看到它们。因为它们注册在了原生的 Paper 注册表中,所以它们的视觉效果和操作手感都与原版附魔一致。

对于服务器管理员: 只需安装一次,任何依赖此库的插件即可直接运行™。没有冲突,没有重复的事件监听器,也没有“为什么我的剑上有 3 种基于 Lore 的不同锋利度附魔”这种令人头疼的问题。

要求

  • Paper 1.21+(支持 Purpur 和 Folia)
  • Java 21+

安装方法

  1. 从本页面顶部的 Files 选项卡下载最新版本。
  2. 将 artificial-enchantments-x.x.x.jar 放入服务器目录下的 plugins/ 文件夹中。
  3. 启动(或重启)服务器。
  4. 安装任何依赖于 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源