核心配置
位于 mods/Siren_Cultivation/ 根目录、不在任何文件夹之内的三份文件：Config.json、UpdateConfig.json 与 WebStoreConfig.json。Config.json 承载着推导出每个境界与子阶段所需灵气的那条曲线、修士每攀升一级所得的固定属性加成，以及六项突破品质调节。若你只打算改动一份文件来让服务器更难或更宽松，那就是它。曲线产出的结果见境界与阶段，灵气本身从何而来见聚灵采气。
UpdateConfig.json 是更新检查器的唯一开关，WebStoreConfig.json 则配置宝阁权益同步。二者与 Config.json 并列置于根目录，是因为它们关乎服务器本身而非修炼：寻找网络开关的服主，理应最先遇到它。
这里的每份文件在游戏内 /cultivation admin 编辑器中都有对应板块，不过编辑器并未涵盖每一个键 —— 下文每一节都会说明涵盖了哪些。其余配置文件夹见修炼配置、功法配置、宗门社群配置、种族配置与存档文件；总览列出了每一份文件。
Config
核心灵气曲线、每级属性加成、突破品质各项调节，以及气息、屏显通告与修炼卷的全服开关，位于路径 mods/Siren_Cultivation/Config.json。
游戏内编辑器：「修炼」板块涵盖灵气曲线、两项每级加成与 Admin-Backups-Per-Player。突破品质的各项调节、气息／通告／修炼卷开关与 Npc-Interaction-Hints-Enabled 需在文件中编辑。
| 配置项 | 默认值 | 说明 |
|---|---|---|
| "ConfigName" | "Cultivation Config" | 此配置文件的名称。 |
| "ConfigVersion" | 6 | 你为此插件加载时的当前版本。 |
| "Base-Qi-Requirement" | 175.0 | 从最初的子阶段（炼体·初期）进阶所需的灵气量。曲线中其余每一项需求都以这个基数缩放。 |
| "Description-Base-Qi-Requirement" | 一段解释上述数值的长字符串。 | 重述这是第一个子阶段的需求，且整条曲线都由它缩放而来。 |
| "Substage-Growth-Rate" | 1.55 | 在一个境界之内每攀升一个子阶段（初期 → 中期 → 后期 → 巅峰），灵气需求所乘的倍率。 |
| "Realm-Base-Multiplier" | 4.25 | 每达到一个境界，灵气需求所乘的倍率，叠加在子阶段增长之上。 |
| "Realm-Breakthrough-Multiplier" | 5.5 | 仅在境界突破（巅峰 → 下一境界的初期）的灵气消耗上额外施加的倍率，叠加于常规曲线之上。 |
| "Description-Realm-Breakthrough-Multiplier" | 一段解释上述数值的长字符串。 | 说明正是这一层额外倍率，让境界突破远比一次寻常的子阶段进阶更为郑重。 |
| "Health-Bonus-Per-Level" | 4.0 | 每获得一个总子等级（境界 × 4 + 阶段）所加的最大生命值。 |
| "Damage-Percent-Bonus-Per-Level" | 2.0 | 每获得一个总子等级所增的伤害百分比。 |
| "Breakthrough-Impurity-Max-Penalty-Percent" | 10.0 | 灵气纯度。一次完全由灵核、玄核与神核供养的境界突破，所能承受的最大生命与伤害惩罚。对于完全由其余一切灵气来源供养的突破，它会线性缩减至 0。 |
| "Difficulty-Simple-QiCostPercent" | -7.0 | 修行难度。选择简单的修士，每次进阶的灵气消耗所变动的百分比。负值即更便宜。默认难度没有对应的键 —— 它固定为 0，即今日之数。 |
| "Difficulty-Simple-StrengthPercent" | -10.0 | 在简单难度下，一次完成的进阶所锁定的强度所变动的百分比。负值即更弱。 |
| "Difficulty-Difficult-QiCostPercent" | 10.0 | 选择困难的修士，每次进阶的灵气消耗所变动的百分比。正值即更贵。 |
| "Difficulty-Difficult-StrengthPercent" | 10.0 | 在困难难度下，一次完成的进阶所锁定的强度所变动的百分比。正值即更强。 |
| "Tribulation-Performance-Min-Percent" | -1.0 | 你如何应对。一场天劫所能留下的最差突破品质修正，以百分比计：当生命降至最大值的三分之一或更低，且药剂使用达到或超过下方上限时触及。 |
| "Tribulation-Performance-Max-Percent" | 1.5 | 最佳修正，以百分比计：满血走完天劫、且未依赖药剂时触及。二者之间按线性缩放。 |
| "Tribulation-Performance-Potion-Cap" | 4 | 要用掉多少枚丹药（避劫丹除外，它另付自己的代价），才算对上述修正而言完全依赖药剂。 |
| "Auspicious-SecretRealm-Percent" | 1.5 | 时机。在已开启的秘境之内突破所得的加成，以百分比计。 |
| "Auspicious-WeatherResonance-Percent" | 1.0 | 在与你自身大道元素相共鸣的自然天气之下突破所得的加成，以百分比计。时机取二者之较强 —— 只取较强的一项，绝不叠加。 |
| "Sacrifice-Item-Penalty-Percent" | -3.0 | 献祭。一次仪式尝试中，每服下一枚渡劫献祭丹所增加的惩罚，以百分比计。 |
| "Sacrifice-Item-Penalty-Max-Percent" | -15.0 | 上述献祭丹惩罚的下限，使大量重复使用的代价真实却有界。 |
| "Sacrifice-WardPill-Penalty-Percent" | -1.0 | 在尝试中动用一次已存蓄的避劫丹次数所付的固定惩罚，以百分比计。 |
| "Sacrifice-Total-Penalty-Floor-Percent" | -20.0 | 对合计的献祭惩罚（献祭丹加避劫丹）设定的唯一总体下限。 |
| "Breakthrough-Combined-Multiplier-Floor" | 0.25 | 对最终合成的生命与伤害倍率设定的总体下限。种族、灵气纯度、难度与另外四项因素各自被夹紧在自己的区间之内，但除此之外没有任何东西阻止它们的乘积在极端设置下沉向零；这条下限正是为此而设。 |
| "Aura-Enabled" | true | 气息的全服总开关 —— 境界气息与打坐气息皆归其管。只想藏起自己的气息、或不愿看见他人气息的玩家，在设置中另有各自独立的三个开关可用。 |
| "Aura-Pulse-Interval-Seconds" | 4.0 | 每道气息在其所属玩家位置重新生成的间隔。数值限制在 1.0 至 6.0 之间 —— 粒子素材按默认值设计，恰好两次脉冲会有所交叠。 |
| "Aura-Desc" | 一段解释上述数值的长字符串。 | 重述这一全服总开关，与各玩家在设置中独立开关之间的分工。 |
| "Notice-Titles-Enabled" | true | 境界突破、子阶段进阶、跌落境界与宗门变动时所现的全屏标题。聊天栏仍会道出这些标题所现的一切，故关闭它们无损分毫信息。 |
| "Notice-Notifications-Enabled" | true | 较次要时刻所现的角落通知 —— 如解锁一个天赋节点、本命法宝升级、一次洗点，或一场仪式开始。 |
| "Breakthrough-Title-Radius-Chunks" | 9 | 境界突破向周围其他修士播告的范围，以区块计的半径距离。限制在 0 至 32 之间；0 则让每一次突破都只归你私人所知。 |
| "Notice-Desc" | 一段解释上述数值的长字符串。 | 指出无论这些开关如何设置，走火入魔与心魔劫仍各自保有专门撰写的标题。 |
| "Sheet-Hud-Enabled" | true | 修炼卷 —— 一块只读的 HUD，每位玩家以 /cultivation sheet 或在设置中自行开关，立于屏幕右侧。它开着时，小型角落 HUD 会被撤下。由 Inventory-Hud-Enabled 更名而来；旧键会被直接忽略，因此仍带着旧键的文件只会得到此默认值。 |
| "Sheet-Hud-Desc" | 一段解释上述数值的长字符串。 | 指出关闭它在下一 tick 生效，而非下次重启：它会从所有正开着它的人眼前撤去修炼卷，并隐藏设置中的对应一行。修炼卷每隔几秒刷新一次。由 Description-Inventory-Hud 更名而来。 |
| "Npc-Interaction-Hints-Enabled" | true | 当玩家尝试打开某个 NPC 的交互却失败时，是否告知其原因，至多每隔几秒一次。它只在引擎会悄然阻止的情形下触发 —— 未勾选 Allow NPC detection 的创造模式、旁观模式，或处于无实体状态。 |
| "Admin-Backups-Per-Player" | 10 | 每位玩家保留多少份近期的管理员进度备份 —— 即 /cultivation admin 在更改玩家进度时写下、并据以恢复的撤销历史 —— 超出后最旧的一份被丢弃。它们存放于管理员备份数据。 |
更新配置
更新检查器，位于路径 mods/Siren_Cultivation/UpdateConfig.json。Cultivation —— 以及任何向它注册的已安装扩展，如玉简或 SoulRings —— 会向 xianxia.dev 询问各自的当前版本，好让信息页签可以显示，也让管理员得到通知。你的服务器没有任何信息被送出：每次检查都只是对一个静态文件的普通 GET，在后台线程中进行，任何形式的失败都按「没有更新」处理，而不上报。这是本模组中唯一代表服务器访问网络的东西（下文的网店同步除外），这也是它自成一份文件的缘故。
游戏内编辑器：「更新检查」板块涵盖全部三项设置。两个开关在保存后立即生效；改动的间隔则自下次重启起生效。
| 配置项 | 默认值 | 说明 |
|---|---|---|
| "ConfigName" | "Update Config" | 此配置文件的名称。 |
| "ConfigVersion" | 1 | 你为此插件加载时的当前版本。 |
| "Update-Check-Enabled" | true | 总开关。关闭即绝不发起任何请求 —— 而非发起请求后把答复丢弃。 |
| "Announce-Updates-To-Admins" | true | 结果是否送达游戏中的任何人。关闭时，检查照常运行、启动时仍会在控制台写下一行，但上线时不会通知任何人。开启时，持有 cultivation.admin 的玩家每次会话会被告知一次，所有落后的模组一并列于同一条消息之中。若某模组已安装的版本列在它自己清单的 ignore 数组里，则永不为其播报。 |
| "Update-Check-Interval-Hours" | 6 | 两次重新检查之间相隔多久。限制在 1 至 168 小时（一周）之间。无论如何，首次检查会在启动后不久进行。 |
| "Update-Check-Desc" | 一段解释上述数值的长字符串。 | 重述上述三条规则：开关根本不发起请求，播报开关只控制游戏内的消息，间隔自下次重启起生效。 |
网店配置
宝阁权益同步，位于路径 mods/Siren_Cultivation/WebStoreConfig.json。服务器会定期读取每件商品一份公开的、有权玩家 UUID 名单 —— 一次普通的 GET，不送出任何信息 —— 并应用相应的权益。
游戏内编辑器：「网络商店」板块涵盖四个开关与数值。Base-Url 与 Disabled-Benefits 需在文件中编辑。
| 配置项 | 默认值 | 说明 |
|---|---|---|
| "ConfigName" | "Web Store Config" | 此配置文件的名称。 |
| "ConfigVersion" | 1 | 你为此插件加载时的当前版本。 |
| "Description" | 一段解释以下数值的长字符串。 | 重述同步的作用与由哪些键控制：开关实时检查、无需重启，间隔为 1–168 小时、需重启方可生效，复查指令设有权限门槛与频率限制。 |
| "Web-Store-Enabled" | true | 总开关。关闭则绝不发起任何请求，也绝不应用任何权益。 |
| "Check-Interval-Hours" | 6 | 权益名单多久重新读取一次。退款会在下一次读取时自行撤销。 |
| "Allow-Recheck-Command" | true | 是否允许 /cultivation store recheck 强制提前读取。 |
| "Recheck-Cooldown-Seconds" | 60 | 该指令的频率限制。 |
| "Base-Url" | "https://xianxia.dev/api/get/entitlements/" | 公开账号 ID 名单的读取地址。绝不会送出任何关于你服务器的信息。 |
| "Disabled-Benefits" | [] | 本服要拒绝的个别权益键名，其余同步照常运作 —— 可以是商品别名（cultivation-sacred-bodies），也可以是订阅家族键名（sub_cultivation），也可以是仅限买断的键名（once_cultivation-sacred-bodies）。 |
最近一次成功读取的结果会缓存在网店数据中，因此在 xianxia.dev 宕机时启动的服务器，仍会沿用它最后见到的那份名单。
无尽等级兼容
Compatibility/ 文件夹中的唯一一份文件，位于路径 mods/Siren_Cultivation/Compatibility/EndlessLevelingConfig.json。它虽不在根目录，却列在此处，因为它是一份关乎服务器而非修炼的单独文件。Cultivation 与 Endless Leveling 都会提升最大生命与输出伤害，放任不管，二者便会相乘。开启对接后，Cultivation 不再自行施加该项属性，而是把它发布到 Endless Leveling 自己的外部加成通道，于是 Endless Leveling 只做一次、且已包含 Cultivation 那一份的计算。该文件除非已安装 Endless Leveling，否则不起作用 —— 每个值都只在确认该模组存在之后才被读取。对接如何运作见模组兼容。
游戏内编辑器：「无尽等级」板块涵盖除 Handoff-Protection 之外的四项对接设置，且在未安装 Endless Leveling 时整节隐藏。
| 配置项 | 默认值 | 说明 |
|---|---|---|
| "ConfigName" | "Endless Leveling Compatibility" | 此配置文件的名称。 |
| "ConfigVersion" | 1 | 你为此插件加载时的当前版本。 |
| "Handoff-Health" | true | 将最大生命交予 Endless Leveling 的 LIFE_FORCE 通道。默认开启：两个模组悄悄地相乘彼此的成长，是服主得先察觉、才能选择退出的缺陷，而一次统一结算，才是同时安装二者的人所预期的。 |
| "Handoff-Damage" | true | 将输出伤害交予 Endless Leveling 的外部伤害加成。 |
| "Handoff-Protection" | true | 将炼体的减伤交予 Endless Leveling 的 DEFENSE 属性，使两个模组不会各自独立地削减受到的伤害。 |
| "Handoff-Health-Scale" | 1.0 | 微调交出的生命量，使同时运行两个模组的服务器无需重调 Cultivation 配置（仅装 Cultivation 的服务器也读取同一份），即可重新平衡。1 即交出 Cultivation 自行施加时的全部数值；0.5 则交出一半。 |
| "Handoff-Damage-Scale" | 1.0 | 对伤害的同样微调。 |
| "Description-EndlessLeveling" | 一段解释上述数值的长字符串。 | 乘算问题与对接。把某项对接设为 false，即回到由 Cultivation 自行施加该项属性 —— 单独运行时正确，两个模组同装时则叠在 Endless Leveling 之上。Cultivation 的种族、天赋树与功法倍率不会交出；它们在发布之前就已乘进 Cultivation 自己的那一份，一如既往。 |
关于曲线
某一次升级所需的灵气，是 Base-Qi-Requirement 在境界内每个子阶段按 Substage-Growth-Rate 增长、每已达到一个境界按 Realm-Base-Multiplier 增长的结果；仅当这次升级是境界突破时，才在其上再叠一层 Realm-Breakthrough-Multiplier。调高 Substage-Growth-Rate 会让境界内的攀爬更陡；调高 Realm-Base-Multiplier 则会拉大境界之间的鸿沟。
另有两套系统会削减玩家实际付出的量：第 8 层的「灵气消耗减免」天赋属性（其上限由天赋树配置中的 Qi-Cost-Reduction-Cap-Percent 约束），以及种族的 Qi-Gain-Rate-Percent-Bonus（见种族配置）—— 后者提高的是收入，而非降低成本。随后，玩家所选的难度会对余下的部分增减一个百分比（即上文的 Difficulty-*-QiCostPercent）。
这两项属性加成是按总子等级施加的，计法为 realm * 4 + stage，因此它们在整条进阶之路上平滑增长，而不是只在境界交界处跳一下。来自 Health-Bonus-Percent 与 Damage-Bonus-Percent 的种族加成叠加其上，境界突破时的六项突破品质因素亦然 —— 全部相乘，并被压在 Breakthrough-Combined-Multiplier-Floor 之上。