
符文核心
一个模块化且可扩展的Hytale魔法引擎,引入元素精华、自定义RPG战斗属性和持久状态效果。
查看大图RuneCore
可扩展的魔法系统引擎与框架,适用于 Hytale 模组。
项目状态:开发中
- 进行中: 自定义状态效果的药水与制作配方。
- 已可用: 核心命令、玩家状态管理与精华掉落系统。
- API: 测试阶段。
- 视觉: 自定义标志与精华图标。3D 模型使用复用的游戏资源。
- 下一步: 完整的 RuneAlchemy 系统与药水酿造流水线。
1. 概述
RuneCore 将 Hytale 原生基础扩展为模块化引擎,支持元素交互、状态效果、自定义 RPG 属性与炼金配方。该模组既提供开箱即用的机制,也提供可扩展的 API 以便与其他模组集成。
2. 视觉图库
元素精华
药水
状态效果
游戏内效果展示
流血
造成持续伤害,并在玩家画面上施加血色滤镜。

燃烧
点燃目标,造成火焰伤害并叠加燃烧屏幕覆盖效果。

衰败
以死灵视觉效果持续侵蚀实体生命值。

抗火
赋予火焰伤害免疫,并保护实体在熔岩环境中不受伤害。

冰冻
将目标封入冰中,锁定物理移动与转向。

发光
在低光环境中于实体与玩家周围发出动态光照。

高跳
提升垂直速度,将玩家与实体弹射至高空跳跃。

正常生命值
HUD 上默认的玩家生命值状态。

瞬间伤害
在命中或药水溅射时立即扣除生命值。

瞬间治疗
立即恢复生命值并更新玩家生命状态。

失明
完全变暗玩家视野与 HUD,模拟失去视觉。
正常视野:
失明视野:

漂浮
以反重力物理将实体抬升至空中,效果结束后随之坠落。
向上漂浮:
下降 / 坠落:

反胃
造成强烈的镜头摇晃与画面错位,循环切换视角角度。

夜视
通过动态调整环境光照等级照亮黑暗环境。
关于引擎限制的说明: 由于当前 Hytale 服务器 API 的限制,动态光照组件影响的是目标实体周围的全局场景光照,而非应用每客户端的后处理着色器。
**夜晚环境(无效果):**
**夜视激活:**

中毒
持续造成中毒伤害,生命指示变为绿色直至效果结束。
中毒激活:
效果结束后:

再生
随时间恢复生命值,周期性恢复玩家生命。
再生激活:
完全恢复:

抗性
减少受到的物理与魔法攻击伤害。

速度
提升水平移动速度,使冲刺与移动更快。

3. 架构
RuneCore 分为三个主要模块:
- RuneCore(核心): 管理精华、法力、战斗属性与玩家成长。对外暴露核心 API。
- RuneMagic: 法术、符文(被动效果)、神器与魔典。
- RuneAlchemy: 使用精华进行药水、试剂与物品附魔的酿造系统。
4. 掉落表与掉落率
生物被玩家击败时会掉落元素精华(默认基础掉落率:25%)。
| 图标 | 精华 | 来源生物 |
|---|---|---|
| 火 | Emberwulf、火龙、岩浆/火焰生物 | |
| 土 | Trork、土魔像、野牛、陆龟、鼹鼠 | |
| 风 | 鸟类(鹰、猫头鹰、乌鸦等)、Feran Windwalker | |
| 水 | 鱼类(鲨鱼、食人鱼等)、螃蟹、青蛙、鲸鱼 | |
| 冰 | 北极熊、霜龙、雪人、霜骷髅 | |
| 闪电 | 雷魔像、雷灵、活火花 | |
| 光 | Spirit Root、圣诞 Kweebec | |
| 暗影 | 暗影骑士、怨灵、Skrill | |
| 生命 | 动物(牛、猪、羊、鹿)、Kweebec | |
| 死亡 | 骷髅、僵尸、食尸鬼 | |
| 精神 | Slothian、Outlander 术士 | |
| 血液 | 蝙蝠、蚊子 | |
| 混沌 | Outlander 狂战士、Trork 酋长 | |
| 以太 | Ember Spirit | |
| 虚空 | 虚空腐化生物 | |
| 金属 | Firesteel 魔像、坦克、炮塔 | |
| 水晶 | 水晶魔像、Scarak | |
| 毒素 | 蛇、蜘蛛、蝎子 |
5. 核心特性
- 20 种元素: 分为基础、进阶、不稳定与化学层级。
- 模块化 API: 直接注册自定义精华、法术与状态效果。
- 持久状态效果: 基于刻的增益/减益系统(中毒、再生、冰冻、流血等),支持自定义世界逻辑。
- 资源管理: 玩家法力、耐力与自定义属性的状态追踪。
有关元素详情与设计说明,请参阅 ELEMENTS.md。
6. 药水配方
药水在炼金台使用玻璃瓶(Potion_Empty)+ 元素精华 + 次级材料制作(基础制作时间:4 秒)。
| 药水 | 精华 | 数量 | 次级材料 | 数量 |
|---|---|---|---|---|
| 速度 | 风之精华 | 1 | 羽毛(浅色) | 2 |
| 缓慢 | 土之精华 | 1 | 荆棘苔藓 | 2 |
| 急迫 | 闪电精华 | 1 | 水晶(黄色) | 1 |
| 挖掘疲劳 | 土之精华 | 1 | 骨头碎片 | 2 |
| 跳跃提升 | 风之精华 | 1 | 羽毛(蓝色) | 2 |
| 高跳 | 以太精华 | 1 | 羽毛(红色) | 2 |
| 缓降 | 风之精华 | 1 | 羽毛(深色) | 3 |
| 漂浮 | 以太精华 | 2 | 水晶(白色) | 2 |
| 再生 | 生命精华 | 2 | 粉色花朵 | 3 |
| 中毒 | 毒素精华 | 1 | 毒蘑菇 | 2 |
| 衰败 | 死亡精华 | 1 | 骨头碎片 | 3 |
| 燃烧 | 火之精华 | 1 | 木炭 | 2 |
| 反胃 | 混沌精华 | 1 | 绿色蘑菇 | 2 |
| 流血 | 血液精华 | 1 | 水晶(红色) | 1 |
| 冰冻 | 冰之精华 | 1 | 水晶(青色) | 2 |
| 瞬间治疗 | 生命精华(浓缩) | 1 | 红色花朵 | 3 |
| 瞬间伤害 | 虚空精华 | 1 | 爆炸粉末 | 2 |
| 隐身 | 暗影精华 | 2 | 水晶(白色) | 2 |
| 发光 | 光之精华 | 1 | 发光蘑菇(橙色) | 2 |
| 失明 | 暗影精华 | 1 | 水晶(紫色) | 2 |
| 夜视 | 光之精华 | 1 | 发光蘑菇(蓝色) | 2 |
| 水下呼吸 | 水之精华 | 1 | 蓝色珊瑚 | 3 |
| 抗火 | 火之精华 | 2 | 水晶(红色) | 2 |
| 抗性 | 金属精华 | 2 | 水晶(蓝色) | 2 |
| 力量 | 血液精华 | 2 | 水晶(红色) | 2 |
| 虚弱 | 死亡精华 | 1 | 灰色花朵 | 2 |
注:进阶效果需要 2 个精华。
7. 战斗属性系统
RuneCore 在原生战斗计算之上实现了 RPG 伤害流水线。
自定义属性可注册。玩家拥有持久属性数值,而生物则通过静态注册表查询获取属性。
属性类型
| 类别 | 属性 | 描述 |
|---|---|---|
| 进攻 | 物理伤害 | 受目标护甲减免 |
| 进攻 | 魔法伤害 | 受目标魔法抗性减免 |
| 进攻 | 真实伤害 | 无视减免(被护盾阻挡) |
| 进攻 | 护甲穿透 | 无视目标一部分护甲 |
| 进攻 | 魔法穿透 | 无视目标一部分魔法抗性 |
| 防御 | 护甲 | 减少受到的物理伤害 |
| 防御 | 魔法抗性 | 减少受到的魔法伤害 |
| 防御 | 伤害减免 | 对受到伤害的固定百分比减免(上限 90%) |
| 防御 | 护盾生命值 | 在基础生命值之前消耗的临时生命值 |
伤害公式
effectiveDefense = max(0, defense - penetration)
reducedDamage = rawDamage × 100 / (100 + effectiveDefense)
finalDamage = (physReduced + magReduced) × (1 - damageReduction%) + trueDamage
命中会经过 DamagePipeline,允许外部模组插入自定义修饰器(例如暴击、吸血)。
生物伤害(PvE)
生物在攻击或受到伤害时从 CreatureCombatRegistry 拉取档案。未注册的生物回退到标准 DamageCause 检查。
| 伤害档案 | 公式 | 示例 |
|---|---|---|
| 物理 | 受护甲减免;可使用护甲穿透 | Trork、骷髅战士、狼、熊 |
| 魔法 | 受魔法抗性减免;可使用魔法穿透 | 骷髅法师、怨灵、死灵法师 |
| 混合 | 按物理/魔法比例拆分,分别计算 | 火龙、水晶火焰魔像 |
| 真实 | 绕过护甲/抗性(被护盾吸收) | — |
按族群划分的生物防御
| 族群 | 护甲 | 魔法抗性 | DR | 备注 |
|---|---|---|---|---|
| 野生动物 | 2 | 0 | — | 无护甲基础生物 |
| 僵尸 | 4 | 2 | — | 低物理/魔法抗性 |
| 灵体 | 4 | 32 | — | 无形体(高魔法抗性) |
| 哥布林 | 5 | 3 | — | 轻型皮甲 |
| Trork | 6 | 0 | — | 物理近战为主 |
| Feran | 8 | 8 | — | 属性均衡 |
| 骷髅 | 10 | 4 | — | 中等护甲 |
| Outlander | 12 | 6 | — | 装备精良的掠夺者 |
| 虚空 | 12 | 28 | — | 高魔法抗性 |
| Scarak | 18 | 4 | — | 甲壳板(高护甲、低魔法抗性) |
| 龙 | 32 | 28 | — | 高抗性基础 |
| 魔像 | 34 | 12 | — | 高护甲基础 |
| Boss | 40 | 34 | 15% | 高防御 + 固定百分比减免 |
装备集成
护甲在装备时应用属性(按部位缩放:胸甲 100%、腿甲 85%、头盔 70%、手甲 50%)。武器在命中时应用进攻属性。
按层级划分的护甲缩放
| 层级 | 材料 | 护甲(胸甲) | 魔法抗性(胸甲) |
|---|---|---|---|
| 1 | 布料、木材 | 4–8 | 10–20 |
| 2 | 轻皮、铜 | 10–14 | 8–10 |
| 3 | 重皮、青铜、铁 | 18–25 | 5–8 |
| 4 | 钢、钴 | 30–35 | 5–7 |
| 5 | 秘银、钍 | 42–45 | 12–14 |
| 6 | 精金、缟玛瑙、棱镜 | 50–58 | 18–22 |
按层级划分的武器伤害(物理示例)
| 材料 | 剑 | 长剑 | 斧 | 战斧 | 匕首 |
|---|---|---|---|---|---|
| 木材 | 6–8 | 12 | 10 | 14 | 6 |
| 铜 | 14 | 20 | 16 | 22 | 10 |
| 铁 | 22 | 30 | 24 | 32 | 18 |
| 钢 | 28 | — | — | 34 | — |
| 秘银 | 38 | 50 | 40 | 52 | 30 |
| 精金 | 50 | 65 | 52 | 68 | 40 |
管理员命令
/combatstats view
/combatstats set <stat> <value>
/combatstats add <stat> <value>
/combatstats reset [all|modifiers|<stat>]
支持的标识符:armor、magicresist(mr)、reduction(dr)、physdmg(phys)、magdmg(mag)、truedmg(true)、armorpen(apen)、magicpen(mpen)、shield。
8. 状态效果与测试
游戏内测试命令:
/rune effect <id>
| 图标 | 状态 | 效果 ID | 原生视觉 | 描述 |
|---|---|---|---|---|
| [x] | speed |
Speed | 移动速度提升。 | |
| [x] | slowness |
Slowness | 降低移动速度。 | |
| [ ] | haste |
Haste | 攻击/挖掘速度修正(+50%)。 | |
| [ ] | mining_fatigue |
Mining_Fatigue | 攻击/挖掘速度降低(-70%)。 | |
| [x] | jump_boost |
Jump_Boost | 提升跳跃高度。 | |
| [x] | high_jump |
High_Jump | 显著提升跳跃高度。 | |
| [x] | slow_falling |
Slow_Falling | 降低下落速度。 | |
| [x] | levitation |
Levitation | 导致向上漂浮。 | |
| [x] | regeneration |
Regeneration | 每 50 刻恢复 1 HP。 | |
| [x] | poison |
Poison | 每 25 刻造成 1 HP 伤害。 | |
正在加载版本记录…
















正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。