坐骑/翅膀/灵兽 · 技术实现

玩家设定 →

「玩家设定 →」

1. 代码位置

层	类	职责
Controller	controller/MountController（/api/player/mount）、controller/WingController（/api/player/wing）、controller/PetController（/api/player/pet）	三系升级/进阶/穿戴/换新继承接口
Service	service/MountService、service/WingService、service/PetService	升级结算、进阶结算、inherit() 换新继承
Service	service/FourDimGrowthService、service/GrowthPolicyService	四维加成应用与成长策略
domain	domain/CompanionGrowthRules	共享成长规则：MAX_LEVEL=10000、MAX_ADVANCE_LEVEL=9、ATTR_PER_LEVEL=200、LEVELS_PER_ADVANCE=1000、进阶倍率 (9+4×阶)/90、成本 9750×1.008^阶
domain	domain/InheritRules	换新继承：等级 80%、进阶材料返还 50%、档位 FREE<MONTHLY<LIFETIME<VIP<NAMING 禁止平级/降级
domain	domain/MountTemplate、domain/WingTemplate、domain/PetTemplate、domain/PlayerMount、domain/PlayerWing、domain/PlayerPet、domain/MountStats、domain/WingStats、domain/PetStats	三系模板与玩家实例
stage	stage/StageConfigCache、stage/EffectiveStageConfig	阶段开放开关（V66 起）

2. 数据表

表	关键列	说明
player_mount	player_id、mount_id、level、advance_level（0-9，V72）	玩家坐骑（V22/V23）
player_wing	player_id、wing_id、level、advance_level（0-9，V72）	玩家翅膀（V24/V26）
player_pet	player_id、pet_id、level、advance_level（0-9，V72）	玩家灵兽（V35/V37）
sys_stage_config	stage_key、mode、value、effective_at	阶段开放配置（V66）
sys_stage_global	stage_key、is_open	全局阶段开关（V66）
sys_stage_config_log	stage_key、before_value、after_value	阶段调整审计日志（V66）
system_growth_config	track=MOUNT_LEVEL/MOUNT_ADVANCE/WING_*/PET_*	三系每日产出/单价/突破成本（V47）

3. 配置与常量

• 共享成长规则：

  名称	数值	说明
  maxLevelMAX_LEVEL	10_000	—
  maxAdvanceLevelMAX_ADVANCE_LEVEL	9	—
  attrPerLevelATTR_PER_LEVEL	200	—
  levelsPerAdvanceLEVELS_PER_ADVANCE	1_000	—
  legacyCombatMaxLevelLEGACY_COMBAT_MAX_LEVEL	1_000	—
  advanceMultiplierBasePartsADVANCE_MULTIPLIER_BASE_PARTS	9	—
  advanceMultiplierPerLevelPartsADVANCE_MULTIPLIER_PER_LEVEL_PARTS	4	—
  legacyLevelsPerRealmLEGACY_LEVELS_PER_REALM	100	—
  attributeTierScaleATTRIBUTE_TIER_SCALE	10	—
  advanceBaseCostADVANCE_BASE_COST	9_750L	—
  advanceGrowthRateADVANCE_GROWTH_RATE	1.008D	—
  legacyMaxAdvanceLevelLEGACY_MAX_ADVANCE_LEVEL	100	—
  attributeMultiplierDenominatorATTRIBUTE_MULTIPLIER_DENOMINATOR	ADVANCE_MULTIPLIER_BASE_PARTS * ATTRIBUTE_TIER_SCALE	—
  cumulativeAdvanceCostCUMULATIVE_ADVANCE_COST	buildCumulativeAdvanceCost()	—

  来源：emberfall-server/src/main/java/com/emberfall/domain/CompanionGrowthRules.java · commit 5916da43b88f343400acfdb20c97a5cc7927fdbd
• 换新继承规则：

  名称	数值	说明
  levelInheritRateLEVEL_INHERIT_RATE	0.8D	—
  materialReturnRateMATERIAL_RETURN_RATE	0.5D	—
  gradeRankGRADE_RANK	Map.of( "FREE", 0, "MONTHLY", 1, "LIFETIME", 2, "VIP", 3, "NAMING", 4 )	—

  来源：emberfall-server/src/main/java/com/emberfall/domain/InheritRules.java · commit 5916da43b88f343400acfdb20c97a5cc7927fdbd
• 成长轨道（坐骑/翅膀/灵兽 × 境界）：

  version_key	track_key	realm	material_item_id	material_name	daily_output	unit_cost	breakthrough_cost	level_cap
  300D_V1	MOUNT_LEVEL	MORTAL	8001	坐骑精魄	100	10	0	100
  300D_V1	MOUNT_ADVANCE	MORTAL	5203	坐骑进阶石	10	10	0	10
  300D_V1	WING_LEVEL	MORTAL	8002	翅膀精魄	100	10	0	100
  300D_V1	WING_ADVANCE	MORTAL	5202	翅膀进阶石	10	10	0	10
  300D_V1	PET_LEVEL	MORTAL	8003	灵兽精魄	100	10	0	100
  300D_V1	PET_ADVANCE	MORTAL	5204	灵兽进阶石	10	10	0	10
  300D_V1	BODY	MORTAL	5001	妖兽精血	100	9	90	100
  300D_V1	EQUIPMENT_ENHANCE	MORTAL	3001	强化石	200	33	0	10
  300D_V1	EQUIPMENT_CAST	MORTAL	3010	境界进阶石	30	50	0	1
  300D_V1	REFINE_FOUR_DIM	MORTAL	9001	淬炼精魄	60	10	0	10
  300D_V1	REFINE_FIXED	MORTAL	9101	固伤灵砂	60	10	0	10
  300D_V1	REFINE_TRUE	MORTAL	9102	真伤灵砂	60	10	0	10
  300D_V1	MENTAL_PAGE	MORTAL	6001	心法残页	400	1000	0	1
  300D_V1	MENTAL_INTENT	MORTAL	0	四象真意	160	400	0	1
  300D_V1	MOUNT_LEVEL	ESPER	8001	坐骑精魄	120	17	0	200
  300D_V1	MOUNT_ADVANCE	ESPER	5203	坐骑进阶石	12	17	0	20
  300D_V1	WING_LEVEL	ESPER	8002	翅膀精魄	120	17	0	200
  300D_V1	WING_ADVANCE	ESPER	5202	翅膀进阶石	12	17	0	20
  300D_V1	PET_LEVEL	ESPER	8003	灵兽精魄	120	17	0	200
  300D_V1	PET_ADVANCE	ESPER	5204	灵兽进阶石	12	17	0	20
  300D_V1	BODY	ESPER	5001	妖兽精血	120	15	150	200
  300D_V1	EQUIPMENT_ENHANCE	ESPER	3001	强化石	240	56	0	20
  300D_V1	EQUIPMENT_CAST	ESPER	3011	境界进阶石	36	85	0	2
  300D_V1	REFINE_FOUR_DIM	ESPER	9001	淬炼精魄	72	17	0	20
  300D_V1	REFINE_FIXED	ESPER	9101	固伤灵砂	72	17	0	20
  300D_V1	REFINE_TRUE	ESPER	9102	真伤灵砂	72	17	0	20
  300D_V1	MENTAL_PAGE	ESPER	6001	心法残页	480	1700	0	2
  300D_V1	MENTAL_INTENT	ESPER	0	四象真意	192	680	0	2
  300D_V1	MOUNT_LEVEL	QI_REFINING	8001	坐骑精魄	145	26	0	300
  300D_V1	MOUNT_ADVANCE	QI_REFINING	5203	坐骑进阶石	15	26	0	30
  300D_V1	WING_LEVEL	QI_REFINING	8002	翅膀精魄	145	26	0	300
  300D_V1	WING_ADVANCE	QI_REFINING	5202	翅膀进阶石	15	26	0	30
  300D_V1	PET_LEVEL	QI_REFINING	8003	灵兽精魄	145	26	0	300
  300D_V1	PET_ADVANCE	QI_REFINING	5204	灵兽进阶石	15	26	0	30
  300D_V1	BODY	QI_REFINING	5001	妖兽精血	145	24	240	300
  300D_V1	EQUIPMENT_ENHANCE	QI_REFINING	3001	强化石	290	87	0	30
  300D_V1	EQUIPMENT_CAST	QI_REFINING	3012	境界进阶石	43.5	130	0	3
  300D_V1	REFINE_FOUR_DIM	QI_REFINING	9001	淬炼精魄	87	26	0	30
  300D_V1	REFINE_FIXED	QI_REFINING	9101	固伤灵砂	87	26	0	30
  300D_V1	REFINE_TRUE	QI_REFINING	9102	真伤灵砂	87	26	0	30
  300D_V1	MENTAL_PAGE	QI_REFINING	6001	心法残页	580	2600	0	3
  300D_V1	MENTAL_INTENT	QI_REFINING	0	四象真意	232	1040	0	3
  300D_V1	MOUNT_LEVEL	FOUNDATION	8001	坐骑精魄	175	40	0	400
  300D_V1	MOUNT_ADVANCE	FOUNDATION	5203	坐骑进阶石	18	40	0	40
  300D_V1	WING_LEVEL	FOUNDATION	8002	翅膀精魄	175	40	0	400
  300D_V1	WING_ADVANCE	FOUNDATION	5202	翅膀进阶石	18	40	0	40
  300D_V1	PET_LEVEL	FOUNDATION	8003	灵兽精魄	175	40	0	400
  300D_V1	PET_ADVANCE	FOUNDATION	5204	灵兽进阶石	18	40	0	40
  300D_V1	BODY	FOUNDATION	5001	妖兽精血	175	37	370	400
  300D_V1	EQUIPMENT_ENHANCE	FOUNDATION	3001	强化石	350	134	0	40
  300D_V1	EQUIPMENT_CAST	FOUNDATION	3013	境界进阶石	52.5	200	0	4
  300D_V1	REFINE_FOUR_DIM	FOUNDATION	9001	淬炼精魄	105	40	0	40
  300D_V1	REFINE_FIXED	FOUNDATION	9101	固伤灵砂	105	40	0	40
  300D_V1	REFINE_TRUE	FOUNDATION	9102	真伤灵砂	105	40	0	40
  300D_V1	MENTAL_PAGE	FOUNDATION	6001	心法残页	700	4000	0	4
  300D_V1	MENTAL_INTENT	FOUNDATION	0	四象真意	280	1600	0	4
  300D_V1	MOUNT_LEVEL	CORE_FORMATION	8001	坐骑精魄	210	59	0	500
  300D_V1	MOUNT_ADVANCE	CORE_FORMATION	5203	坐骑进阶石	21	59	0	50
  300D_V1	WING_LEVEL	CORE_FORMATION	8002	翅膀精魄	210	59	0	500
  300D_V1	WING_ADVANCE	CORE_FORMATION	5202	翅膀进阶石	21	59	0	50
  300D_V1	PET_LEVEL	CORE_FORMATION	8003	灵兽精魄	210	59	0	500
  300D_V1	PET_ADVANCE	CORE_FORMATION	5204	灵兽进阶石	21	59	0	50
  300D_V1	BODY	CORE_FORMATION	5001	妖兽精血	210	53	530	500
  300D_V1	EQUIPMENT_ENHANCE	CORE_FORMATION	3001	强化石	420	196	0	50
  300D_V1	EQUIPMENT_CAST	CORE_FORMATION	3014	境界进阶石	63	295	0	5
  300D_V1	REFINE_FOUR_DIM	CORE_FORMATION	9001	淬炼精魄	126	59	0	50
  300D_V1	REFINE_FIXED	CORE_FORMATION	9101	固伤灵砂	126	59	0	50
  300D_V1	REFINE_TRUE	CORE_FORMATION	9102	真伤灵砂	126	59	0	50
  300D_V1	MENTAL_PAGE	CORE_FORMATION	6001	心法残页	840	5900	0	5
  300D_V1	MENTAL_INTENT	CORE_FORMATION	0	四象真意	336	2360	0	5
  300D_V1	MOUNT_LEVEL	NASCENT_SOUL	8001	坐骑精魄	250	83	0	600
  300D_V1	MOUNT_ADVANCE	NASCENT_SOUL	5203	坐骑进阶石	25	83	0	60
  300D_V1	WING_LEVEL	NASCENT_SOUL	8002	翅膀精魄	250	83	0	600
  300D_V1	WING_ADVANCE	NASCENT_SOUL	5202	翅膀进阶石	25	83	0	60
  300D_V1	PET_LEVEL	NASCENT_SOUL	8003	灵兽精魄	250	83	0	600
  300D_V1	PET_ADVANCE	NASCENT_SOUL	5204	灵兽进阶石	25	83	0	60
  300D_V1	BODY	NASCENT_SOUL	5001	妖兽精血	250	75	750	600
  300D_V1	EQUIPMENT_ENHANCE	NASCENT_SOUL	3001	强化石	500	275	0	60
  300D_V1	EQUIPMENT_CAST	NASCENT_SOUL	3015	境界进阶石	75	415	0	6
  300D_V1	REFINE_FOUR_DIM	NASCENT_SOUL	9001	淬炼精魄	150	83	0	60
  300D_V1	REFINE_FIXED	NASCENT_SOUL	9101	固伤灵砂	150	83	0	60
  300D_V1	REFINE_TRUE	NASCENT_SOUL	9102	真伤灵砂	150	83	0	60
  300D_V1	MENTAL_PAGE	NASCENT_SOUL	6001	心法残页	1000	8300	0	6
  300D_V1	MENTAL_INTENT	NASCENT_SOUL	0	四象真意	400	3320	0	6
  300D_V1	MOUNT_LEVEL	SPIRIT_TRANSFORMATION	8001	坐骑精魄	300	114	0	700
  300D_V1	MOUNT_ADVANCE	SPIRIT_TRANSFORMATION	5203	坐骑进阶石	30	114	0	70
  300D_V1	WING_LEVEL	SPIRIT_TRANSFORMATION	8002	翅膀精魄	300	114	0	700
  300D_V1	WING_ADVANCE	SPIRIT_TRANSFORMATION	5202	翅膀进阶石	30	114	0	70
  300D_V1	PET_LEVEL	SPIRIT_TRANSFORMATION	8003	灵兽精魄	300	114	0	700
  300D_V1	PET_ADVANCE	SPIRIT_TRANSFORMATION	5204	灵兽进阶石	30	114	0	70
  300D_V1	BODY	SPIRIT_TRANSFORMATION	5001	妖兽精血	300	104	1040	700
  300D_V1	EQUIPMENT_ENHANCE	SPIRIT_TRANSFORMATION	3001	强化石	600	380	0	70
  300D_V1	EQUIPMENT_CAST	SPIRIT_TRANSFORMATION	3016	境界进阶石	90	570	0	7
  300D_V1	REFINE_FOUR_DIM	SPIRIT_TRANSFORMATION	9001	淬炼精魄	180	114	0	70
  300D_V1	REFINE_FIXED	SPIRIT_TRANSFORMATION	9101	固伤灵砂	180	114	0	70
  300D_V1	REFINE_TRUE	SPIRIT_TRANSFORMATION	9102	真伤灵砂	180	114	0	70
  300D_V1	MENTAL_PAGE	SPIRIT_TRANSFORMATION	6001	心法残页	1200	11400	0	7
  300D_V1	MENTAL_INTENT	SPIRIT_TRANSFORMATION	0	四象真意	480	4560	0	7
  300D_V1	MOUNT_LEVEL	BODY_INTEGRATION	8001	坐骑精魄	360	155	0	800
  300D_V1	MOUNT_ADVANCE	BODY_INTEGRATION	5203	坐骑进阶石	36	155	0	80
  300D_V1	WING_LEVEL	BODY_INTEGRATION	8002	翅膀精魄	360	155	0	800
  300D_V1	WING_ADVANCE	BODY_INTEGRATION	5202	翅膀进阶石	36	155	0	80
  300D_V1	PET_LEVEL	BODY_INTEGRATION	8003	灵兽精魄	360	155	0	800
  300D_V1	PET_ADVANCE	BODY_INTEGRATION	5204	灵兽进阶石	36	155	0	80
  300D_V1	BODY	BODY_INTEGRATION	5001	妖兽精血	360	141	1410	800
  300D_V1	EQUIPMENT_ENHANCE	BODY_INTEGRATION	3001	强化石	720	516	0	80
  300D_V1	EQUIPMENT_CAST	BODY_INTEGRATION	3017	境界进阶石	108	775	0	8
  300D_V1	REFINE_FOUR_DIM	BODY_INTEGRATION	9001	淬炼精魄	216	155	0	80
  300D_V1	REFINE_FIXED	BODY_INTEGRATION	9101	固伤灵砂	216	155	0	80
  300D_V1	REFINE_TRUE	BODY_INTEGRATION	9102	真伤灵砂	216	155	0	80
  300D_V1	MENTAL_PAGE	BODY_INTEGRATION	6001	心法残页	1440	15500	0	8
  300D_V1	MENTAL_INTENT	BODY_INTEGRATION	0	四象真意	576	6200	0	8
  300D_V1	MOUNT_LEVEL	MAHAYANA	8001	坐骑精魄	430	198	0	900
  300D_V1	MOUNT_ADVANCE	MAHAYANA	5203	坐骑进阶石	43	198	0	90
  300D_V1	WING_LEVEL	MAHAYANA	8002	翅膀精魄	430	198	0	900
  300D_V1	WING_ADVANCE	MAHAYANA	5202	翅膀进阶石	43	198	0	90
  300D_V1	PET_LEVEL	MAHAYANA	8003	灵兽精魄	430	198	0	900
  300D_V1	PET_ADVANCE	MAHAYANA	5204	灵兽进阶石	43	198	0	90
  300D_V1	BODY	MAHAYANA	5001	妖兽精血	430	180	1800	900
  300D_V1	EQUIPMENT_ENHANCE	MAHAYANA	3001	强化石	860	659	0	90
  300D_V1	EQUIPMENT_CAST	MAHAYANA	3018	境界进阶石	129	990	0	9
  300D_V1	REFINE_FOUR_DIM	MAHAYANA	9001	淬炼精魄	258	198	0	90
  300D_V1	REFINE_FIXED	MAHAYANA	9101	固伤灵砂	258	198	0	90
  300D_V1	REFINE_TRUE	MAHAYANA	9102	真伤灵砂	258	198	0	90
  300D_V1	MENTAL_PAGE	MAHAYANA	6001	心法残页	1720	19800	0	9
  300D_V1	MENTAL_INTENT	MAHAYANA	0	四象真意	688	7920	0	9
  300D_V1	MOUNT_LEVEL	TRIBULATION	8001	坐骑精魄	515	242	0	1000
  300D_V1	MOUNT_ADVANCE	TRIBULATION	5203	坐骑进阶石	52	242	0	100
  300D_V1	WING_LEVEL	TRIBULATION	8002	翅膀精魄	515	242	0	1000
  300D_V1	WING_ADVANCE	TRIBULATION	5202	翅膀进阶石	52	242	0	100
  300D_V1	PET_LEVEL	TRIBULATION	8003	灵兽精魄	515	242	0	1000
  300D_V1	PET_ADVANCE	TRIBULATION	5204	灵兽进阶石	52	242	0	100
  300D_V1	BODY	TRIBULATION	5001	妖兽精血	515	242	0	1000
  300D_V1	EQUIPMENT_ENHANCE	TRIBULATION	3001	强化石	1030	807	0	100
  300D_V1	EQUIPMENT_CAST	TRIBULATION	3019	境界进阶石	154.5	1210	0	10
  300D_V1	REFINE_FOUR_DIM	TRIBULATION	9001	淬炼精魄	309	242	0	100
  300D_V1	REFINE_FIXED	TRIBULATION	9101	固伤灵砂	309	242	0	100
  300D_V1	REFINE_TRUE	TRIBULATION	9102	真伤灵砂	309	242	0	100
  300D_V1	MENTAL_PAGE	TRIBULATION	6001	心法残页	2060	24200	0	10
  300D_V1	MENTAL_INTENT	TRIBULATION	0	四象真意	824	9680	0	10
  300D_V1	TRIAL	MORTAL	0	余烬试炼	1	1	0	0
  300D_V1	TRIAL	ESPER	0	余烬试炼	1	1	0	0
  300D_V1	TRIAL	QI_REFINING	0	余烬试炼	1	1	0	0
  300D_V1	TRIAL	FOUNDATION	0	余烬试炼	1	1	0	0
  300D_V1	TRIAL	CORE_FORMATION	0	余烬试炼	1	1	0	0
  300D_V1	TRIAL	NASCENT_SOUL	0	余烬试炼	1	1	0	0
  300D_V1	TRIAL	SPIRIT_TRANSFORMATION	0	余烬试炼	1	1	0	0
  300D_V1	TRIAL	BODY_INTEGRATION	0	余烬试炼	1	1	0	0
  300D_V1	TRIAL	MAHAYANA	0	余烬试炼	1	1	0	0
  300D_V1	TRIAL	TRIBULATION	0	余烬试炼	1	1	0	0
  300D_V1	SECRET_REALM	MORTAL	0	肉鸽秘境	1	1	0	0
  300D_V1	SECRET_REALM	ESPER	0	肉鸽秘境	1	1	0	0
  300D_V1	SECRET_REALM	QI_REFINING	0	肉鸽秘境	1	1	0	0
  300D_V1	SECRET_REALM	FOUNDATION	0	肉鸽秘境	1	1	0	0
  300D_V1	SECRET_REALM	CORE_FORMATION	0	肉鸽秘境	1	1	0	0
  300D_V1	SECRET_REALM	NASCENT_SOUL	0	肉鸽秘境	1	1	0	0
  300D_V1	SECRET_REALM	SPIRIT_TRANSFORMATION	0	肉鸽秘境	1	1	0	0
  300D_V1	SECRET_REALM	BODY_INTEGRATION	0	肉鸽秘境	1	1	0	0
  300D_V1	SECRET_REALM	MAHAYANA	0	肉鸽秘境	1	1	0	0
  300D_V1	SECRET_REALM	TRIBULATION	0	肉鸽秘境	1	1	0	0

  来源：sql/system_growth_config
• 阶段开放（V66）：

  stage_id	stage_name	upgrade_level_cap	advance_tier_cap	upgrade_dungeon_diff	advance_dungeon_diff	is_open	sort_order
  1	阶段1	1000	10	10	10	1	1
  2	阶段2	2000	20	20	20	0	2
  3	阶段3	3000	30	30	30	0	3
  4	阶段4	4000	40	40	40	0	4
  5	阶段5	5000	50	50	50	0	5
  6	阶段6	6000	60	60	60	0	6
  7	阶段7	7000	70	70	70	0	7
  8	阶段8	8000	80	80	80	0	8
  9	阶段9	9000	90	90	90	0	9
  10	阶段10	10000	100	100	100	0	10

  来源：sql/sys_stage_config
• yml 键：无（三系成长全部走 system_growth_config + 常量类）

4. 数据流简述

POST /api/player/mount/upgrade 校验材料（坐骑精魄 8001）与等级上限，按 ProgressionLevelCostRules.stepCost 扣材料升级；POST /api/player/mount/advance 校验进阶石（5203）按 9750×1.008^阶 消耗推进 advance_level（0~9），倍率 (9+4×阶)/90 作用于四维。POST /api/player/mount/inherit 由 InheritRules 校验目标档位严格更高，等级继承 80%（向下取整）并返还 50% 累计进阶材料。三系属性汇总进 player_attribute 四维。

5. 已知差异

📌 设定说明

坐骑、翅膀、灵兽自 V72 起统一为 9 次进阶（旧 100 阶设计废弃），存量进度按比例映射，满阶属性与累计材料投入不变。

差异详情（d07）→

（V72 统一 9 次进阶，旧 100 阶设计废弃）

6. 相关代码

• 传承继承（InheritRules、MountService.inherit）
• 阶段开放（stage/StageConfigService、sys_stage_config）
• 境界系统（Realm：maxLevelForRealm 归一为 10000 级）
• 月卡/VIP 攻速加成（ShopBalanceRules.MONTHLY_CARD_ATTACK_SPEED_BONUS=2.0）