外观
装备淬炼 · 技术实现
「玩家设定 →」
1. 代码位置
| 层 | 类 | 职责 |
|---|---|---|
| Controller | controller/EquipmentController（/api/equipment） | 淬炼升级、淬炼上限突破接口 |
| Service | service/EquipmentRefineService | 淬炼结算：词条升级、材料消耗、上限突破（player_refine_cap） |
| domain | domain/EquipmentRefineEntryType | 三条词条：主属性每级 +1%（MAIN_ATTRIBUTE_PERCENT）、固定伤害/真实伤害分 10 段成长（每段 +100，第 1 千级段 100 → 第 10 段 1000） |
| domain | domain/EquipmentRefineStats、domain/EquipmentRefineEntryDto | 淬炼状态与展示 DTO |
| domain | domain/TitleRules | 淬炼上限突破跟随称号阶数（MAX_TIER=10），突破消耗与称号进阶石公式一致（advanceStoneCost） |
| balance | balance/BalanceConfigRegistry | BalanceTrack.REFINE_FOUR_DIM / REFINE_FIXED / REFINE_TRUE 三条轨道闭合校验 |
2. 数据表
| 表 | 关键列 | 说明 |
|---|---|---|
equipment | player_id、slot、refine_* | 装备淬炼等级（V1 扩展列） |
player_refine_cap | player_id、slot、entry_type、cap_tier | 固伤/真伤淬炼上限突破阶（V52 equipment_refine_specialization） |
system_growth_config | track=REFINE_FOUR_DIM/REFINE_FIXED/REFINE_TRUE、unit_cost | 淬炼材料消耗（V47，V69/V70/V71 调整） |
3. 配置与常量
- 淬炼词条定义与上限材料：emberfall-server/src/main/java/com/emberfall/domain/EquipmentRefineEntryType.java:16源码读取失败，片段不可用
- 上限突破规则：
CAP_STEP=1000（10 阶 × 1000 级 = 10000 级上限）、CAP_UNLOCK_FLOOR_STEP=30（每 30 层试炼解锁 1 阶）、INITIAL_FIXED_DAMAGE_CAP=1000 - 材料：
REFINE_MATERIAL_ITEM_ID=9001（淬炼精魄，产自万象蕴灵境）、FIXED_DAMAGE_CAP_MATERIAL_ITEM_ID=9101（固伤灵砂）、TRUE_DAMAGE_CAP_MATERIAL_ITEM_ID=9102（真伤灵砂） - yml 键：无（数值全部走常量类与
system_growth_config）
4. 数据流简述
POST /api/equipment/refine 选择词条（主属性/固伤/真伤）与次数，EquipmentRefineService 校验材料（淬炼精魄）与等级上限，按 valuePerLevel 累计属性并扣材料写回 equipment。固伤/真伤达到当前阶上限后，POST /api/equipment/refine/cap-unlock 校验对应灵砂与试炼层数（每 30 层解锁 1 阶，上限跟随称号阶数），写入 player_refine_cap。返回 EquipmentRefineResultDto。
5. 已知差异
无（V69 万级淬炼、V70 闭合修正、V71 上限与称号阶对齐均为现行最终态）
6. 相关代码
- 称号系统（
TitleRules：淬炼上限与称号阶数联动） - 装备强化（
EnhancementService：强化与淬炼属性独立叠加） - 余烬试炼场（固伤/真伤输出在试炼 DPS 结算中生效，见
EmberTrialDamageService） - 炼体秘境 / 破界深渊（固伤/真伤对应挑战场景）