转载 开源 FotiaEnchantment 1.1.16

[MD]
## 简介

服务端核心： Paper / Leaf / Folia
Minecraft 版本： 1.21.x
Java 版本： Java 21
许可证： MIT
GitHub： https://github.com/Ti-Avanti/FotiaEnchantment

# FotiaEnchantment

- **服务端核心：** Paper / Leaf / Folia
- **Minecraft 版本：** 1.21.x
- **Java 版本：** Java 21
- **许可证：** MIT
- **GitHub：** [https://github.com/Ti-Avanti/FotiaEnchantment](https://github.com/Ti-Avanti/FotiaEnchantment)

## 简介

FotiaEnchantment 是一款面向 Paper 和 Leaf 服务端的、由配置文件驱动的自定义附魔插件。

它并非简单依赖物品 Lore 实现附魔效果，而是提供了一套完整且可配置的附魔系统，包括触发器、条件、效果、语言文件、GUI、附魔书、附魔台集成、附魔剥离道具、图鉴玩法及自定义附魔物品等功能。

服主无需修改 Java 代码，只需编辑 YAML 文件，即可创建并扩展自定义附魔。

## 面向 AI 的附魔创建

FotiaEnchantment 的核心理念之一，是借助 AI 简化自定义附魔的制作流程。

插件提供了专用的 VIBEDOC 指南，可供 ChatGPT、Codex、Claude 等 AI 工具阅读。你只需使用自然语言描述想要的附魔效果，AI 即可按插件格式生成：

- 附魔 YAML 配置
- 简体中文语言条目
- 英文语言条目
- 几率、等级、持续时间、范围与数值等动态描述
- 建议使用的插件文件路径

例如，你可以向 AI 提出以下需求：

> 创建一个护甲附魔：玩家受到伤害时，有 10% 至 18% 的概率恢复生命值并获得抗性提升效果；附魔等级越高，效果越强。

AI 随后即可根据 FotiaEnchantment 的配置格式，生成可用的附魔配置及语言文件条目。

## 核心功能

### 配置驱动的附魔系统

每个附魔均由独立的 YAML 文件定义，可配置以下内容：

- 附魔名称与多语言描述
- 最高等级
- 稀有度与颜色
- 附魔类型与分组
- 支持的物品类型
- 冲突附魔
- 附魔台权重
- 获取方式
- 触发器、条件与效果
- 冷却时间、触发概率与持续时间
- 范围和数值公式

附魔数值可随等级动态成长，便于制作具备成长体系的效果。

### 触发器、条件与效果流水线

附魔通过以下可配置流程执行：

```text
玩家事件 → 查找物品上的附魔 → 匹配触发器 → 检查条件 → 执行效果
```

通过该机制，你可以仅使用配置实现以下玩法：

- 攻击时造成额外伤害
- 受伤时概率回血
- 击杀后获得增益效果
- 连锁挖矿
- 掉落物倍率提升
- 自动熔炼
- 火焰伤害抗性触发
- 移动、跳跃、冲刺、水下或低生命值状态下的特殊效果

### 原版附魔台集成

自定义附魔可出现在原版附魔台中。玩家能够通过正常附魔流程自然获得自定义附魔，而不仅限于命令或商店购买。

FotiaEnchantment 可处理：

- 附魔台预览同步
- 自定义附魔随机生成
- 原版附魔与自定义附魔混合附加
- 最大附魔数量限制
- 附魔冲突限制

### 整洁的客户端 Lore 显示

安装 PacketEvents 后，FotiaEnchantment 可以重写客户端显示的附魔 Lore，支持：

- 隐藏默认原版附魔文本
- 按插件格式显示附魔名称
- 显示稀有度颜色
- 高亮诅咒类附魔
- 显示详细的动态效果描述
- 统一管理原版附魔的显示方式

PacketEvents 为可选依赖。未安装时，插件依然可以运行，但客户端 Lore 的高级控制功能将受到限制。

### 内置 GUI 系统

FotiaEnchantment 提供多个可配置 GUI：

- 附魔图鉴 GUI
- 管理员附魔管理 GUI
- 碎片合成 GUI
- 图鉴开启 GUI
- 附魔剥离 GUI

GUI 的布局、槽位、按钮、物品名称、Lore、背景物品及模型数据均可通过配置文件自定义。

### 附魔图鉴

玩家可使用 `/fe gui` 打开附魔图鉴，查看服务器内可用的附魔。

图鉴可显示：

- 附魔名称
- 稀有度
- 类型与分组
- 最高等级
- 支持的物品
- 详细效果说明

玩家可以直接在游戏内了解服务器的附魔系统。

### 管理员 GUI

管理员可使用 `/fe gui admin` 打开附魔管理界面，支持：

- 查看全部附魔
- 按分类筛选附魔
- 启用或禁用附魔
- 快速获取附魔书
- 查看附魔详细信息
- 重载后保留禁用状态

该功能适合用于测试、平衡调整及日常维护。

### 图鉴、碎片与附魔剥离道具

插件内置多种自定义道具玩法，包括：

- 星光碎片
- 附魔图鉴道具
- 附魔剥离水晶

玩家可以收集碎片、合成图鉴道具，开启后获得随机附魔书；也可以使用附魔剥离水晶移除物品上的附魔。

这些道具同样可通过配置文件自定义。

### 多语言支持

插件内置以下语言目录：

- `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

## 安装方法

1. 下载最新版本的 `FotiaEnchantment-*.jar`。
2. 将 Jar 文件放入服务端的 `plugins/` 文件夹。
3. 启动服务端，以生成插件配置文件。
4. 根据需要编辑配置文件。
5. 执行 `/fe reload` 重载插件。

## 开源与下载

- **GitHub 仓库：** [https://github.com/Ti-Avanti/FotiaEnchantment](https://github.com/Ti-Avanti/FotiaEnchantment)
- **最新版本下载：** [https://github.com/Ti-Avanti/FotiaE...m/Ti-Avanti/FotiaEnchantment/releases/latest)
- **许可证：** MIT
[/MD]