SpellEngine 是一个前置库模组（也称为 API），开发者可以利用它创建魔法法术，为玩家提供完整的施法系统，包括法术书、视觉效果以及武器联动。

📦 安装

🎁 强烈推荐通过 Modrinth app 安装，以自动解析所有必需的模组。

必需

• Cloth Config
• Player Animator
• Spell Power Attributes

Fabric 还需要：

• Fabric API
• 槽位模组：Trinkets

NeoForge 还需要：

• 槽位模组：Curios API

⭐️ 使用 Spell Engine 制作的内容

🤝 由合作伙伴制作

📦 内置内容

🗡️ 武器技能 🪓

探索各种近战攻击技能，每种技能都为特定的武器类型设计，并具有独特的功能：

• 精细的碰撞检测
• 动量与滑行
• 华丽的动画

RPG 系列内容模组默认附带这些技能。

根据物品 ID 或物品标签归属，自动分配给第三方和原版武器。（配置文件：config/spell_engine/weapon_fallback.json）

🪄️ API 功能

数据驱动的 API

• 🗡️ 法术可以被分配给任意武器（由数据驱动，并自动兼容武器）
• 🔮 法术根据 Spell Power 实体属性造成伤害
• ✍️ 法术以 JSON 格式定义，支持热重载和网络同步
• 📦 法术容器系统，支持代理模式、装备栏位和动态法术解析
• 🔄 通用模式匹配系统，支持对所有法术属性进行标签、正则表达式和精确匹配
• 🛠️ 通过 SpellBuilder 和 SpellGenerator 以编程方式生成法术，方便模组开发者使用
• ⚙️ 法术拥有一套完整的机制行为：
• 法术类型：主动（施放）、被动（触发）、修改器（修改法术）
• 施法模式：瞬发、蓄力、引导，并支持可配置的急速效果
• 触发系统：14 种以上的触发类型（近战、箭矢、法术、伤害、闪避、翻滚等），支持条件逻辑
• 目标选择：瞄准、射线、区域、施法者、无、来自触发源——支持上限、条件和基于生命值的限制
• 传递方式：直接、投射物、陨石、云雾、射箭、储存效果、自定义——支持延迟和多重放置
• 投射物特性：追踪、跳弹、反弹、穿透、连锁反应、散射、自定义碰撞箱
• 命中动作：伤害、治疗、状态效果、点燃、传送、生成、冷却、仇恨、自定义
• 条件逻辑：目标修改器、命中过滤器、基于概率的执行、实体类型条件
• 消耗系统：疲劳、物品/符文、冷却时间、耐久度、状态效果消耗，并支持批量处理
• 装备套装：提供法术、属性和特殊能力的套装加成

华丽的音效与视觉效果

• 🔈 高级音效系统：施法开始/循环、释放、命中、飞行音效，并支持随机化
• ✨ 精巧的粒子系统：支持多种形状、跟随实体、缩放以及自定义魔法粒子
• 🎨 自定义投射物、状态效果和法术云雾的物品/方块模型，支持 BlockBench
• 🤸 法术各阶段均支持玩家动画，可控制俯仰角，并支持远程武器动画
• 💡 集成动态光照（LambDynamicLights），为魔法效果提供照明
• 🌈 可自定义射线渲染：支持颜色、纹理、宽度和流动效果
• 📍 区域效果可视化：支持地面指示器和根据范围缩放的粒子效果

游戏内功能

• 🔧 在 HUD 上显示法术选择和施放信息（完全支持玩家自定义）
• 😌 便利性功能：自动释放法术、客户端预测、智能目标选择
• ⛓️ 法术绑定台：可将法术添加到武器上并制作法术书
• 📜 法术卷轴系统：支持创造模式物品栏生成和地牢战利品集成
• 🎒 装备集成：法术书、饰品栏位（Trinkets/Accessories）、自动检测武器
• ⚡ 法术无限附魔，支持可配置的物品标签
• 🎮 命令：/spell_cooldowns，用于服务器管理和调试
• 💰 高级战利品系统，支持使用 spell_bind_randomly 函数动态分配法术

开发者与模组集成

• 🔌 广泛的模组兼容性：Better Combat、Combat Roll、FTB Teams、Shoulder Surfing 等
• 📊 完善的事件系统，支持施法、治疗和投射物生命周期
• 🏗️ 自定义处理器注册，支持投递方式和命中动作
• 🎯 实体谓词系统，支持复杂的目标选择条件
• 🔧 性能优化：批处理、调度、客户端预测
• 📝 数据生成框架，支持以编程方式创建和验证法术
• 🌐 多平台支持（Fabric 和 NeoForge），提供统一 API