外观
设定来源索引
「玩家设定 →」按可信度排序的 5 类设定来源(DESIGN 2.2)完整文件清单。页面数值冲突时以优先级高的来源为准:yml 运行时配置 > DB 迁移最终态 > Java 常量 > balance 内置默认 > 旧 docs。
1. 来源 1:运行时配置(最高权威)
| 文件 | 内容 | 提取产物 |
|---|---|---|
emberfall-server/src/main/resources/application.yml | emberfall.* 全量键(trial.v2 全量、notice、ranking、growth-tower 调度、long-battle) | data/yml/application.json |
emberfall-server/src/main/resources/application-prod.yml | 生产环境变量注入(EMBERFALL_*) | data/yml/application-prod.json |
emberfall-server/src/main/resources/application-dev.yml / application-test.yml | 本地/测试环境(不可作为线上事实) | — |
⚠️
emberfall.long-battle.time-scale生产必须为 1;trial.v2.enabled生产默认 false 需显式开启。
2. 来源 2:DB 配置表最终态(迁移累计效果)
配置表 seed 来源迁移:V47__balance_300d_v1.sql(7 表)、V66__companion_stage_config.sql(3 表)、V81__add_trial_balance_growth_config.sql、V85__add_secret_realm_balance_growth_config.sql、V64__equipment_attribute_refactor.sql(门槛修正)、V53(面额×10)、V69~V71(淬炼)、db/init.sql(tower_config 等幂等 seed)。
| 表 | 数据产物 | seed 位置 |
|---|---|---|
game_balance_version | data/sql/game_balance_version.json | V47:3-12 |
realm_balance_config | data/sql/realm_balance_config.json | V47:14-37(V64 修正) |
system_growth_config | data/sql/system_growth_config.json | V47:39-188(V53/V69~V71/V81/V85 重放) |
combat_anchor_config | data/sql/combat_anchor_config.json | V47:190-210 |
monster_tier_config | data/sql/monster_tier_config.json | V47:212-219 |
stone_source_config | data/sql/stone_source_config.json | V47:221-233 |
tower_config | data/sql/tower_config.json | db/init.sql:482-513 |
sys_stage_config | data/sql/sys_stage_config.json | V66:1-18 |
sys_stage_global | data/sql/sys_stage_global.json | V66:19-28 |
人工登记覆盖:data/sql/manual-overrides.json(TRIBULATION=783,619,427 等,提取器重放时应用)。
3. 来源 3:Java 常量类(domain/*Rules.java、config/*Config.java)
data/rules/*.json 与源码对应表(28 个产物,data/rules/):
| 产物(NumTable data 键) | 源码文件 |
|---|---|
rules/AdvanceRules | domain/AdvanceRules.java |
rules/AscensionRules | domain/AscensionRules.java |
rules/BodyTemperingRules | domain/BodyTemperingRules.java |
rules/BossAffixRules | domain/BossAffixRules.java |
rules/BossPhaseRules | domain/BossPhaseRules.java |
rules/CompanionDungeonRules | domain/CompanionDungeonRules.java |
rules/CompanionGrowthRules | domain/CompanionGrowthRules.java |
rules/EndlessTrialRules | domain/EndlessTrialRules.java |
rules/EnhancementGoldRules | domain/EnhancementGoldRules.java |
rules/GoldDungeonRules | domain/GoldDungeonRules.java |
rules/GoldExchangeRules | domain/GoldExchangeRules.java |
rules/InheritRules | domain/InheritRules.java |
rules/LawEnlightenmentRules | domain/LawEnlightenmentRules.java |
rules/LawRules | domain/LawRules.java |
rules/ProgressionLevelCostRules | domain/ProgressionLevelCostRules.java |
rules/RealmAbyssRules | domain/RealmAbyssRules.java |
rules/ReferralRules | domain/ReferralRules.java |
rules/SecretRealmBuffConfig | config/SecretRealmBuffConfig.java |
rules/SecretRealmConstants | domain/SecretRealmConstants.java |
rules/SecretRealmEventConfig | config/SecretRealmEventConfig.java |
rules/SecurityConfig | config/SecurityConfig.java |
rules/ShopBalanceRules | domain/ShopBalanceRules.java |
rules/StoneStrengthRules | domain/StoneStrengthRules.java |
rules/TitleRules | domain/TitleRules.java |
rules/TradeRules | domain/TradeRules.java |
rules/WebConfig | config/WebConfig.java |
rules/WorldBossRules | domain/WorldBossRules.java |
无提取产物的关键常量类(技术页以 CodeFact 引用原文):
Realm、Equipment、EquipmentRefineEntryType、MentalMethodChapterConfig、MentalMethodType、LawType、MonsterTier、PrivilegeTier、VipExperienceSource、TrialEntryRules(遗留)等。
4. 来源 4:balance/ 注册表内置默认
| 文件 | 说明 |
|---|---|
balance/BalanceConfigRegistry.java | 内置默认(defaultRealmBalances 等) + validate() 启动强校验(渡劫门槛 783,619,427、锚点、轨道闭合) |
balance/BalanceConfigService.java | 启动加载 game_balance_version 覆盖内置默认;require-database-config=true 时失败拒绝启动 |
balance/RealmBalance.java、balance/SystemGrowthBalance.java、balance/CombatAnchor.java、balance/MonsterTierBalance.java、balance/BalanceTrack.java | 值类型与 15 条成长轨道定义 |
DB 与内置默认同源(seed 由内置默认导出),DB 覆盖后以内置默认仅作兜底。
5. 来源 5:旧 docs/(仅历史参考)
仓库根 docs/ 下 53 份设计文档(00_系统总览与集成.md、13_等级与境界系统.md、35_余烬试炼场玩法设计文档.md、肉鸽秘境玩法设计.md、23_全局数值重构设计_300日版本.md 等)。与代码冲突处一律走 差异审计(D1~D7),不得直接采用。
6. 数据管线产物总览
| 产物 | 来源 | 说明 |
|---|---|---|
data/rules/*.json(28) | scripts/extract-rules.mjs 解析常量类 | 每文件含 source{path,sha256,mtime,commit} 与 constants[] |
data/yml/*.json(2) | scripts/extract-balance.mjs 解析 yml | emberfall.* 子树 |
data/sql/*.json(9) | scripts/extract-sql-seed.mjs 重放迁移 | 配置表最终态 + manual-overrides |
data/items-name-map.json | 人工维护 | 物品 ID → 中文名(设定文档资产) |
data/manifest.json / data/verify-report.json / data/unparsed.json | 提取与校验元数据 | 新鲜度/覆盖率/配对校验 |
| 解析失败清单 | data/unparsed.json | 当前为空(全部解析成功) |