外观
配置中心
「玩家设定 →」全部运行时配置的权威说明。来源优先级 1：
application*.yml运行时配置 > DB 配置表最终态 > Java 常量 > balance 内置默认 > 旧 docs。
1. application.yml 的 emberfall.* 全量键
1.1 基础设施与通用
| 键 | 生效值 | 用途 | 关联 |
|---|---|---|---|
emberfall.redis.enabled | true | Redis 开关（会话/缓存/签到） | 架构总览 |
emberfall.long-battle.time-scale | 1 | 长线战斗墙钟倍率。生产必须为 1（LongBattleProperties，>1 仅本地联调） | body-tempering、realm-abyss |
emberfall.player.attribute-cache-ttl-seconds | 1800 | 玩家属性缓存 TTL | 属性系统 |
emberfall.jwt.expiration-hours | 168 | 游戏端 JWT 有效期（7 天） | auth |
emberfall.admin.jwt.expiration-hours | 12 | 管理端 JWT 有效期 | admin |
emberfall.balance.require-database-config | true（默认） | 平衡配置强制 DB 加载，失败拒绝启动 | realm |
1.2 成长塔调度（emberfall.growth-tower.*）
| 键 | 生效值 | 用途 |
|---|---|---|
auto-advance.fixed-delay-ms / initial-delay-ms / batch-size | 5000 / 1000 / 200 | 自动推进轮询（5 秒一批 200 人） |
auto-settle.active-delay-ms / active-batch-size / active-threshold-seconds / active-login-window-seconds | 300000 / 50 / 300 / 600 | 活跃玩家 5 分钟高频结算（10 分钟内登录过） |
auto-settle.offline-delay-ms / offline-batch-size / offline-threshold-seconds | 1800000 / 200 / 1800 | 离线玩家 30 分钟兜底结算 |
auto-settle.thread-pool-core-size / max-size / queue-size | 2 / 4 / 200 | 异步线程池（CallerRunsPolicy 过载退化同步） |
1.3 排行（emberfall.ranking.*）
| 键 | 生效值 | 用途 |
|---|---|---|
cache-ttl-seconds | 7200 | 排行缓存 |
score-refresh-batch-size / score-refresh-ms | 25 / 300000 | 分数批量刷新（5 分钟） |
snapshot-refresh-ms | 1800000 | 快照落库（30 分钟） |
→ ranking
1.4 公告与喇叭（emberfall.notice.*）
| 键 | 生效值 | 用途 |
|---|---|---|
world-horn.enabled | true | 喇叭开关 |
world-horn.item-id / cost | 9501 / 1 | 消耗世界喇叭物品（兑换价见 horn） |
world-horn.cooldown-seconds / global-cooldown-seconds | 300 / 3 | 个人冷却 / 全服节流 |
world-horn.daily-limit | 30 | 每日发送上限（物品口径；兑换口径为 10，见 ShopBalanceRules.DAILY_WORLD_HORN_LIMIT） |
world-horn.min-level / min-length / max-length | 10 / 2 / 40 | 等级与内容长度门槛 |
world-horn.dup-content-ttl-seconds / send-rate-limit-per-second | 300 / 1 | 内容去重 / 发送限流 |
list.default-limit / max-limit / history-days | 30 / 50 / 14 | 公告列表分页与保留 |
list.list-rate-limit-per-ten-seconds / latest-cache-ttl-seconds | 10 / 5 | 列表限流 / 最新缓存 |
marquee.horn-display-seconds / cache-ttl-seconds | 15 / 15 | 跑马灯展示时长 |
sensitive.enabled / max-repeated-chars | true / 10 | 敏感词过滤与重复字符上限 |
→ horn
1.5 余烬试炼场 v2（emberfall.trial.v2.*）⭐ 全量
由 service/TrialBalanceConfig 绑定（@ConfigurationProperties），启动 validate() 强校验（失败拒绝启动）。分组键与生效值：
| 组 | 键 | 生效值 |
|---|---|---|
| 全局 | enabled / balance-version / game-zone | true / 2026-08-09-v1.4 / Asia/Shanghai |
| 时长 | target-duration / hard-duration / retention-window | PT5M / PT5M / PT15M（硬结束 ≥ 目标） |
| 保留 | request-log-retention-days / replay-retention-days / history-retention-weeks | 7 / 30 / 8 |
| 赛季 | season.tower-reset-cron / season.weekly-reset-day / season.checkpoint-size / season.checkpoint-backtrack-count | 0 0 0 1 * * / MONDAY / 10 / 1 |
| 调度 | scheduler.batch-size / hard-settle-delay-ms / cleanup-cron | 100 / 5000 / 0 20 3 * * * |
| 限流 | damage.min-settle-interval-ms / damage.max-settle-requests-per-minute | 400 / 120 |
| 视觉 | visual.max-attacks-per-second / visual.max-floaters-per-second | 12 / 8 |
| 入场 | entry.base-free / purchase-limit / initial-daily-hard-cap / initial-purchase-price / tower-purchase-price / tower-base-free / tower-purchase-limit | 3 / 2 / 8 / 2000 / 1000 / 2 / 1 |
| 入场加成 | entry.monthly-bonus / vip-per-level-bonus / vip5-bonus / vip10-bonus / lifetime-bonus / naming-bonus | 1 / 0 / 1 / 1 / 1 / 1（vip10-bonus 现按 VIP8 生效；初始试炼满配 8 次、受硬上限约束） |
| 烬塔加成 | entry.tower-monthly-bonus / tower-lifetime-bonus / tower-vip5-bonus / tower-vip10-bonus / tower-naming-bonus | 1 / 1 / 1 / 2 / 2（tower-vip10-bonus 现按 VIP8 生效；不设硬上限，满配免费 9 + 购买 1） |
| 留存 | retention.base / monthly-bonus / vip-enabled-bonus / lifetime-bonus / naming-bonus | 1 / 1 / 2 / 2 / 2 |
| DPS | dps.base-attack / attack-speed-safety-cap / crit-rate-cap / crit-damage-cap / damage-pct-cap / all-damage-pct-cap / monster-damage-pct-cap / final-dps-safety-cap | 1000 / 4.0 / 0.75 / 3.0 / 3.0 / 1.5 / 1.0 / 50000000（v2.1 由 500 万上调至 5000 万，容纳图鉴新加成、支持冲击更高烬塔层数；仍低于理论峰值 ≈1.3 亿，保留安全闸门） |
| 共鸣 | dps.resonance-coefficient / dps.resonance-exponent | 0.139 / 0.7（R(L)=1+0.139×L^0.7） |
| 装备 | equipment.weapon-damage / bracer-attack-speed / ring-crit-rate / medal-all-damage | [1.0,1.1,1.2,1.35] / [0.25,0.50,0.75,1.00] / [0.02,0.04,0.06,0.10] / [0.05,0.08,0.12,0.18] |
| 装备词缀 | equipment.affix-* | damage/attack-speed/crit-rate/crit-damage/elite-boss-damage 各 4 档（0.05~0.25） |
| 有效期 | equipment.validity-weights / week-weight-cap / month-weight-cap | {DAY:0.88, WEEK:0.105, MONTH:0.015} / 0.14 / 0.04 |
| 决策 | decision.option-count.{monster,buff,card,equipment} / initial-card-limit / equipment-reroll-limit | 3/3/3/3 / 10 / 2（interval/deadline 不再使用） |
| 初始 | initial.tier-kills-per-level / max-kills-per-run / final-choice-timeout-seconds | 20 / 5 / 60 |
| 怪物 | initial.monster-hp / monster-weights | [30000,55000,85000,120000] / {STANDARD:0.55, ELITE:0.30, BOSS:0.12, SUPREME:0.03} |
| 掉落 | initial.equipment-base-rate / incomplete-collection-multiplier / completed-collection-multiplier / behemoth-equipment-multiplier / treasure-material-multiplier / mythic-stone-drop-rate / rainbow-stone-settlement-rate | 0.08 / 1.5 / 0.6 / 2.0 / 3.0 / 0.01 / 0.05 |
| 奖励额度 | reward-limit.mythic-stone-free-daily-cap / mythic-stone-free-weekly-cap / rainbow-stone-free-weekly-cap / welfare-ticket-free-daily-cap | 100 / 400 / 400 / 1000（神话石/五彩固定不放大；神话石 = 日顶软顶 100 + 周池容器 400，展示口径 350 + 转结） |
| 点券加成 | reward-limit.welfare-ticket-monthly-bonus / lifetime-bonus / vip5-bonus / vip10-bonus / naming-bonus | +1000 / +2000 / +1000 / +3000 / +3000（vip10-bonus 现按 VIP8 生效；仅福利点券，累加） |
| 共享 | reward-limit.share-mythic-stone-across-modes / share-rainbow-stone-across-modes / gold-dungeon-shared-currencies | true / true / [SPIRIT_GOLD, GOLD, YUANBAO] |
| 循环场 | cycle.resonance-crystal-item-id / drop-rate / quantity / daily-quota / weekend-multiplier / over-cap-rate-multiplier | 9208 / 0.2 / 1 / 100（周末 ×2=200） / 2 / 0.20 |
| 循环场 | cycle.mythic-stone-drop-rate / welfare-ticket-item-id / base-rate / rate-cap / min-quantity / max-quantity | 0.05 / 4001 / 0.5 / 1.0 / 2 / 10（点券仍为 50% 触发，仅提高单次掉落数量） |
| 循环场 | cycle.monster-drop-multipliers | {STANDARD:1.0, BEHEMOTH:2.0, ASSASSIN:1.0, TREASURE:3.0}（虚影不再 ×0.8） |
| 烬塔 | tower.hp-base / hp-growth-segments | 60000 / [{1-50:1.08},{51-100:1.06},{101-200:1.045},{201-∞:1.03}] |
| 烬塔 | tower.reduction-start-floor / reduction-per-floor / reduction-cap / milestones | 50 / 0.0025 / 0.60 / [50,100,200] |
| 烬塔（v1.10） | tower.floor-time-seconds | 10（每层怪物限时秒数，超时未击杀即止步结算；优先于旧整局 5 分钟约定，5 分钟仅作抉择滞留兜底） |
| 烬塔奖励 | tower.reward-rates.floor-rewards | [1-20:100/10/20/0, 21-50:300/30/50/0, 51-100:700/70/100/0, 101-150:1500/150/200/1, 151+:3000/300/400/2]（灵金/黄金/元宝从 1 层起；五彩 100 层以下不掉、101+ 起掉，受日池约束） |
| 烬塔里程碑 | tower.reward-rates.milestone-rewards | 50:20万/20万/20万/200, 100:30万/30万/30万/300, 200:50万/50万/50万/500（每赛季一次，不占日池） |
| 图鉴套装 | collection.level-max-level / level-extra-damage-increment / level-crit-damage-increment / level-crit-rate-increment / level-all-damage-increment / level-doubler-increment / level-upgrade-* | 100 / 0.02 / 0.04 / 0.009 / 0.02 / 0.01 / 3, 1.5, 0.03（v2.1 重做：升级链 T1→T2→T3→T4，前置满级才可升下一项；T1 正常额外伤害 / T2 暴击 / T3 全伤 / T4 翻倍，各 100 级；消耗共鸣结晶 9208，旧等级数据已清空） |
| 共鸣养成 | resonance.max-level / upgrade-costs | 30 / cost(L)=10+2L+L²，累计 9725 |
→ ember-trial、
1.6 其他非 emberfall.* 键
| 键 | 生效值 | 用途 |
|---|---|---|
referral.v2.enabled | true | 推荐返利 v2 开关（V58） |
server.port / server.forward-headers-strategy | 8080 / FRAMEWORK | 服务端口与反代头 |
spring.flyway.* | enabled=true、baseline-on-migrate=true | 迁移开关 |
| 生产环境变量 | EMBERFALL_MYSQL_URL、EMBERFALL_JWT_SECRET、EMBERFALL_ADMIN_JWT_SECRET、EMBERFALL_TRIAL_V2_ENABLED（默认 false）、EMBERFALL_TRIAL_PREVIEW_TOKEN_SECRET（必填） | application-prod.yml 注入 |
2. DB 配置表（9 张，data/sql/ 产物）
| 表 | 数据产物 | 用途 | 来源迁移 |
|---|---|---|---|
game_balance_version | game_balance_version.json | 生效平衡版本（300D_V1） | V47 |
realm_balance_config | realm_balance_config.json | 十境数值 | V47（V64 修正） |
system_growth_config | system_growth_config.json | 成长轨道（15 条 track × 10 境） | V47（V53×10、V69~V71、V81/V85） |
combat_anchor_config | combat_anchor_config.json | 战斗锚点 | V47 |
monster_tier_config | monster_tier_config.json | 怪物五档 | V47 |
stone_source_config | stone_source_config.json | 磐石精华来源 | V47 |
tower_config | tower_config.json | 塔配置（含停用行） | V3 + db/init.sql seed |
sys_stage_config | sys_stage_config.json | 阶段开放（坐骑/翅膀/灵兽） | V66 |
sys_stage_global | sys_stage_global.json | 全局阶段开关 | V66 |
3. @ConfigurationProperties 类（config/ 与 service/）
| 类 | 前缀 | 说明 |
|---|---|---|
config/LongBattleProperties | emberfall.long-battle | time-scale 墙钟倍率（生产必须 1；isAccelerated() 判定） |
config/NoticeProperties | emberfall.notice | 喇叭/公告/跑马灯/敏感词全量键 |
service/TrialBalanceConfig | emberfall.trial.v2 | 余烬试炼场 v2 全量（13 个嵌套分组 + validate() 校验） |
config/SecretRealmBuffConfig / config/SecretRealmEventConfig | —（普通 @Component） | 秘境 35 祝福 / 8 事件模板（构造时初始化） |
config/WebConfig / config/SecurityConfig | — | CORS / 安全（SecurityConfig.json 提取产物） |
admin/…（AdminJwtService 等） | @Value 注入 | 管理端 JWT secret |