符文种族

符文种族

这是 Runecraft 整合包的一款旗舰级起源(Origins)附属模组。涵盖 7 个家族、共 37 个精心设计的种族，每个种族拥有恰好一个主动技能、一个被动优势和一个弱点——并包含环境交互效果，以及与 Runecraft 模组生态系统的深度整合。先选择一个 家族，再从中选择一个 种族。若安装了 Pehkui，每个种族还拥有独立的 身高 (范围 0.45–1.30)，并按家族聚类，便于玩家小队一目了然。

Minecraft 1.20.1 | Forge | 需要 Origins Forge

种族

人类 (4 个) — 适应性强的全能者

种族	主动技能	被动 / 弱点
原初者	幸运一击	幸运 + 适应力 / 无专精
速行者	信使之跃	速度与机敏 / 脆弱身躯
魔导士	奥术溢出	魔法亲和 / 体弱多病
坚壁者	不屈之盾	装甲壁垒 / 行动迟缓

精灵 (5 个) — 奥术优雅，躯体脆弱

种族	主动技能	被动 / 弱点
高等精灵	奥术反射	奥术精通 / 身体孱弱
暗精灵	暗影融合	暗夜之力 / 惧光
月精灵	月华面纱	月潮魔法 / 日间衰弱
血精灵	血之狂乱	血术吸血 / 治疗降低
冰精灵	寒冰束缚	冰霜精通 / 畏惧火焰

矮人 (6 个) — 坚韧，地下居民

种族	主动技能	被动 / 弱点
深黯者	震颤感知	夜视矿工 / 惧光
熔炉者	熔炉赐福	火锻工匠 / 水中笨重
寒冰者	冰川决意	免疫寒冷 / 畏惧火焰
铁壁者	盾墙	堡垒坦克 / 缓慢且魔法亲和低
天穹者	群山腾跃	稳健攀岩者 / 幽闭恐惧
符文者	防护符文	符文工匠，团队支援 / 学者体质

兽类 (6 个) — 敏锐感官，掠食本能

种族	主动技能	被动 / 弱点
蛛形族	蛛网陷阱	毒液与振动感知 / 畏惧火焰
羽族	暴风冲击	羽翼飞行 / 中空骨骼
犬族	狼群之嚎	群体狩猎者 / 食量巨大
猫族	猛扑	九命 / 畏水
狐妖	狐火幻象	狐灵魔法 / 灵体脆弱
蛇族	蜕皮	毒液与热感 / 冷血

妖精 (5 个) — 魔法、幻术，常有翅膀

种族	主动技能	被动 / 弱点
变形怪	镜面移位	千面 / 身份空洞
树精	翠绿绽放	丛林治疗者 / 3 倍火伤
小仙子	相位移动	轻纱飞行 / 玻璃大炮
宁芙	塞壬魅惑	水之精灵 / 束缚于水
妖精	妖精契约	精灵魅惑 / 畏冷铁

亡灵 (5 个) — 亡灵免疫，暗夜之力

种族	主动技能	被动 / 弱点
僵尸	亡灵饥渴	不死之躯 / 日间腐朽
骷髅	征召亡灵	墓仆召唤师 / 骨骼脆弱
怨灵	灵体相位	灵魂触碰 / 畏惧日光与神圣
恶魔	炼狱怒火	炼狱之火 / 畏惧神圣与水
收割者	灵魂收获	死亡复活 / 治疗效果降低 50%

龙族 (6 个) — 元素吐息，鳞甲，飞行

种族	主动技能	被动 / 弱点
火龙	龙焰吐息	火焰免疫 / 畏惧寒冷与水
冰龙	冰霜吐息	冰冻免疫 / 畏惧火焰
海龙	潮汐吐息	海洋巨兽 / 陆地束缚
土龙	震地吐息	活体岩石 / 行动笨重
雷龙	闪电吐息	雷霆速度 / 畏惧接地与湿润
风龙	暴风吐息	极致飞行者 / 畏惧地下封闭

模组整合

所有整合均为可选，并可在配置中开关。若某模组缺失，其对应功能将被静默跳过。

模组	整合内容
Ars Nouveau	施法者：法术消耗减少 15%，最大魔力增加 20%。铁壁者：法术消耗增加 10%
Iron's Spellbooks	每个种族有独立的法术伤害修正（魔导士 +15%，铁壁者 −10%）；为魔导士的 30 魔力施法消耗提供支持
Curios	精灵族额外 +项链栏，矮人族额外 +腰带栏，妖精族额外 +戒指栏，亡灵族额外 +护符栏
Apotheosis	幸运值修正（原初者/妖精 +1，风龙 −2）
Pehkui	每个种族独立的身高/缩放比例，从 0.45（小仙子）至 1.30（土龙）
Feather's	每个种族独有的最大羽毛值；振翅消耗羽毛（消耗 1，风龙消耗 2 — flight.flapStaminaCost）

需要消耗可选模组资源的能力，在该模组缺失时会优雅降级——已发布的能力通过 runic_races:resource_available 对资源门控进行了封装，因此（例如）魔导士的奥术溢出在独立安装时仅剩冷却时间效果，而不会静默失效。

安装

1. 需要在整合包中安装 Origins Forge (1.10.0.9+)
2. 将 runic_races-1.6.0.jar 放入 mods/ 文件夹（客户端和服务端均需要）
3. 若存在旧版 KubeJS Runic Races 数据包，请移除 (kubejs/data/runic_races/)
4. 已有玩家若保留了种族名称，其选择将继续保持

配置

配置文件生成于 config/runic_races/ 目录：

• runic_races-server.toml — 整合开关，资源门控策略（failClosedWhenResourceModMissing 默认为 true，确保独立游玩体验可预测；若整合包保证拥有 Iron's Spellbooks / Feather's 模组，可设为 false）
• runic_races-client.toml — 种族 HUD（锚点、偏移、缩放、透明度、精简模式、技能名称、就绪发光效果），环境状态效果（被动状态粒子、屏幕提示），以及状态符文脉冲
• runic_races-common.toml — 调试日志；disableDefaultOriginLayer（见下方起源兼容性说明）

起源(Origins)兼容性

默认情况下，符文种族仅显示其家族 → 种族二层选择界面，并隐藏原版 origins:origin 层——这正是大多数其他起源附属模组注册其起源的位置，因此这些起源不会显示。若发生此情况，服务端日志会在启动时发出警告，列出所有被隐藏的起源以及配置修复方法，确保问题不会静默发生。

让其他起源模组共存

在 runic_races-common.toml 中将 disableDefaultOriginLayer = false。其他附属模组的起源将随家族/种族一起重新出现在标准起源界面中。这是通过内置数据包实现并通过配置开关控制的，因此更改需在世界加载时读取——请退出至标题画面并重新进入（或重启服务端）以使更改生效；仅 /reload 命令无效。

向符文种族家族添加起源

起源会跨数据包合并层成员资格，因此一个数据包可以通过 "replace": false 将起源（来自任何模组，或您自己的）追加到某个家族的种族列表中。请参阅位于 examples/datapacks/runic_races_extra_races/ 的即用模板。注意：注入的外部起源会保留其自身能力，但不会被视为原生种族（无符文种族 HUD/通知/缩放/Curios 栏位）。

键位设置

符文种族在原版控制界面中添加了 符文种族 类别：

• 振翅 (默认未绑定) — 滑翔时，按下可向上振翅
• 收翼 (默认未绑定) — 滑翔时，按下可取消滑翔

若两者均未绑定，则遗留的备用方案仍生效：滑翔时，按 跳跃 键振翅，在 4 tick 内双击 跳跃 键可收翼。

振翅仅在滑翔过程中有效（服务端会拒绝其他情况），且若安装了 Feather's 模组，每次振翅会消耗羽毛——羽毛耗尽时翅膀会拒绝工作并显示红色横幅，直至恢复。

吐息武器 是物理锥体：它们有意会击中中立和被动生物（需要瞄准技巧作为对抗手段），但绝不会击中队友、PvP 保护的玩家或任何人的宠物。

命令

• /runicraces info [玩家] — 显示已选择的种族
• /runicraces list — 按家族列出所有 37 个种族
• /runicraces debug — 显示当前属性值
• /runicraces validate — (op) 交叉检查种族注册表与已加载的起源/能力——在编辑数据包后执行
• /runicraces state <玩家> — (op) 转储玩家当前的种族状态（标记、冷却时间、适应性层数）

设计理念

• 种族 = 你的本质（永久身份，非成长路线）
• 种族特质静态不变，不随进度缩放——避免与技能/神祇系统竞争
• 缺点通过“理所当然”检验——每一项惩罚都有叙事上的合理性
• 通过亲和力而非门控进行整合——种族使路径更顺畅，而非阻塞路径
• 每个种族改变的是你的玩法方式，而不仅仅是玩得好坏

构建

# 将仅编译时依赖的 jar 文件放入 Dependencies/ 目录（已加入 gitignore），然后：
./gradlew build
# 输出文件：build/libs/runic_races-1.6.0.jar

必需依赖： origins-forge，apoli-forge，calio-forge。Apoli 和 Calio 已打包在 Origins 的 -all jar 文件中的 META-INF/jarjar/ 目录下——请提取它们：unzip -o -j Dependencies/origins-forge-*-all.jar 'META-INF/jarjar/apoli-forge-*.jar' 'META-INF/jarjar/calio-forge-*.jar' -d Dependencies/。

可选依赖（仅编译其整合类时需要）：ars_nouveau，irons_spellbooks，curios（来自 Modrinth 的本地 jar 文件）。Apotheosis、Pehkui 和 Feathers 可通过 Maven（CurseMaven / Modrinth）自动解析——无需本地 jar 文件。