CultivatingImmortality_RPGgame
UE 5.8 项目技术总览

§0.5 · 知识地图 Mind map

十章内容的可折叠思维导图

从项目框架到分析方法，整份文档的骨架可以一次展开、逐层下钻。

§1 · 项目框架 Framework

C++ 基类打底、发丝会飘、逐节点可读：三个定义项目性格的决策

引擎 5.8、14 源文件 C++ 基类（TransformBase 3161 行、CharacterBase 7516 行）传统输入系统（ActionMappings，非 Enhanced Input）——C++ 覆盖底层逻辑（遁光/战斗五连/蓄力/护盾/昼夜/六剑），蓝图承载表现层（蒙太奇/特效/动态材质）。

启动配置与输入映射

默认地图为 RealBiomes_TestEmpty（定向光 + 高度雾的空测试场景），游戏模式 GameMode（GameModeBase）。输入采用传统系统而非 Enhanced Input：

启用插件：KawaiiPhysics、ModelingToolsEditorMode、GameplayBehaviors、编辑器数据接口插件（实验性）；EditorUIScale 未启用。项目根目录另有 Houdini 工程 HillStone.hip（山体/石头程序化模型源文件）。

§2 · 主角系统

输入一张图、连击一张图：主角逻辑的两座高峰

CharacterBlueprint 的九个图表里，InputEventGraph 与 Attack 两张图合计 623 个节点——剩下的七张图都是辅助。

父类链：TransformBase → CharacterBase（纯 C++ 基类）。9 个蓝图图表 + 底层 C++ 函数，14 个源文件支撑。

— 项目技术总览 · 第二章, 2026-07-23

ContextCharacterBlueprint 包揽输入、连击、瞄准、雷电、相机与后处理。 Why it matters逻辑集中于单蓝图意味着任何改动都要在这 9 张图里定位——节点密度图就是这张地图。

五段连击：蒙太奇选段 + 通知帧管理状态

ComboAttack 从 ST_AnimMontage 结构体拆出 Combo1~Combo5 五段蒙太奇，按 ComboNumber 选段播放；ReadyToCombo 窗口内再次输入则续段，否则 ResetAttack 清零。攻击状态由动画通知驱动：ComboAttackNotify 进入攻击（IsAttacking=true、关闭朝向跟随、限速 300），ResetAttackNotify 退出并恢复 HoverFlySpeed。连击同时生成 BezierBulletEffect 贝塞尔追踪弹与 Attack03/05 特效。

瞄准与雷电

右键 CE_AimStart 进入瞄准（相机拉近、UW_Aim 准星显示），CE_AimTrace 定时扫描敌人填入 AimTargetArray 并分配锁定目标。雷电是蓄力链式攻击：ChargeCompleted 后沿 EnemyArray 在多个 敌人 间链接（分叉 _Branch / 弹射 _Bounce），UW_LightningTrace 绘制连线 UI，技能期间切换后处理材质。39 个变量按移动 / 连击 / 镜头 / 瞄准 / 雷电 / 后处理六组组织。

§3 · 运动系统 BPC_MotionComponent

两套飞行参数、一个倾斜量：运动组件只做三件事

挂在 CharacterBlueprint 上的 ActorComponent：27 个变量、10 个函数，管双速态飞行、Lean 倾斜与相机弹簧臂。

双速态由 SetSprintEvent / SetAimingEvent 切换，IsAiming 时进入瞄准飞行参数。Tick 中记录前后两帧速度朝向，由 YawVelocityDifference / PitchVelocityDifference 实时算出 Lean 倾斜量，供动画蓝图驱动身体倾斜。相机弹簧臂合成图（61 节点）按 TargetSocketOffset / TargetLength / InterpSpeed 平滑插值：瞄准时拉近、冲刺时拉远。HitEvent 负责受击时打断当前运动状态。

§4 · 动画系统 CharacterAnimationBlueprint

四态六转移：一台没有"地面"的状态机

数据流单向而清晰——CharacterBlueprint / BPC 计算状态变量，CharacterAnimationBlueprint 每帧读取并驱动骨骼姿势。

AnimGraph 26 节点 + EventGraph 127 节点。主姿势管线：Default 状态机缓存为 LocalMotion → HeadLookAtNode 注视（IsLookAt 且 InRange 时混入）→ Montage Slot（连击注入点）→ AimPoseNode 瞄准姿态（IsAim 时混入）→ 6 级 KawaiiPhysics 串联 → 输出姿势。EventGraph 由 BlueprintUpdateAnimation 驱动，其中 SetNextSection 出现 6 处——连击蒙太奇段落衔接、连击流畅度全靠它。

角色资产支撑（CharacterSkeletalMesh，230 文件）：骨骼网格 + 物理资产、IKRig + IKRetargeter（MagicalAnimSet 动画重定向到 角色 骨骼）、动画 153 个（Motion / Self / Retargeter≈100 / UseMontage 13）、混合空间 5 个、材质 15、贴图 48。

§5 · 特效与弹道 Effect

子弹只有两种：直线，和会拐三个弯的贝塞尔追踪弹

495 个文件的特效库里，真正"会动"的逻辑集中在 EF_BaseEffect 继承树的四个子类上。

BezierBulletEffect 是弹道系统的技术高峰：105 节点 EventGraph + 3 函数。TraceTarget（27 节点）搜索敌人填入 EnemyArray；CE_BezierMove 由 TimelineHasEnemy 驱动，用三控制点 3SpotPosition 计算贝塞尔曲线追踪目标；无敌人时退化为直线/散射。命中后 ApplyDamage（携带 DamageType）→ 生成命中特效 → 停双时间轴 → 销毁。

§6 · 敌人系统 EnemyBlueprint

巡逻、挨打、爆炸、重生：无人机的完整闭环

EventGraph 76 节点管巡逻，Damage 图 140 节点管受击与死亡——死亡反馈比巡逻逻辑厚一倍。

巡逻 AI 用定时器刷新随机巡逻目标点，TraceLand 向下探测地面防止撞地。受击走 AnyDamage：记录命中方向与位置 → 扣 HP → ColorDamage 曲线驱动动态材质受击变色。死亡 CE_Death 是一套组合拳：爆炸特效 + EnemyBlueprintDestroy 残骸（GeometryCollection 混沌破碎）+ FieldSystem 力场冲击 + EnemyExplosionEffect 镜头震动，最后 CE_Reborn 在刷怪点重生完成循环。

§7 · 伤害 · 镜头 · UI

一个接口统一受击，四类通知调度表现

攻击方按技能携带 Sword / Lightning 伤害类型，BPI_Damage 统一投递，敌人 按类型走不同受击反馈。

§8 · 战斗总链路 Combat chain

把前面七章串起来：一次攻击从按键到破碎走完全程

主链路每帧运转，普攻 / 瞄准 / 雷电三条技能链在伤害处合流，受击链在 敌人 侧闭环。

组成关系上，GameMode 只挂两棵子树：主角 CharacterBlueprint（带 BPC 运动组件、AB 动画实例、蒙太奇结构体、战斗 UI 与子弹生成）和敌人 EnemyBlueprint（巡逻 AI、Damage 图、死亡破碎链）。战斗的全部复杂性都发生在这两棵树之间。

§9 · 资产总目录 Assets

943 个文件的分布：一半特效、四分之一角色、六分之一动画包

特效库 495、角色 242、MagicalAnimSet 商城动画包 152、核心玩法蓝图 32、场景素材 25。

核心玩法蓝图只有 32 个文件，却定义了全部规则；真正占体量的是"看起来和动起来"的资产——特效、动画、贴图。地图只有两张：默认启动的 RealBiomes_TestEmpty（定向光 + 高度雾的空场景）和动画包自带的 Showcase 演示关卡。

§10 · 附录 Appendix

这份分析是怎么做出来的

两条数据通路：离线二进制解析拿文件级事实，编辑器实时读取拿节点级事实。

§11 · 功能研究 Pilot study

角色飞行遁速：一份完整的预研实现

项目并非纯蓝图：主角底层由 C++ 基类驱动（TransformBase 遁光、CharacterBase 战斗、TimeOfDay 昼夜、SwordQ 六剑），表现层大量逻辑仍在蓝图图表里。

当前角色（CharacterBlueprint）底层由 TransformBase（C++，3161 行 .cpp）驱动形态变换：右键遁光进入半透明高速态（MPC 溶解过渡）、左键普攻五连、长按蓄力剑气、LeftShift 闪现、Q 键六剑环绕、E 键护盾、瞄准（右键瞄准态）。蓝图图表承载表现层（蒙太奇、特效、动态材质），C++ 负责底层时序与守卫（遁光静默退出三修 V171 迭代实证）。