外观
境界系统 · 技术实现
「玩家设定 →」
1. 代码位置
| 层 | 类 | 职责 |
|---|---|---|
| Controller | controller/PlayerController（/api/player） | GET /realm 境界信息、POST /breakthrough 突破 |
| Service | service/RealmService、service/PlayerService | 境界计算、突破校验、属性结算 |
| Service | service/FourDimGrowthService、service/SettlementService | 四维挂机成长与结算 |
| domain | domain/Realm | 十境界枚举：等级 100~1000、每境 100 级 10 阶、FOUR_DIM_PER_SECOND=5、DAILY_FOUR_DIM_PRODUCTION=216_000 |
| balance | balance/BalanceConfigRegistry、balance/RealmBalance、balance/BalanceConfigService | 300D_V1 境界数值权威：门槛/每日经验/装备基底/暴击闪避 |
| config | config/SecurityConfig、config/WebConfig | 接口鉴权与跨域 |
2. 数据表
| 表 | 关键列 | 说明 |
|---|---|---|
realm_balance_config | realm、core_per_attribute_threshold、target_days、daily_experience、daily_gold、weapon_base_attack、gloves_crit_rate、boots_dodge_rate | 十境平衡数值（V47 建表，V64 修正门槛） |
game_balance_version | version_key、is_active、effective_at | 当前生效平衡版本（300D_V1） |
player_growth_state | player_id、level、realm、growth_* | 玩家境界与成长进度（V2） |
player_realm_history | player_id、realm、breakthrough_at | 突破历史（V47） |
player_effective_progress | player_id、realm、attribute、value | 各属性有效进度（V47） |
player_attribute | player_id、attack、phys_defense、magic_defense、health | 玩家四维属性（V1） |
player_slot_progress | player_id、slot、level | 装备槽位强化进度（V47） |
3. 配置与常量
- 十境数值（DB 最终态，权威）：
version_key realm realm_index display_name target_days core_per_attribute_threshold daily_experience standard_material_daily daily_gold weapon_base_attack armor_base_phys_defense helmet_base_magic_defense belt_base_health gloves_crit_rate boots_dodge_rate 300D_V1 MORTAL 1 凡人境 10 2306880 419834 100 100000 922752 461376 461376 2306880 0.004 0.0028 300D_V1 ESPER 2 异能境 14 6030029 1949881 120 160000 2412012 1206006 1206006 6030029 0.005 0.0036 300D_V1 QI_REFINING 3 炼气境 18 11662963 4022130 145 260000 4665185 2332593 2332593 11662963 0.006 0.0044 300D_V1 FOUNDATION 4 筑基境 23 20245680 6065145 175 420000 8098272 4049136 4049136 20245680 0.007 0.0052 300D_V1 CORE_FORMATION 5 结丹境 28 32791651 8164227 210 670000 13116660 6558330 6558330 32791651 0.008 0.006 300D_V1 NASCENT_SOUL 6 元婴境 33 50534669 10293889 250 1070000 20213868 10106934 10106934 50534669 0.009 0.0068 300D_V1 SPIRIT_TRANSFORMATION 7 化神境 38 74928845 12442062 300 1710000 29971538 14985769 14985769 74928845 0.01 0.0076 300D_V1 BODY_INTEGRATION 8 合体境 43 107648611 14602287 360 2740000 43059444 21529722 21529722 107648611 0.011 0.0084 300D_V1 MAHAYANA 9 大乘境 46 148664419 17499964 430 4380000 59465768 29732884 29732884 148664419 0.012 0.0092 300D_V1 TRIBULATION 10 渡劫境 47 783619427 21363795 515 7000000 78796800 39398400 39398400 196992000 0.013 0.01 来源：sql/realm_balance_config - 平衡版本：
version_key display_name is_active effective_at 300D_V1 十境界300日版本 1 NOW() 来源：sql/game_balance_version - 境界枚举与成长常量：emberfall-server/src/main/java/com/emberfall/domain/Realm.java:9源码读取失败，片段不可用
- 启动校验（300 天闭合 + 渡劫门槛断言）：emberfall-server/src/main/java/com/emberfall/balance/BalanceConfigRegistry.java:102源码读取失败，片段不可用
- yml 键：
emberfall.balance.require-database-config（默认 true，DB 加载失败时拒绝启动）
4. 数据流简述
GET /api/player/realm 读取 player_growth_state 与 player_attribute，经 PlayerService 汇总返回境界/等级/四维/突破条件。POST /api/player/breakthrough 校验等级满 100 且四维均达 realm_balance_config.core_per_attribute_threshold，通过则推进境界并写入 player_realm_history、更新 player_effective_progress。挂机成长由 SettlementService 按 FOUR_DIM_PER_SECOND 与权益倍率累计，超时自动结算。BalanceConfigService.loadActiveVersion() 启动时从 game_balance_version 加载 300D_V1 覆盖内置默认，全部数值以 DB 最终态为准。
5. 已知差异
（渡劫门槛 196,992,000 → 783,619,427）6. 相关代码
- 装备强化（
EnhancementService，装备属性由境界门槛倒推） - 肉身淬炼（
BodyRefineService，十阶对应十境） - 战斗锚点（
balance/CombatAnchor，攻击 ≥ 2×门槛、血 ≥ 4×门槛） - 破界深渊（
RealmAbyssRules，9 层起要求渡劫满级）