龙咒异闻录

龙咒编年史

模组概述

龙咒编年史是一个受动画系列《成龙历险记》启发的 Minecraft Forge 模组，为玩家提供各种强大的符咒能力。该模组不仅实现了部分符咒功能，还开发了一个自定义粒子渲染 API（DC Render API），用于创建各种华丽的粒子效果。

跳转至中文介绍： README.md

特性

• 十二符咒系统：实现了多种符咒能力，包括龙符咒（火球）和猪符咒（激光）
• 自定义粒子 API：开发了 DC Render API，支持复杂的粒子动画效果
• Java 与 Kotlin 混合开发：核心功能使用 Java 实现，动画系统使用 Kotlin 实现
• 网络同步：实现服务端与客户端之间的粒子效果同步
• 性能优化：采用高效的粒子管理与渲染机制
• 起源之力附魔：强大的附魔系统，提供无视防御的伤害能力
• 老爹的河豚干：游戏内特殊物品
• 符咒基底：用于制作符咒的基础材料

符咒介绍

已实现的符咒

龙符咒

• 能力：发射恶魂式火球，造成大范围爆炸伤害
• 粒子效果：环形轨道火焰粒子、螺旋粒子和波纹粒子
• 使用方法：手持龙符咒并右键释放

猪符咒

• 能力：发射激光，沿直线造成伤害并点燃目标
• 粒子效果：激光起点处的环形轨道粒子、终点处的螺旋粒子以及沿路径的波纹粒子
• 使用方法：手持猪符咒并右键释放

鸡符咒

• 能力：获得缓降之力或漂浮之力
• 使用方法：手持鸡符咒并右键释放，Shift+右键可在缓降之力和漂浮之力之间切换

狗符咒

• 能力：提供生命恢复、清除负面效果并赋予短暂无敌
• 使用方法：手持狗符咒并右键释放

马符咒

• 能力：完全恢复生命值并清除所有负面效果
• 使用方法：手持马符咒并右键释放

蛇符咒

• 能力：提供强化隐身效果
• 使用方法：手持蛇符咒并右键释放

兔符咒

• 能力：提高移动速度并实现短距离传送，当鸡符咒的漂浮之力处于激活状态时，右键此符咒将获得鸡兔之力（飞行能力）
• 使用方法：手持兔符咒并右键释放

牛符咒

• 能力：提高攻击力、防御力和移动速度
• 使用方法：手持牛符咒并右键释放

鼠符咒

• 能力：将特定方块转化为对应的生物
• 使用方法：手持鼠符咒并对目标方块右键

未实现的符咒

猴符咒

• 计划功能：变形之力（将目标转化为其他生物）

虎符咒

• 计划功能：善恶分离（创造玩家的善与恶分身）

羊符咒

• 计划功能：出窍之力（让灵魂离开身体）

物品介绍

符咒之力提取器

• 能力：从动物身上提取力量以制作符咒
• 使用方法：主手持提取器，副手持符咒基底，然后右键动物以提取力量并制作符咒。存在使用次数限制和概率限制。概率可在配置文件中调整，默认概率为 10%。除鸡、龙、猪外，其他动物需要 10 次提取尝试，而这三者需要 100 次尝试（尝试次数上限为硬编码，无法更改）。
• 获取方式：可合成

唐山方盒

• 能力：提取羊符咒，步骤与符咒之力提取器相同
• 使用方法：主手持唐山方盒，副手持符咒基底，然后右键羊以提取羊符咒。概率为 10%，需要 100 次尝试（硬编码，无法更改）。
• 获取方式：通过流星雨事件获得。流星雨结束后出现的宝箱中有 35% 的概率找到它。流星雨事件在主世界午夜（12:00 AM）随机触发（30% 概率），也可使用命令 /meteorshower start 强制触发（需要 OP 权限）。宝箱生成在流星坑内，需要挖开才能找到。

符咒盒

• 能力：存储和管理符咒
• 使用方法：暂无用途，尚未实现。

安装

1. 确保已安装 Minecraft Forge 1.20.1
2. 下载龙咒编年史模组 jar 文件
3. 将 jar 文件放入 mods 文件夹
4. 启动游戏，享受符咒的力量

开发说明

项目结构

• src/main/java/com/qituo/dcc/：模组主代码
• DC Render API/src/main/java/com/qituo/dcrapi/：粒子 API 代码
• DC Render API/src/main/kotlin/com/qituo/dcrapi/：Kotlin 实现的动画系统

构建项目

1. 将项目克隆到本地
2. 使用 Gradle 构建项目：

   ./gradlew build
   

3. 构建产物将生成在 build/libs 目录中

依赖

• Minecraft Forge 1.20.1-47.4.17
• DC Render API 0.1.0+

未来计划

• 实现更多符咒能力
• 优化性能和兼容性

贡献

欢迎向项目提交建议和贡献！如果您有任何问题或想法，请在 GitHub 上提交 issue 或 pull request。

许可证

本项目采用 QSUP 许可证。详情请参阅 LICENSE 文件。