装备强化 · 技术实现

玩家设定 →

「玩家设定 →」

1. 代码位置

层	类	职责
Controller	controller/EquipmentController（/api/equipment）	装备列表、强化、分解、穿戴
Service	service/EnhancementService	强化结算：金币消耗、属性增长、槽位进度
Service	service/EquipmentService	装备模板、掉落品质、属性计算
domain	domain/Equipment	强化常量：ENHANCEMENT_LEVELS_PER_REALM=1000、ENHANCEMENT_PER_LEVEL=0.001（每级 +0.1%）、MAX_ENHANCEMENT_MULTIPLIER=2.0（满境翻倍）、FULL_SET_ENHANCEMENT_FOUR_DIM_RATIO=0.08
domain	domain/EnhancementGoldRules	强化金币预算：日金×天数×70%，曲线 0.7→1.3 按 10 取整
domain	domain/EquipmentSlot、domain/EquipmentQuality、domain/AttributeType	六件套槽位/品质/属性类型
domain	domain/ProgressionLevelCostRules	通用升级消耗 cost=1000+8×step

2. 数据表

表	关键列	说明
equipment	player_id、slot、quality、realm、enhancement_level、base_*	玩家装备（V1）
equipment_blessing	player_id、slot、blessing	装备祝福（V2）
player_slot_progress	player_id、slot、level	槽位强化进度（V47，累计展示）
player_equipment_pity	player_id、slot、pity_count	掉落保底（V47）
system_growth_config	track=EQUIPMENT_ENHANCE、daily_output、unit_cost	强化金币产出/消耗闭合（V47，V53 面额×10）

3. 配置与常量

• 强化金币预算：

  名称	数值	说明
  budgetShareBUDGET_SHARE	0.70D	—
  slotCountSLOT_COUNT	EquipmentSlot.values().length	—
  levelsPerRealmLEVELS_PER_REALM	Equipment.ENHANCEMENT_LEVELS_PER_REALM	—

  来源：emberfall-server/src/main/java/com/emberfall/domain/EnhancementGoldRules.java · commit 5916da43b88f343400acfdb20c97a5cc7927fdbd
• 通用升级消耗：

  名称	数值	说明
  maxPaidStepsMAX_PAID_STEPS	10_000	—
  baseCostBASE_COST	1_000	—
  costIncrementCOST_INCREMENT	8	—
  cumulativeCostCUMULATIVE_COST	buildCumulativeCost()	—

  来源：emberfall-server/src/main/java/com/emberfall/domain/ProgressionLevelCostRules.java · commit 5916da43b88f343400acfdb20c97a5cc7927fdbd
• 装备强化核心常量：
  emberfall-server/src/main/java/com/emberfall/domain/Equipment.java:18源码读取失败，片段不可用
• yml 键：无专属键（强化数值全部走 system_growth_config 与常量类）

4. 数据流简述

POST /api/equipment/enhance 接收强化请求，EnhancementService 校验金币与槽位进度上限（每境 1000 级），按 EnhancementGoldRules 曲线计算单次金币消耗并扣款，装备 enhancement_level +1，属性按 ENHANCEMENT_PER_LEVEL 与四维基数增长。进度写回 player_slot_progress，六件同境界满强化提供 FULL_SET_ENHANCEMENT_FOUR_DIM_RATIO（门槛 8%）四维加成，满强总倍率 2.0。返回 EnhancementResultDto 并刷新 player_attribute。

5. 已知差异

无（V67 起每境 1000 级万级强化为现行实现，旧 100 级/境设计已随迁移替换，无遗留冲突）

6. 相关代码

• 境界系统（Realm：装备基底由境界门槛倒推）
• 装备淬炼（EquipmentRefineService：淬炼属性独立于强化）
• 打金副本（GoldDungeonRules：金币产出主来源）
• 掉落（DropService、player_equipment_pity 保底）