符文核心

符文核心

一个模块化且可扩展的Hytale魔法引擎,引入元素精华、自定义RPG战斗属性和持久状态效果。

杂项

RuneCore

可扩展的魔法系统引擎与框架,适用于 Hytale 模组。

RuneCore Banner

项目状态:开发中

  • 进行中: 自定义状态效果的药水与制作配方。
  • 已可用: 核心命令、玩家状态管理与精华掉落系统。
  • API: 测试阶段。
  • 视觉: 自定义标志与精华图标。3D 模型使用复用的游戏资源。
  • 下一步: 完整的 RuneAlchemy 系统与药水酿造流水线。

1. 概述

RuneCore 将 Hytale 原生基础扩展为模块化引擎,支持元素交互、状态效果、自定义 RPG 属性与炼金配方。该模组既提供开箱即用的机制,也提供可扩展的 API 以便与其他模组集成。

RuneCore Logo      RuneCore Layered Logo

2. 视觉图库

元素精华

药水

状态效果

游戏内效果展示

流血

造成持续伤害,并在玩家画面上施加血色滤镜。
Bleeding Effect


燃烧

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


衰败

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


抗火

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


冰冻

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


发光

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


高跳

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


正常生命值

HUD 上默认的玩家生命值状态。
Normal Health


瞬间伤害

在命中或药水溅射时立即扣除生命值。
Instant Damage Effect


瞬间治疗

立即恢复生命值并更新玩家生命状态。
Instant Health Effect


失明

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

失明视野:
Blindness Effect


漂浮

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

下降 / 坠落:
Levitation Falling


反胃

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

Nausea Stage 2

Nausea Stage 3


夜视

通过动态调整环境光照等级照亮黑暗环境。

关于引擎限制的说明: 由于当前 Hytale 服务器 API 的限制,动态光照组件影响的是目标实体周围的全局场景光照,而非应用每客户端的后处理着色器。


**夜晚环境(无效果):**
Dark Night

**夜视激活:**
Night Vision Active

中毒

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

效果结束后:
Poison Ended


再生

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

完全恢复:
Regeneration Full Recovery


抗性

减少受到的物理与魔法攻击伤害。
Resistance Effect


速度

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

Speed Stage 2


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 伤害。