Dragon Curse Chronicles

Dragon Curse Chronicles

一款受经典动画剧集 《成龙历险记》启发的 Minecraft 模组，重现十二生肖符咒的力量。扩展玩法包括源力附魔、老爹的干河豚，以及自定义粒子渲染 API。

跳转至中文介绍：README.md

平台支持

| 加载器 | Minecraft 版本 | 模组版本 | 状态 |
|—|—|—|—|
| Minecraft Forge | 1.20.1 | 0.2.4-rc-9 | ✅ 已发布，功能完整 |
| Fabric | 1.20.1 | 1.0.6-1.20.1Fabric | ✅ 已发布，功能完整 |
| NeoForge | 1.21.1 | 0.1.0-1.21.1NeoForge | ✅ 已发布，功能完整 |

三个加载器版本的功能均一致。每个平台都需要同时安装三个 JAR 文件：主模组、DC Render API 前置库，以及 Kotlin 语言适配器（详见下方安装部分）。

功能

• 十二符咒系统：重现鼠、牛、虎（开发中）、兔、龙、蛇、马、羊、猴（开发中）、鸡、狗和猪符咒的力量。每个符咒都有专属粒子效果和音效。
• 源力附魔：共 10 级的渐进式附魔。1–5 级可通过附魔台和村民交易获得；6–10 级可通过合成升级：将 4 本 N 级附魔书合成为 1 本 N+1 级附魔书。穿戴全套护甲可解锁 6 种叠加效果：伤害反弹、伤害减免、能量护盾、生命恢复、击退免疫和源力光环。
• 源力光环：作用半径为 10 格，可通过自定义按键切换（默认未绑定）。持续对附近实体造成源初终焉伤害。
• 老爹的干河豚：右键即可发射绿色激光（无需蓄力），伴有两条反向旋转的螺旋粒子带和渐变色，随后进入 5 秒冷却。还包含针对 Boss（如混沌守卫）的专用“五连杀”绕过机制。
• 自定义粒子 API（DC Render API）：自研粒子调度器，支持颜色与粒子对象池、适配帧的批处理、基于距离的 LOD 衰减，以及渐进式发射，可绕过客户端粒子优化模组执行的激进剔除。
• 符咒力量提取器与唐山方块：从动物身上提取符咒精华。唐山方块有 35% 的概率出现在流星雨战利品箱中。
• 流星雨事件：每个主世界午夜有 30% 的概率触发。撞击坑内会生成箱子，箱中包含唐山方块、符咒基座及其他稀有物品。也可手动触发/meteorshower start（仅限 OP）。
• 羊符咒——灵魂出窍：隐身 + 夜视 + 飞行 + 穿墙 + 无敌。停用时，玩家会返回记录的身体位置。
• 数据驱动配方：为所有符咒、符咒基座和源力附魔书升级提供数据包配方。

符咒参考

✅ 已实现

| 护符 | 能力 | 用法 |
|—|—|—|
| 🐭 Rat | 将特定方块变成对应的生物 | 手持护符，对目标方块右键 |
| 🐮 Ox | 力量 III + 抗性 III + 速度 II | 手持护符右键 — 持续 3 分钟 |
| 🐇 Rabbit | 速度提升 + 瞬移 5 格。若先激活 Rooster 的漂浮效果，即可解锁 Chicken + Rabbit 组合（飞行） | 手持护符右键 |
| 🐉 Dragon | 发射恶魂风格的火球，拖曳火焰粒子轨迹，并造成范围爆炸伤害 | 手持护符右键 — 冷却时间 1 秒 |
| 🐍 Snake | 强化隐身 II + 自定义 Snake Power 图标 | 手持护符右键 — 持续 5 分钟 |
| 🐎 Horse | 完全恢复玩家生命值，并清除 10 种负面效果（中毒、凋零、虚弱、缓慢、失明、饥饿、漂浮、发光、不祥之兆、黑暗） | 手持护符右键 — Horse Power 持续 1 分钟 |
| 🐑 Sheep | 灵魂离体：隐身 + 夜视 + 飞行 + 穿墙 + 无敌。离体时保存身体位置，并在退出后恢复 | 手持护符右键切换 |
| 🐔 Rooster | 缓降 / 漂浮模式。激活漂浮模式时，右键 Rabbit 护符可触发 Chicken-Rabbit 飞行。 | 右键触发模式。Shift + 右键切换模式 |
| 🐶 Dog | 生命恢复 + 清除 10 种负面效果 + 持续伤害吸收（每 30 秒刷新） | 手持护符右键 |
| 🐷 Pig | 发射高能激光，造成 99 点伤害，并点燃光束路径上的目标。带有自定义粒子轨迹 | 手持护符右键 — 冷却时间 2 秒 |

🔧 开发中（WIP）

• 🐯 Tiger：善恶分离 — 生成一个善良克隆体和一个邪恶克隆体
• 🐒 Monkey：变形能力 — 随机将目标生物变成其他生物

起源能力附魔

| 物品 | 详情 |
|—|—|
| 获取方式 | 等级 1–5：附魔台 / 村民交易（等级越高，出现概率越低）。等级 6–10：在工作台中合成 4 本等级为 N 的书，得到 1 本等级为 N+1 的书。 |
| 最高等级 | 10 |
| 适用装备 | 任意盔甲（头盔、胸甲、护腿、靴子）。附魔非盔甲装备不会产生效果。 |
| 起源终焉伤害 | 由 Uncle’s Dried Puffer Fish 触发，使用自定义origin_end伤害类型，可绕过大多数防御、效果和无敌状态。 |

盔甲效果阶梯（按 4 个盔甲栏位的总等级解锁）

| 总等级 | 解锁效果 |
|—|—|
| 1+ | 伤害反射 — 将部分伤害反弹给攻击者（效果随等级提升） |
| 5+ | 伤害减免 — 分阶提升伤害减免，最高阶效果最强 |
| 10+ | 能量护盾 — 周期性吸收伤害 |
| 15+ | 生命恢复 — 周期性恢复生命值 |
| 20+ | 击退免疫 — 不再受到击退 |
| 25+ | 起源光环 — 对 10 格范围内的所有实体持续造成起源终焉伤害。可通过按键绑定切换。 |

光环默认没有绑定按键；请在控制 → 按键绑定中设置。切换状态会通过网络同步，并按玩家分别保存。

Uncle’s Dried Puffer Fish

• 触发：右键立即发射绿色激光（无需蓄力），随后进入5 秒冷却。
• 伤害流程：伤害类型为 Origin End；对 Draconic Guardian 等 Boss 使用专用连锁击杀流程（破盾 → 攻击头部 → 终结）。
• 视觉效果：绿色中央光束 + 2 条反向旋转的螺旋带（绿色→青色渐变和紫色→粉色渐变）。每次射击会将约 1200 个候选粒子加入队列，并通过 SmartParticleDispatcher（对象池 + LOD）由近及远逐步发射。
• 音效：施放时播放 Uncle 的“Madgaq”语音，命中时播放烟花爆炸声和环境火焰声。

物品与事件

护身符能量提取器

• 用法：主手持提取器，副手持护身符底座 → 右键动物进行提取。
• 概率：默认 10%，可在配置文件中调整。
• 使用次数限制：公鸡/龙/猪各可尝试 100 次；其他动物各可尝试 10 次（硬编码）。
• 获取方式：合成配方。

唐山方块

• 用法：使用方式与提取器相同，但仅对绵羊有效，可获得绵羊护身符。
• 获取方式：陨石雨战利品箱（35% 概率）。

陨石雨事件

• 触发时间：主世界午夜 00:00，每晚有 30% 的概率触发。
• 手动触发：OP 玩家运行 /meteorshower start。
• 奖励：陨石坑内会生成箱子，内含唐山方块、护身符底座及其他稀有战利品。

安装

⚠ 三种加载器都需要三 JAR 文件配置：主模组 + DC Render API + Kotlin Language Adapter。缺少其中任何一个都会导致游戏在加载时崩溃。

Forge 1.20.1

1. 安装 Minecraft Forge 1.20.1（47.x 或更高版本）。
2. 下载以下三个 Forge JAR 文件：

• Kotlin Adapter：Kotlin-for-Forge-*-1.20.1.jar（由 thedarkcolour 制作，可在 CurseForge 和 Modrinth 获取）
• DC Render API（必需前置依赖）：dcrapi-X.X.X-1.20.1Forge.jar
• 主模组：dcc-0.2.4-rc-9.jar

1. 将三个 JAR 文件放入你的 mods/ 文件夹。
2. 启动游戏。

Fabric 1.20.1

1. 安装 Fabric Loader 0.16.13+ 和 Fabric API 0.92.11+1.20.1。
2. 下载以下三个 Fabric JAR 文件：

• Kotlin Adapter：fabric-language-kotlin-*（可在 CurseForge 和 Modrinth 获取）
• DC Render API（必需前置依赖）：dcrapi-X.X.X-1.20.1Fabric.jar
• 主模组：dcc-1.0.6-1.20.1Fabric.jar

1. 将三个 JAR 文件放入你的 mods/ 文件夹。
2. 启动游戏。

NeoForge 1.21.1

1. 为 Minecraft 1.21.1 安装 NeoForge 21.1.248+。
2. 下载以下三个 NeoForge JAR 文件：

• Kotlin Adapter：Kotlin-for-Forge-*-1.21.1-NeoForge.jar（由 thedarkcolour 制作，可在 CurseForge 和 Modrinth 获取）
• DC Render API（必需前置依赖）：dcrapi-*-1.21.1NeoForge.jar
• 主模组：dcc-0.1.0-1.21.1NeoForge.jar

1. 将三个 JAR 文件放入你的 mods/ 文件夹。
2. 启动游戏。

构建与开发

项目结构

Twelve Talismans/                           # Monorepo root
├── src/main/java/com/qituo/dcc/            # Forge 1.20.1 main mod sources
├── fabric/Dragon Curse Chronicles/src/     # Fabric 1.20.1 main mod sources
├── neoforge/src/main/java/com/qituo/dcc/   # NeoForge 1.21.1 main mod sources
├── DC Render API/                          # Particle API dependency subdirectory
│   ├── src/                                # Forge API
│   ├── fabric/DC Render API/               # Fabric API
│   └── neoforge/                           # NeoForge API
├── gradle.properties                       # Forge version numbering
├── README.md / README_en.md                # Chinese / English documentation

构建命令

# Forge 1.20.1 (repo root)
./gradlew build            # artifact → build/libs/dcc-0.2.4-rc-9.jar

# Fabric 1.20.1
cd fabric/Dragon\ Curse\ Chronicles
./gradlew build            # artifact → build/libs/dcc-1.0.6-1.20.1Fabric.jar

# NeoForge 1.21.1
cd neoforge
./gradlew build            # artifact → build/libs/dcc-0.1.0-1.21.1NeoForge.jar

每次构建都会自动生成一个 -sources.jar。

路线图

• 完整实现猴（多态）和虎（善恶分化）护符。
• 完善并扩展 NeoForge 1.21.1 版本中尚未完成的功能细节。
• 护符盒界面和快捷栏快速切换。
• 将当前基于 Origin Power NBT 存根的方案替换为真正由数据包驱动的附魔注册机制。

参与贡献

欢迎提交问题、功能请求和拉取请求！

许可证

本项目根据 MIT 许可证 发布，详见 LICENSE.md。