技术解析
从 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-] 启动引导 |
| level1 | SDK 与统计初始化(AppMetrica、GameAnalytics、Loader、SquareDino) |
| level2 | World + 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. 人物、骨骼与蒙皮
- 5 个角色:Man(玩家)、Worker(员工)、Client1/2/3(乘客),每个约 1.0k–1.4k 顶点,SkinnedMeshRenderer,每顶点最多 4 根骨骼影响。
- 骨架:Mixamo 标准骨架,22 根骨骼:Hips → Spine → Spine1 → Spine2 → Neck → Head;左右 Shoulder → Arm → ForeArm → Hand;左右 UpLeg → Leg → Foot → ToeBase。没有手指骨骼。
- Avatar:每个角色一个 Humanoid Avatar(ManAvatar、WorkerAvatar、Client1–3Avatar),HumanBoneIndex 把 22 根骨骼映射到 Unity 人形骨骼(Spine1 = Chest,Spine2 = UpperChest),眼睛、下巴未映射。
- Prefab 结构:Passenger → Graphic → ClientN(Animator)→ { 蒙皮网格, mixamorig:Hips, Rig 1(Animation Rigging)},另有 Holder(搬运物品挂点,高 0.85 m,前 0.35 m)、Bubble(需求气泡,高 2.25 m)、BoosterDisplay。
4. 动作系统
| 动作 | 时长 | 用途 |
|---|---|---|
| Idle 待机 | 4.93 s | 站立、排队等待 |
| Walk_N 行走 | 0.97 s | 低速移动(Forward 混合) |
| Run_N 奔跑 | 0.67 s | 高速移动 |
| Seated Idle 坐姿待机 | 4.17 s | 候车区、咖啡厅坐下(参数 Sit) |
| mixamo.com | 4.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. 局限说明
- IL2CPP 把 C# 编译成了 wasm 机器码,元数据只保留类名、字段名、方法名和类型,因此上面的算法描述是由名称、字段、配置数值和运行表现推得,不是原始 C# 源码。
- Humanoid 动作经过肌肉空间重定向后与 Unity 运行时会有细微差别(例如上臂与前臂的扭转分配),整体姿态一致。
- 远程配置、云存档内容等只在运行时出现的数据不在资源包里。