# weixi-king **Repository Path**: aowind/weixi-king ## Basic Information - **Project Name**: weixi-king - **Description**: �������� �� ���������������������������� - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-01 - **Last Updated**: 2026-11-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 维西之王 · 维京幸存者战斗 Demo 三个视角的诺斯战士在西境魔潮里厮杀 —— **维西王国西部魔物横行,王命选英雄西征除魔**。 美术资源与玩法数值逆向自 Unity 原作(Unity 2022.3.62f2 · IL2CPP), 用 three.js 做出**可玩的三维幸存者战斗 Demo** 的完整工程仓库。 > **品牌与命名**:2026-10-29 起项目改名为《维西之王》,全量 1,722 条名字(英雄/魔物/技能/符文/ > 成就/武器/地图/强化/界面词条)与数据层 id 已统一为维京设定,决策见 > [docs/game-design-decisions.md](docs/game-design-decisions.md) 的 D-074~D-080, > 命名规范与词根表见 [docs/naming/00-命名规范与维京词根表.md](docs/naming/00-命名规范与维京词根表.md)。 > **2026-10-25 已完成项目整合**:原先散落在 `D:\` 根目录的 8 个 `Soulstone_*` 目录(42.4 GB / 158,823 文件) > 已全部收进本目录并按下表归类,主 Demo 的 Windows 服务也已在新路径重建。 > 详细记录见 [docs/migration/report.md](docs/migration/report.md)。 --- ## 一、目录地图 ``` D:\soul stone\ ├─ app\ ★ 主开发工程(原 Soulstone_Re,5.6 GB / 7,321 文件) │ ├─ serve.js Demo 静态服务(默认 8955,/lib/ 挂载 ../assets) │ ├─ demo\ 自包含战斗 Demo(index.html + game.js + 轻量资源子集) │ │ ├─ audio.js ★ WebAudio 引擎(原作音效:总线/3D/并发/节流/淡入淡出) │ │ ├─ assets/audio/ Demo 音频精选(manifest.json + ui/sfx/amb/music,约 42 MB) │ │ └─ verify_audio.js 音频专项验收(Playwright,24 项断言) │ ├─ tools\ ★ 32 个 Python 转换/提取模块 + 服务安装器 │ ├─ gamedata\ 从游戏资产提取的玩法真值(技能 634 / 敌人 457 / 经验曲线…) │ ├─ glb_final\ 玩家角色 GLB(113 个,4,355 段动画,330 MB) │ ├─ glb_enemies\ 敌人 / BOSS GLB(524 个,8,614 段动画,1.1 GB) │ ├─ geo\ 25 张场景几何 GLB(3.2 GB) │ ├─ scenes\ 25 张场景布局 JSON(刷怪点 / 光照 / 雾) │ ├─ vfx\ 1,251 prefab → 296 粒子系统 + 52 贴图 │ ├─ il2cpp_out\ IL2CPP dump.cs(27 MB) │ ├─ docs\ 开发报告(修复记录、本地化、光照与服务等) │ ├─ verify.js 端到端验收(Playwright + 真实 GPU,10 项) │ ├─ verify_audio.js 音频专项验收(24 项:manifest/解码/播放/音量面板/MIME) │ └─ verify_gameplay.js 玩法验收(33 项断言) │ ├─ assets\ 资源产线产物 + 资源查看器(原 Soulstone_Assets,12.9 GB / 27,665 文件) │ ├─ index.html 资源查看器(模型/骨骼/贴图/动画浏览) │ ├─ audio\ ★ 原作音频全量库(wem 原件 374 MB + ogg 8306 条 441 MB + catalog.json + 浏览页 index.html) │ ├─ gltf\ models\ rigged\ textures\ sprites\ meta\ web\ vendor\ │ └─ *_audit.csv 资产审计表;两份诊断/可行性报告 │ ├─ raw\ Unity 肌肉动画原始数据(原 Soulstone_Raw,186 MB) │ ├─ _muscle_txt\ 每个 clip 每帧 95 个 muscle 值(文本) │ ├─ _muscle_baked\ 按模型烘焙后的 JSON │ └─ <模型名>\ 16 个角色/怪物的原始导出 │ ├─ unity\ │ ├─ AniExport\ Unity 2022.3 烘焙工程(原 Soulstone_AniExport,1.6 GB) │ │ └─ Assets\Editor\ExportRaw.cs ★ 肌肉空间 → 骨骼旋转的 Unity 端导出器 │ └─ LicenseProbe\ Unity 许可证探测用空工程(原 Soulstone_Unity) │ ├─ rips\ 逆向导出原料(只读参考,共 ~19.2 GB / 118,903 文件) │ ├─ ripper-1\ AssetRipper 导出①(ExportedProject + AuxiliaryFiles,8.2 GB) │ ├─ ripper-2\ AssetRipper 导出②(Assets + Assemblies + 反编译 Scripts,11.0 GB) │ └─ assetstudio\ AssetStudio 导出样本 + 早期探测脚本 │ ├─ tools\ ★ 仓库级维护脚本(本次迁移新增) │ ├─ move_dir.py 同盘秒级搬运(绝不复制) │ ├─ dir_stats.py 文件数/字节统计 │ ├─ migrate_paths.py 旧绝对路径批量改写 │ ├─ repair_drive_sep.py 路径改写 bug 修复 │ └─ http_probe.py HTTP 探活 │ └─ docs\ 项目文档中心(索引见 docs/README.md) └─ migration\ 本次整合的计划、基线、改写报告、验收报告 ``` --- ## 二、快速开始 ### 1) 战斗 Demo(已在跑) Windows 服务 `SoulstoneDemo`(nssm)**开机自启**,当前运行中: | 入口 | 地址 | |---|---| | 战斗 Demo | | | 资源查看器(挂载 ../assets) | | | 音频素材库(8306 条全量试听) | | | 服务探活 | | 操作:`WASD` 移动;升级三选一 `1/2/3`;`R` 刷新、`B` 剔除、`L` 锁定;战斗全自动。 > **2026-11-01 起默认加载公开许可(CC0)资产**(22 角色 / 8 小怪 / 4 BOSS / 13 场景), > 选角页与选关页保持原样。想回退到原逆向资产:。 > 详见 [docs/README.md](docs/README.md) 〇·四 节与决策 D-107。 服务管理(管理员 cmd): ```bat sc query SoulstoneDemo sc stop SoulstoneDemo sc start SoulstoneDemo D:\soul stone\app\tools\install_service.bat :: 修复/重建(路径无关,纯 ASCII) ``` 不想用服务时,手动起(前台): ```bat cd /d "D:\soul stone\app" node serve.js --no-open ``` ### 2) 资源查看器单独跑(8942) ```bat cd /d "D:\soul stone\assets" node serve.js :: 或双击 start.bat,默认 http://127.0.0.1:8942/ ``` ### 3) 验收 ```bat cd /d "D:\soul stone\app" node verify.js :: 10 项端到端(无 JS 错误 / 玩家骨骼 51 / 动画 40 / 场景 / 敌人 / 波次 / 移动…) node verify_gameplay.js :: 33 项玩法断言(经验曲线、拾取、升级、技能自动释放…) node tools\verify_ui.js --full :: 21 项界面布局(HUD 区块两两不重叠 / 选角页日志按钮 / 3D 预览左键旋转 · 滚轮缩放 · 双击复位) python tools\measure.py glb_final\BjornRegular.glb python tools\audit_all.py ``` > ⚠️ 无头浏览器必须走 GPU:脚本参数为 `--enable-gpu --no-sandbox --ignore-gpu-blocklist`, > **不要**加 `--use-gl=swiftshader`(会把 60 FPS 压到 ~24 FPS,验收按真实时间断言会大面积误判)。 --- ## 三、资源管线(从游戏本体到 Demo) ``` 游戏本机文件 │ AssetRipper ├─→ rips\ripper-1 / rips\ripper-2 (ExportedProject / 反编译 Scripts) │ │ Unity 2022.3 + unity\AniExport\Assets\Editor\ExportRaw.cs │ (在真实 Unity 里用 HumanPoseHandler 把肌肉空间解算成骨骼旋转 → 导出) ├─→ raw\_muscle_txt / raw\_muscle_baked │ │ app\tools\*.py(raw2glb / build_all / build_enemies / build_geo / extract_gamedata…) ├─→ app\glb_final、app\glb_enemies、app\geo、app\scenes、app\gamedata、app\vfx │ │ app\tools\bake_to_demo.py + gen_precompressed.js └─→ app\demo\assets(Demo 轻量资源子集,带 .br 预压缩) ``` 核心难点(详见 [app/README.md](app/README.md)):Unity humanoid 肌肉空间解算、压缩网格解位、 八面体法线解码、UV 双通道与 V 轴翻转、单位/缩放折叠、Z-up 判定、BoneFollower 丢失修复。 --- ## 三·五、音频:原作音效全量提取与应用(2026-10-26) > 之前的结论「音频本体没被导出」是误判:Soulstone Survivors 用 **Wwise** 中间件,34 个 SoundBank(.bnk) > 一直躺在 `StreamingAssets/Audio/GeneratedSoundBanks/Windows/` 里,AssetRipper 只是不会把它展开成 AudioClip。 | 环节 | 结果 | 文档 | |---|---|---| | **全量提取** | 33 个 bank / **2528 个事件** / **8306 个媒体** → .wem 原件 + Ogg Vorbis(**42.3 小时 / 441.6 MB**),0 失败 | [docs/audio/02-全量提取报告.md](docs/audio/02-全量提取报告.md) | | **语义映射** | 用 prefab 里的 `SkillSoundTrait.SoundEventName` / `SpawnSound` / `DeathSoundEvent` 直证:**363 个技能 + 8 creep + 4 BOSS + 56 个契约 key** 全覆盖 | [docs/audio/01-映射表.md](docs/audio/01-映射表.md) | | **Demo 应用** | `app/demo/audio.js`(WebAudio 引擎)+ 49 处事件钩子 + 音量面板;BGM 按地图(stem 段落组曲重建)+ 环境层;技能/敌人/BOSS 用各自的原作音效 | [docs/audio/03-Demo音效接入报告.md](docs/audio/03-Demo音效接入报告.md) | | **验收** | `verify_audio.js` **24/24** · `verify.js` **10/10** · `verify_gameplay.js` **33/33** · 素材体检 0 错误 | — | ```bash # 全量提取(约 6 分钟;断点续跑) python tools/audio/extract_banks.py # 拆 bank → assets/audio/wem + _raw.json python tools/audio/decode_audio.py --jobs 10 # wem → ogg + catalog.json(8306 个) python tools/audio/build_music.py --jobs 3 # 按 bank 重建 BGM(stem 段落组曲) python tools/audio/build_pack.py # 生成 Demo 精选包 + manifest.json python tools/audio/build_library_page.py # 生成 assets/audio/index.html 浏览页 # 验收 cd app && node verify_audio.js ``` > 版权:音频素材版权跟随游戏本体,**仅本地学习使用**,不进 MIT 许可范围(与美术资源相同)。 ## 四、旧路径 → 新路径对照 | 旧路径(已不存在) | 新路径 | |---|---| | `D:\Soulstone_Re` | `D:\soul stone\app` | | `D:\Soulstone_Assets` | `D:\soul stone\assets` | | `D:\Soulstone_Raw` | `D:\soul stone\raw` | | `D:\Soulstone_AniExport` | `D:\soul stone\unity\AniExport` | | `D:\Soulstone_Unity` | `D:\soul stone\unity\LicenseProbe` | | `D:\Soulstone_AR` | `D:\soul stone\rips\ripper-1` | | `D:\Soulstone_AR2` | `D:\soul stone\rips\ripper-2` | | `D:\Soulstone_AS` | `D:\soul stone\rips\assetstudio` | 代码/文档里的绝对路径已批量改写(共 1,178 处,覆盖 app / assets / unity / raw): `D:\Soulstone_X`、`D:/Soulstone_X`、`/d/Soulstone_X`、无盘符的 `Soulstone_X/…` 四种写法。 `app\tools\*.py`、`unity\AniExport\Assets\Editor\*.cs`、`*.bat/.vbs`、`app\README.md` 均已指向新位置。 > 注意:`app\gamedata\*.json` 里出现的 `Soulstone_Crystal` / `Minor_Soulstone_Ore` 是**游戏资产名**, > 不是路径,无需也不应改写。 --- ## 五、环境 | 项 | 位置 | |---|---| | Node.js | `C:\Program Files\nodejs\node.exe` | | Python | 3.11(PATH 中 `python` 即可) | | Unity 2022.3.62f2 | `D:\Unity2022\Editor\Unity.exe` | | Blender 4.5.14 | `D:\Blender45\blender-4.5.14-windows-x64\blender.exe` | | 服务包装器 nssm | `app\tools\nssm\nssm.exe` | --- ## 六、已知边界与待办 - **riips 目录是只读原料**:`rips\ripper-2\Scripts` 是游戏反编译代码,未做路径改写(不需要); 两份 AssetRipper 导出内容有重叠(ripper-1 无脚本、ripper-2 带反编译脚本),保留是为了溯源。 - **Unity 工程移动后需首次重开**:`unity\AniExport` 的 `Library\` 缓存含旧绝对路径, 用 Unity 重新打开会自动重建;Editor 脚本里的输出路径已改为新位置。 - **Git 尚未初始化**:42 GB 二进制不适合直接进 Git,建议只对 `app\` 的源码/文档建仓库, 大数据用 `.gitignore` + 外部存储(`rips/`、`assets/gltf`、`app/geo` 等)。 - **音频边界**:Wwise 音乐播放图(bank 的 HIRC 音乐段/播放列表)**未解析**,BGM 用「Intro→A→B→C→D」 段落组曲近似重建,不是原版按战斗强度动态增删层;VO(2854 条 / 7.7 小时)已全量转码但 Demo 未接。 - **服务日志**:`app\serve.out.log` / `app\serve.err.log`(nssm 轮转 10 MB), 访问日志在 `app\logs\`。 - **历史调试脚本**:`app\` 根目录的 `probe_*.js`、`shot_*.js`、`diag_*.js`、`build_*.log` 是开发过程产物, 保留未删;后续可整体归档到 `app\_scratch\`(移动前需确认脚本内相对路径)。