FotiaEnchantment - 面向 AI 的、基于配置的 Paper / Leaf 自定义附魔插件
服务端软件:Paper / Leaf
Minecraft 版本:1.21.x
Java 版本:Java 21
许可证:MIT
GitHub:
使用 AI 创建新附魔
如果你不熟悉编写附魔配置文件,可以从 GitHub 仓库下载 VIBEDOC.md 或 VIBEDOC.en.md。
VIBEDOC 是一份专为 AI 工具设计的指南,用于帮助其理解 FotiaEnchantment 的配置格式。你可以将其提供给 ChatGPT、Codex、Claude 或其他 AI 助手,然后用自然语言描述你想要的附魔效果。AI 可以生成可用于 FotiaEnchantment 的附魔 YAML 配置文件和语言条目。
例如:
“创建一个盔甲附魔,在受到攻击时有几率治疗玩家并赋予抗性提升效果。等级越高,效果越强。”
AI 可以根据 VIBEDOC 生成所需的配置文件。之后,将这些文件放入插件文件夹并运行 /fe reload。
FotiaEnchantment 是什么?
FotiaEnchantment 是一款面向 Paper 和 Leaf 服务端的、基于配置的自定义附魔插件。
它不仅仅是一个基于 Lore(物品描述)的简单附魔插件。FotiaEnchantment 提供了一套完整的可配置附魔系统,包括触发器、条件、效果、语言文件、GUI、附魔书、附魔台集成、反魔道具、法典玩法以及自定义附魔物品。
服务器管理员可以通过 YAML 文件创建和扩展自定义附魔,而无需修改 Java 代码。
面向 AI 的附魔创建
FotiaEnchantment 的主要理念之一是借助 AI 简化自定义附魔的创建过程。
该插件提供了专用的 VIBEDOC 指南,可供 ChatGPT、Codex、Claude 等 AI 工具读取。你可以用自然语言描述你想要的附魔,AI 可以生成:
- 附魔 YAML 配置
- 中文语言条目
- 英文语言条目
- 针对概率、等级、持续时间、范围和数值的动态描述
- 插件结构的建议文件路径
例如,你可以询问:
创建一个盔甲附魔,在受到攻击时有 10% 到 18% 的几率治疗玩家并赋予抗性提升效果。等级越高,效果越强。
随后,AI 可以根据插件格式生成有效的 FotiaEnchantment 配置和语言条目。
核心功能
基于配置的附魔
每个附魔都在其独立的 YAML 文件中定义。
你可以配置:
- 附魔名称和多语言描述
- 最高等级
- 稀有度和颜色
- 附魔类型和分组
- 支持的物品类型
- 冲突附魔
- 附魔台权重
- 获取方式
- 触发器
- 条件
- 效果
- 冷却时间
- 概率
- 持续时间
- 范围和数值公式
数值可以随附魔等级动态缩放,从而轻松创建基于进度的效果。
触发器 / 条件 / 效果流水线
附魔通过可配置的流水线执行:
玩家事件 -> 查找物品附魔 -> 匹配触发器 -> 检查条件 -> 运行效果
这允许你创建诸如以下游戏玩法:
- 攻击时额外伤害
- 受击时基于几率的治疗
- 击杀后的增益效果
- 矿脉挖掘
- 掉落倍增
- 自动熔炼
- 火焰伤害抵抗触发
- 移动、跳跃、冲刺、水下或低生命值效果
所有这些都可以通过配置实现。
附魔台集成
自定义附魔可以出现在原版附魔台中。
玩家可以通过正常的附魔过程自然地获得自定义附魔,而不仅仅是通过命令或商店获取。
FotiaEnchantment 处理以下内容:
- 附魔台预览同步
- 自定义附魔随机抽取
- 原版与自定义附魔混合
- 最大附魔数量限制
- 冲突限制
简洁的客户端 Lore 显示
安装 PacketEvents 后,FotiaEnchantment 可以重写显示给客户端的附魔 Lore。
它支持:
- 隐藏默认的原版附魔行
- 以插件格式显示附魔名称
- 显示稀有度颜色
- 高亮显示诅咒附魔
- 显示详细的动态效果描述
- 同时管理原版附魔的显示
PacketEvents 是可选的。即使没有安装,插件仍可运行,但高级客户端 Lore 控制功能将受限。
内置 GUI 系统
FotiaEnchantment 包含多个可配置的 GUI:
- 附魔法典 GUI
- 管理员附魔管理 GUI
- 碎片合成 GUI
- 打开法典 GUI
- 反魔 GUI
GUI 布局、槽位、按钮、物品名称、Lore、背景物品和模型数据均可通过配置文件进行自定义。
附魔法典
玩家可以输入:
/fe gui
来打开附魔法典,查看服务器上可用的附魔。
法典可以显示:
- 附魔名称
- 稀有度
- 类型
- 分组
- 最高等级
- 支持物品
- 详细效果描述
这允许玩家直接在游戏内了解服务器的附魔内容。
管理员 GUI
管理员可以输入:
/fe gui admin
来打开管理员管理界面。
它支持:
- 查看所有附魔
- 按类别筛选
- 启用或禁用附魔
- 快速获取附魔书
- 查看附魔详情
- 重载后保持禁用状态
这对于测试、平衡和维护附魔非常有用。
法典、碎片和反魔物品
FotiaEnchantment 包含自定义物品玩法,例如:
玩家可以收集碎片,合合法典物品,打开它们以接收随机附魔书,或使用反魔水晶从物品上移除附魔。
这些物品也可以通过配置进行自定义。
多语言支持
该插件包含多语言文件夹:
zh_cn
zh_tw
en_us
ja_jp
ko_kr
如果玩家客户端的语言不可用,插件将回退到默认语言。
命令
| 命令 |
描述 |
/fe gui |
打开玩家附魔法典 |
/fe gui admin |
打开管理员附魔 GUI |
/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 附魔插件更高级替代方案的服务器
要求
- Java 21
- Minecraft 1.21.x
- Paper / Leaf
可选依赖:
- PacketEvents
- PlaceholderAPI
- WorldGuard
- AuraSkills
- mcMMO
- MythicMobs
- CraftEngine
安装
- 下载最新的
FotiaEnchantment-*.jar。
- 将其放入服务器的
plugins/ 文件夹中。
- 启动服务器以生成配置文件。
- 根据需要编辑配置文件。
- 运行
/fe reload 以重载插件。
开源
GitHub 仓库:
最新版本:
许可证:MIT
FotiaEnchantment - AI-Friendly Config-Driven Custom Enchantments for Paper / Leaf
Server Software: Paper / Leaf
Minecraft Version: 1.21.x
Java Version: Java 21
License: MIT
GitHub:
Create New Enchantments with AI
If you are not familiar with writing enchantment configs, you can download VIBEDOC.md or VIBEDOC.en.md from the GitHub repository.
VIBEDOC is a guide designed for AI tools to understand the FotiaEnchantment configuration format. You can give it to ChatGPT, Codex, Claude, or other AI assistants, then describe the enchantment you want in natural language. The AI can generate usable enchantment YAML configs and language entries for FotiaEnchantment.
For example:
“Create an armor enchantment that has a chance to heal the player and grant Resistance when damaged. Higher levels should make the effect stronger.”
The AI can generate the required config files based on VIBEDOC. After that, place the files into the plugin folder and run /fe reload.
What is FotiaEnchantment?
FotiaEnchantment is a config-driven custom enchantment plugin for Paper and Leaf servers.
It is not just a simple lore-based enchantment plugin. FotiaEnchantment provides a complete configurable enchantment system, including triggers, conditions, effects, language files, GUIs, enchantment books, enchanting table integration, disenchanting items, codex gameplay, and custom enchantment items.
Server owners can create and expand custom enchantments through YAML files without modifying Java code.
AI-Friendly Enchantment Creation
One of the main ideas behind FotiaEnchantment is making custom enchantment creation easier with AI.
The plugin provides a dedicated VIBEDOC guide that can be read by AI tools such as ChatGPT, Codex, Claude, and others. You can describe the enchantment you want in natural language, and the AI can generate:
- Enchantment YAML configuration
- Chinese language entries
- English language entries
- Dynamic descriptions for chance, level, duration, range, and values
- Suggested file paths for the plugin structure
For example, you can ask:
Create an armor enchantment that has a 10% to 18% chance to heal the player and grant Resistance when damaged. Higher levels should make the effect stronger.
The AI can then generate valid FotiaEnchantment configuration and language entries based on the plugin format.
Core Features
Config-Driven Enchantments
Each enchantment is defined in its own YAML file.
You can configure:
- Enchantment name and multilingual descriptions
- Maximum level
- Rarity and color
- Enchantment type and group
- Supported item types
- Conflicting enchantments
- Enchanting table weight
- Obtain methods
- Triggers
- Conditions
- Effects
- Cooldowns
- Chances
- Durations
- Range and value formulas
Values can scale dynamically with enchantment level, making it easy to create progression-based effects.
Trigger / Condition / Effect Pipeline
Enchantments are executed through a configurable pipeline:
Player event -> Find item enchantments -> Match trigger -> Check conditions -> Run effects
This allows you to create gameplay such as:
- Extra damage on attack
- Chance-based healing when damaged
- Buffs after kills
- Vein mining
- Drop multiplication
- Auto smelting
- Fire damage resistance triggers
- Movement, jumping, sprinting, underwater, or low-health effects
All of these can be built through configuration.
Enchanting Table Integration
Custom enchantments can appear in the vanilla enchanting table.
Players can naturally obtain custom enchantments through the normal enchanting process instead of only receiving them through commands or shops.
FotiaEnchantment handles:
- Enchanting table preview synchronization
- Custom enchantment rolling
- Mixed vanilla and custom enchantments
- Maximum enchantment count limits
- Conflict restrictions
Clean Client-Side Lore Display
With PacketEvents installed, FotiaEnchantment can rewrite enchantment lore displayed to the client.
It supports:
- Hiding default vanilla enchantment lines
- Displaying enchantment names in the plugin format
- Showing rarity colors
- Highlighting curse enchantments
- Showing detailed dynamic effect descriptions
- Managing vanilla enchantment display as well
PacketEvents is optional. The plugin can still run without it, but advanced client-side lore control will be limited.
Built-In GUI System
FotiaEnchantment includes multiple configurable GUIs:
- Enchantment codex GUI
- Admin enchantment management GUI
- Fragment crafting GUI
- Codex opening GUI
- Disenchanting GUI
GUI layouts, slots, buttons, item names, lore, background items, and model data can be customized through configuration files.
Enchantment Codex
Players can use:
/fe gui
to open the enchantment codex and view available enchantments on the server.
The codex can show:
- Enchantment name
- Rarity
- Type
- Group
- Maximum level
- Supported items
- Detailed effect descriptions
This allows players to understand the server's enchantments directly in-game.
Admin GUI
Admins can use:
/fe gui admin
to open the admin management interface.
It supports:
- Viewing all enchantments
- Filtering by category
- Enabling or disabling enchantments
- Quickly obtaining enchantment books
- Viewing enchantment details
- Keeping disabled states after reload
This is useful for testing, balancing, and maintaining enchantments.
Codex, Fragments, and Disenchanting Items
FotiaEnchantment includes custom item gameplay such as:
- Starlight fragments
- Enchantment codex items
- Disenchanting crystals
Players can collect fragments, craft codex items, open them to receive random enchantment books, or use disenchanting crystals to remove enchantments from items.
These items can also be customized through configuration.
Multilingual Support
The plugin includes multilingual language folders:
zh_cn
zh_tw
en_us
ja_jp
ko_kr
If a player's client language is not available, the plugin falls back to the default language.
Commands
| Command |
Description |
/fe gui |
Open the player enchantment codex |
/fe gui admin |
Open the admin enchantment GUI |
/fe list [category] [page] |
View the enchantment list |
/fe info <enchant_id> |
View enchantment details |
/fe enchant <enchant_id> <level> |
Apply an enchantment to the held item |
/fe give <player> <enchant_id> <level> |
Apply an enchantment to a player's held item |
/fe giveitem <player> <item_type> [amount] [rarity] |
Give custom plugin items |
/fe reload |
Reload plugin configuration |
Commands support tab completion.
Recommended For
FotiaEnchantment is suitable for:
- RPG survival servers
- Magic enchantment servers
- Gear progression servers
- Dungeon servers
- Class-based servers
- Random enchantment book systems
- Servers that want AI-assisted enchantment creation
- Servers looking for a more advanced alternative to simple lore enchantment plugins
Requirements
- Java 21
- Minecraft 1.21.x
- Paper / Leaf
Optional dependencies:
- PacketEvents
- PlaceholderAPI
- WorldGuard
- AuraSkills
- mcMMO
- MythicMobs
- CraftEngine
Installation
- Download the latest
FotiaEnchantment-*.jar.
- Place it into your server's
plugins/ folder.
- Start the server to generate configuration files.
- Edit the configuration files as needed.
- Run
/fe reload to reload the plugin.
Open Source
GitHub Repository:
Latest Release:
License: MIT
评论 0
登录后参与评分
还没有评论,来抢沙发吧