原创 开源 FotiaEnchantment - 高自由度自定义附魔系统-Folia支持 1.1.17

[MD] # 【1.21.x】FotiaEnchantment - 让 AI 帮你写新附魔的配置驱动附魔插件 > 适用服务端：Paper / Leaf / Folia > 适用版本：Minecraft 1.21.x > Java 版本：Java 21 > 开源协议：MIT > GitHub：https://github.com/Ti-Avanti/FotiaEnchantment > WIKI：wiki.fotia.gg --- # 加插件交流 QQ 群：767608887 **想自己写新附魔，但不会写配置？** 加入插件交流 QQ 群 **767608887**，可以获取插件专用的 **VIBEDOC**。 VIBEDOC 是给 AI 看的附魔写法教程。你可以把它发给 ChatGPT、Codex、Claude 等 AI，然后用自然语言描述你想要的附魔，AI 就能按 FotiaEnchantment 的格式帮你生成： - 附魔 YAML 配置 - 中文语言条目 - 英文语言条目 - 概率、等级、持续时间、范围等动态描述 - 适合放入项目的文件路径 例如你只需要告诉 AI： ```text 帮我写一个护甲附魔：受到攻击时有 10%~18% 概率恢复生命并获得抗性提升，等级越高效果越强。 ``` AI 就可以根据 VIBEDOC 输出对应的附魔配置和语言文件。 **插件交流 QQ 群：767608887** --- ## 插件简介 FotiaEnchantment 是一个面向 Paper / Leaf 服务端的配置驱动附魔插件。 它不是简单地给物品加几行 lore，而是把附魔的触发器、条件、效果、语言、GUI、附魔书、附魔台、祛魔、魔典、图鉴等内容做成一套完整的可配置系统。 服主可以通过 YAML 文件扩展自己的附魔玩法；如果不熟悉配置，还可以使用群内提供的 VIBEDOC，让 AI 帮你生成新附魔。 适合想做 RPG 生存、装备成长、职业玩法、副本掉落、随机附魔书、特殊工具附魔、护甲套装成长等玩法的服务器。 --- ## 最吸引人的地方：AI 写附魔 传统自定义附魔插件的问题是： 配置项多、触发器多、效果多，服主想做一个新附魔，经常要翻文档、对格式、查参数。 FotiaEnchantment 提供了一份专门给 AI 读取的 **VIBEDOC**，让 AI 学会插件的附魔写法。 你可以这样使用： 1. 加入 QQ 群 **767608887** 获取 VIBEDOC。 2. 把 VIBEDOC 发给 AI。 3. 告诉 AI 你想要什么附魔。 4. AI 生成附魔配置和语言条目。 5. 放入插件目录，执行 `/fe reload`。 这意味着服主不需要每次都自己查配置格式，也不需要改 Java 代码，就能快速扩展服务器附魔内容。 --- ## 核心功能 ### 1. 配置驱动附魔 每个附魔都是独立 YAML 文件，可以配置： - 附魔名称和多语言描述 - 最大等级 - 品质颜色 - 附魔类型 - 可用物品 - 冲突附魔 - 附魔台权重 - 获取方式 - 触发器 - 条件 - 效果 - 冷却时间 - 概率 - 持续时间 - 范围和数值公式 数值支持随等级变化，例如概率、回血、伤害、范围、药水等级、持续时间都可以根据附魔等级动态计算。 --- ### 2. 触发器 / 条件 / 效果管线 附魔不只是固定触发一次效果，而是通过一套管线运行： ```text 玩家事件 -> 找到装备附魔 -> 匹配触发器 -> 检查条件 -> 执行效果 ``` 可以实现的玩法包括： - 攻击时追加伤害 - 受伤时概率回血 - 连杀时获得增益 - 挖矿时连锁挖掘 - 掉落物翻倍 - 自动熔炼 - 受到火焰伤害时触发抗性 - 移动、跳跃、疾跑、水中、低血量等状态触发 这些都可以通过配置组合，不需要改源码。 --- ### 3. AI 友好的动态附魔描述 插件会根据附魔效果配置生成更详细的附魔书和物品 lore。 例如一个 5 级附魔可以显示成： ```text 韧性 V - 5级：有 18% 概率恢复 40% 生命并获得抗性提升 II，持续 8 秒。 ``` 如果附魔有概率，就应该在配置里写 `chance` 条件；插件会把概率、持续时间、范围、等级等数值计算后显示给玩家，而不是只显示一句模糊描述。 这也是 VIBEDOC 的重点：让 AI 写出的附魔配置能被插件正确解析和展示。 --- ### 4. 附魔台深度接入 自定义附魔可以进入原版附魔台结果。 玩家可以通过原版附魔台自然获得自定义附魔，而不是只能靠命令或特殊商店发放。 插件已经处理： - 附魔台预览和实际结果同步 - 自定义附魔额外抽取 - 原版附魔与自定义附魔混合显示 - 物品附魔数量上限 - 冲突附魔限制 --- ### 5. 统一的客户端 Lore 显示 安装 PacketEvents 后，插件可以重写客户端看到的附魔 lore。 支持： - 隐藏原版默认附魔行 - 按插件格式显示附魔名 - 按稀有度显示不同颜色 - 诅咒类附魔显示红色 - 显示详细动态效果描述 - 原版附魔也可以接管显示说明 这样物品展示不会出现“原版附魔行 + 插件 lore 重复堆叠”的混乱效果。 > PacketEvents 是可选依赖。没有安装时插件仍可运行，但客户端附魔显示接管能力会受限。 --- ### 6. 完整 GUI 系统 插件内置多个 GUI，并且都可以通过 `gui/*.yml` 自定义布局和物品外观。 目前包含： - 附魔图鉴 GUI - 管理员附魔管理 GUI - 碎片合成 GUI - 魔典开启 GUI - 祛魔 GUI GUI 使用类似 TrMenu 的字符布局： ```yaml layout: - "#########" - "#AAAAAAA#" - "#AAAAAAA#" - "#P##I##N#" roles: enchantment: A previous-page: P info: I next-page: N ``` 服主可以清楚地调整槽位、按钮、背景、模型数据、物品名和 lore。 --- ### 7. 附魔图鉴 玩家可以使用： ```text /fe gui ``` 打开附魔图鉴，查看服务器内的附魔： - 附魔名称 - 品质 - 类型 - 分组 - 等级上限 - 适用物品 - 详细效果说明 玩家不需要翻外部文档，就能在游戏内了解附魔内容。 --- ### 8. 管理员 GUI 管理员可以使用： ```text /fe gui admin ``` 打开附魔管理界面。 支持： - 查看全部附魔 - 按分类筛选 - 点击启用 / 禁用附魔 - 快捷获得附魔书 - 查看附魔说明 - 配置 reload 后保持禁用状态 适合测试附魔、调试配置和日常维护。 --- ### 9. 魔典、碎片和祛魔玩法 插件内置自定义物品玩法： - 星辉残页 - 星芒魔典 - 祛魔晶石 玩家可以： - 收集碎片 - 合成魔典 - 开启魔典获得随机附魔书 - 使用祛魔晶石拆卸物品上的附魔 这些物品的名称、lore、品质、GUI 和外观也可以配置。 --- ### 10. 多语言支持 插件内置多语言目录： - `zh_cn` - `zh_tw` - `en_us` - `ja_jp` - `ko_kr` 如果玩家客户端语言没有对应语言文件，插件会回退到默认语言，避免完全无法显示文本。 --- ## 常用命令 | 命令 | 说明 | | --- | --- | | `/fe gui` | 打开玩家附魔图鉴 | | `/fe gui admin` | 打开管理员附魔管理界面 | | `/fe list [category] [page]` | 查看附魔列表 | | `/fe info <enchant_id>` | 查看附魔详情 | | `/fe enchant <enchant_id> <level>` | 给手持物品附魔 | | `/fe give <player> <enchant_id> <level>` | 给玩家手持物品附魔 | | `/fe giveitem <player> <item_type> [amount] [rarity]` | 发放插件自定义物品 | | `/fe reload` | 重载配置 | 命令支持 Tab 补全。 --- ## 适合哪些服务器？ FotiaEnchantment 适合： - RPG 生存服 - 魔法附魔服 - 装备成长服 - 副本服 - 职业服 - 随机附魔书玩法服务器 - 想让 AI 帮忙扩展附魔内容的服务器 - 想替代简单 lore 附魔插件的服务器 如果你的服务器需要一个“可配置、可扩展、可维护，还能让 AI 辅助写附魔”的系统，可以尝试使用 FotiaEnchantment。 --- ## 运行环境 - Java 21 - Minecraft 1.21.x - Paper / Leaf 可选依赖： - PacketEvents - PlaceholderAPI - WorldGuard - AuraSkills - mcMMO - MythicMobs - CraftEngine --- ## 下载与开源 GitHub 仓库： https://github.com/Ti-Avanti/FotiaEnchantment 最新 Release： https://github.com/Ti-Avanti/FotiaEnchantment/releases/latest 开源协议：MIT --- ## 安装方式 1. 下载最新版本 `FotiaEnchantment-*.jar` 2. 放入服务器 `plugins/` 文件夹 3. 启动服务器生成配置文件 4. 按需求修改配置 5. 使用 `/fe reload` 重载插件 --- # 再强调一次：加群获取 VIBEDOC，让 AI 帮你写新附魔 如果你想要： - AI 帮你写附魔配置 - 获取 VIBEDOC - 交流附魔写法 - 反馈 Bug - 提交建议 - 获取使用帮助 请加入插件交流 QQ 群： # 767608887 [/MD]