# 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\`(移动前需确认脚本内相对路径)。