技术解析

从 WebGL 构建包、Unity 资源文件和 IL2CPP 元数据(global-metadata.dat)还原出的引擎结构、骨骼动画系统和核心玩法算法。类名、方法名和字段名来自元数据,数值来自序列化的配置资源;标注「推断」的条目是根据字段顺序与数值含义得出的解读。

1. 引擎与构建

项目内容
引擎Unity 2022.3.21f1,WebGL 平台,脚本后端 IL2CPP(wasm),渲染管线 URP
产品信息内部名 Railway Station 3D v0.0.12,公司字段 SquareDino,构建 GUID 598d96ab372c4016be0cb4ccc9e8d2c4
构建文件data 10.9 MB(解压 20.4 MB)、wasm 7.8 MB(解压 40 MB)、framework.js 0.78 MB,均为 Brotli 压缩的 .unityweb
资源包data.unity3d:level0–level3 四个场景、sharedassets0–3、resources.assets、globalgamemanagers;Il2CppData/Metadata/global-metadata.dat(v29)
着色Toony Colors Pro 2 卡通着色 + 一张调色板贴图(Atlas/Palette),所有模型共用一个材质,DrawCall 极低
第三方Cinemachine(相机)、DOTween(补间)、NavMesh Components(寻路)、Animation Rigging(手部 IK)、Input System + SimpleInput(虚拟摇杆)、I2 Localization(俄/英)、TextMeshPro、GamePush / Yandex Games SDK、GameAnalytics、AppMetrica、Odin 序列化、Epic Toon FX(粒子)

2. 场景与地图引擎

场景作用
level0[-Init-] 启动引导
level1SDK 与统计初始化(AppMetrica、GameAnalytics、Loader、SquareDino)
level2World + Logic,含 TimeManager(游戏时钟倍率 30)
level3主游戏场景:World(Static 地形与建筑 / Handlers 各服务点 / Player)、Logic(DataProvider、UnitManager、PortableObjectPool、BoostersManager、TargetingHandler)、LocationZones(6 个区域)、Tutorial(5 个指引箭头)、BoosterPresenters、Camera、Lighting

地图不是瓦片或程序生成,而是在 Unity 编辑器里手摆的 Prefab 场景。可走区域由烘焙好的 NavMesh(NavMeshSurface)提供给乘客和员工的 NavMeshAgent 寻路;玩家用 CharacterController 和碰撞体移动;四面 WorldLimiters(BoxCollider)把玩家限制在 X −29.25~39、Z −25.11~45(Unity 坐标)之内。未解锁建筑在场景里以隐藏状态存在,购买后由 UpgradeZone 激活。

本站的地图编辑器就是把 level3/World 整棵节点树(1362 个节点、145 个网格实例)原样转成 glTF,并在浏览器里实现选择、变换、复制、删除、添加素材、布局导出和第三人称漫游。

3. 人物、骨骼与蒙皮

4. 动作系统

动作时长用途
Idle 待机4.93 s站立、排队等待
Walk_N 行走0.97 s低速移动(Forward 混合)
Run_N 奔跑0.67 s高速移动
Seated Idle 坐姿待机4.17 s候车区、咖啡厅坐下(参数 Sit)
mixamo.com4.07 s另一个 Mixamo 动作(举手 / 招呼)

所有角色共用动画控制器 CharacterAC,参数 Forward(速度混合)和 Sit(坐下)。搬运行李和咖啡时,PortableObjectCarrier 调用 EnableLeftIK / EnableRightIK 打开 Animation Rigging 的双手 IK,把手固定到所搬物体上。

动画导出方法:这几个动作在 Unity 里是 Humanoid 肌肉曲线(Muscle Clip),不是骨骼旋转。导出时先解码 StreamedClip(三次 Hermite 关键帧)、DenseClip(等间隔采样)和 ConstantClip,得到每帧 130 个值:RootT / RootQ(身体重心位置与朝向)、4 个 IK 目标、95 个肌肉值。再用每个 Avatar 的骨骼轴数据(PreQ、PostQ、符号、上下限)把肌肉值换算成角度,按 swing-twist 组合成四元数:局部旋转 = PreQ × SwingTwist(角度) × PostQ⁻¹,髋部用 RootQ 与 RootT × 人形比例。最终以 30 帧/秒写入 glTF 动画通道,因此在任何 glTF 查看器里都能直接播放。

5. 核心玩法循环

乘客生成 → 售票台排队买票 → 安检(行李扫描)→ 行李寄存 → 咖啡厅或候车区 → 站台排队 → 上车离开。每个服务点把收到的钱吐到旁边的钱堆(Heap),玩家走过去收钱,再走进升级区(UpgradeZone)一笔一笔投钱,解锁新建筑或升级已有建筑;也可以雇员工让服务点自动运转。

乘客 AI 状态(Units.AI.PassengerStates,共 22 个):Idle → GoingToCashDesk → WaitingInCashDeskQueue → WaitingInCashDeskQueueForService → WaitingCashDesk → GoingToScan → WaitingInScanQueue → WaitingInScanQueueForService → WaitingScan → GoingStorageArea → WaitingInStorageAreaQueue → WaitingInStorageAreaQueueForService → WaitingStorageArea → GoingToCafe → WaitingInCafeQueue → WaitingInCafeQueueForService → GoingToDrinkCoffee → GoingToRestZone → GoingToPlatform → WaitingInPlatformQueue → WaitingInPlatformQueueForService → WaitingTrain。每个状态实现 Construct / UpdateState / DestinationReached / QueueChanged / ShowBubble。

6. 关键算法

系统实现
玩家移动(Gameplay.Units.Player)CharacterController + 摇杆轴 TouchInput.Axis,相对相机方向移动;Mathf.SmoothDampAngle 转向,平滑时间 0.1 s;重力 −9.81;基础速度 5 m/s(PlayerConfiguration)
乘客 AI(AgentAI)状态机 + NavMeshAgent;坐下时用 DOTween 补间位置与旋转;需求用头顶气泡(ticket / gate / bag / coffee / train)提示
排队每个 Controller 维护 _passengersRegistrationQueue;GetPositionAndRegisterInQueue 返回队列槽位坐标,前面的人离开时触发 QueueChanged 让后面的人前移;ServiceTriggerOnEnter 启动服务协程,每隔 _serviceInterval 服务一人
付款Pay → PayToHeapRoutine,按 _payToHeapInterval 把钞票一张张跳进钱堆
钱堆(Heap / CubicHeap)GetNewResourcePosition 按格子行列层计算堆叠位置,物体沿跳跃弧线(jumpHeight / jumpDuration)飞入,带 Punch 缩放反馈;玩家进入范围后 TakeMoneyFromHeap 协程逐个吸走
员工(WorkerManager)为售票台、安检、站台分阶段购买员工;员工状态 GoingToWork → Work,到岗后服务点自动服务
列车调度(TrainStation + Transport)读取 TimeManager 游戏时钟,CalculateNextEventTime / CheckDepartureTime 计算下一班;进站后 WaitingForPassengersToBoardRoutine 等足人数再发车;列车和巴士沿 TransportPath(起点 → 停靠点 → 终点)移动,单程约 8–12 秒
增益(Boosters)全部收益、售票台、安检、行李、咖啡厅、候车区、站台各自的收益倍增,以及乘客加速,持续 60 秒;现金奖励档位 20、30、35 … 100、150、200
存档GamePushStorageService 云存档 + PlayerPrefs,键前缀 ObjectSaveRemainedCost(记录每个升级区剩余应付金额)

7. 经济数值

项目数值
玩家速度升级6 级:1.00 → 1.05 → 1.10 → 1.15 → 1.20 → 1.25 倍,每级 50
背包容量升级6 级:5 → 6 → 7 → 8 → 9 → 10,每级 50
售票台(4 个)解锁 / 升级价:100 / 50(初始)、50 / 100、75 / 150、100 / 200(推断)
安检(3 个)5 / 50(初始)、50 / 100、75 / 150(推断)
站台(3 个)400(初始站台)、100 / 150、150 / 200(推断)
咖啡厅、行李寄存各 100 / 100(推断)
增益时长60 秒
游戏时钟倍率30(TimeManager)

8. 局限说明