# ourpal **Repository Path**: 963149408.com/ourpal ## Basic Information - **Project Name**: ourpal - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-13 - **Last Updated**: 2026-11-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # TSW 静态图读取器 + HUGE.lmf 地图场景预览 针对 **新仙剑奇侠传XP(Palgame.exe,SWD2k 引擎)** 的资源文件,纯 Python 解码 (无第三方解码依赖,仅 GUI 需要 PyQt6): - `.tsw` / `.act` 精灵图集:`lzo1x.py` + `arle.py` + `tsw.py` + `tsw_viewer.py` - `HUGE.lmf` / `HUGE2.lmf` 地图场景包:`mapedit/`(含 PyQt6 预览器) 格式细节全部通过对 `Palgame.exe` 的 IDA 逆向分析确认(`LZO1X_Decompress` @0x473FC0、 `ArleDecode` @0x405E6A、`TswLib_Init` @0x45A8BE、`TswImage_ReadData` @0x4621DD、 `LoadMap3` @0x443800、`DecompressMap` @0x442AC5、`sub_423976` 瓦片贴图等)。 ## 文件说明 | 文件 | 作用 | |---|---| | `lzo1x.py` | LZO1X-1 解压器(从游戏内 `sub_473FC0` 反汇编忠实移植) | | `arle.py` | SWD2k ARLE(引擎自带 RLE)解码器 | | `tsw.py` | TSW 文件读取器(库 + 命令行导出 PNG) | | `tsw_viewer.py` | PyQt6 图形界面查看器 | | `mapedit/lmf.py` | HUGE.lmf 场景包解析(索引 / MSF3 块 / 瓦片池 / 子表) | | `mapedit/viewer.py` | PyQt6 地图场景预览器 | | `scriptviewer/talk.py` | talk*.dat 剧本容器解析(目录 / 剧本切片 / 命令行) | | `scriptviewer/bytecode.py` | Talk 虚拟机指令长度表与注释式反汇编 | | `scriptviewer/textscan.py` | Big5 对白抽取与十六进制视图 | | `scriptviewer/viewer.py` | PyQt6 剧本查看器 | | `requirements.txt` | 依赖(仅 PyQt6) | ## 安装运行 ```bash pip install -r requirements.txt # 图形界面 python tsw_viewer.py python tsw_viewer.py "E:\BaiduNetdiskDownload\新仙剑奇侠传XP\all_char.tsw" # 命令行导出 PNG python tsw.py all_sys.tsw --list # 列出全部图像索引 python tsw.py all_sys.tsw --id 3 --out out # 导出 id=3 的全部子图 python tsw.py all_char.tsw --id 1 --sub 0 --out out # HUGE.lmf 地图场景预览(自动在默认游戏目录找 huge.lmf / huge2.lmf) python -m mapedit python -m mapedit "E:\BaiduNetdiskDownload\新仙剑奇侠传XP\huge.lmf" python mapedit/viewer.py "E:\BaiduNetdiskDownload\新仙剑奇侠传XP\huge.lmf" # 也可直接跑脚本 python mapedit/lmf.py huge.lmf --map 12 --frame 0 --png map12.png # 命令行导出 # talk*.dat 剧本查看(自动在默认游戏目录找 talk1..8.dat) python -m scriptviewer python -m scriptviewer "E:\BaiduNetdiskDownload\新仙剑奇侠传XP" python scriptviewer/viewer.py "E:\BaiduNetdiskDownload\新仙剑奇侠传XP" python scriptviewer/talk.py "E:\BaiduNetdiskDownload\新仙剑奇侠传XP" --list python scriptviewer/talk.py "E:\BaiduNetdiskDownload\新仙剑奇侠传XP" --text 132 python scriptviewer/talk.py "E:\BaiduNetdiskDownload\新仙剑奇侠传XP" --dump 132 python scriptviewer/talk.py "E:\BaiduNetdiskDownload\新仙剑奇侠传XP" --search 靈兒 python scriptviewer/talk.py "E:\BaiduNetdiskDownload\新仙剑奇侠传XP" --all-text talk_all.txt ``` TSW 界面左侧为图像条目列表(id / 子图数 / bpp),点击条目显示其子图(序号 / 尺寸), 点击子图即解码显示;支持适应窗口 / 多级缩放、Ctrl+滚轮缩放、"特殊色透明"开关、 导出 PNG。 mapedit 界面:左侧地图列表(按地图号/尺寸筛选),中间为整张场景图(滚轮缩放、 左键拖动平移、点击查看单元格信息),右侧为地图信息 / 对象(传送点)定义 / 场景对象 摆放 / 事件表;工具栏可切换帧(水系乒乓动画可播放)、网格、阻挡格叠加、对象矩形, 并可导出当前帧或全部帧 PNG。 scriptviewer 界面:左侧剧本列表(默认只显示含对白的剧本,可按剧本号/区间/文件筛选), 中间三页——**对白**(Big5 解码后的台词,可切换显示 `%N/%C/%Q` 控制码)、 **反汇编(实验性)**(逐词注释:已知指令按长度整体显示,对白与未识别数据分色)、 **十六进制**(带 Big5/ASCII 侧栏);右侧支持全库对白搜索(双击命中跳到对应剧本) 与剧本信息(目录槽位、偏移、长度、指令识别率)。可导出单剧本或全部对白。 **改对白**:在「反汇编」页双击 `TEXT` 行 → 弹窗编辑(回车即原来的 `%N`,`%Q` 自动补回,`%C` 等控制码原样保留)→ 保存直接覆盖 talkN.dat,编码仍是 Big5: - 长度不变:原位覆盖,文件大小和目录都不变; - 长度变化:切分/插入字节,把该剧本之后所有目录项整体平移,并更新 MZ 头的 页数与末页字节数;写盘前会重新解析一遍做自检(其它剧本逐字节比对), 自检不过就放弃写入; - 首次修改前自动留一份 `talkN.dat.bak` 原件; - 本文件最靠前的那一个剧本与目录区物理重叠(目录区尾部被它的字节码占用), 对它只允许**等长**修改,改长度会被拒绝; - Big5 表示不了的字符(如 emoji、部分简体新字)会在弹窗里标红并禁止保存。 **改字节**:在「反汇编」页双击「原始字节」列(或除对白 / 跳转目标列以外的任意列), 或在「十六进制」页双击 hex 区里的任意一个字节,会弹出十六进制编辑器: - **只能修改、不能增删**:字节数必须和原来完全一致,少一个或多一个都会禁用「保存」; - 编辑框用覆盖模式,光标移到某个字节前直接键入两位 hex 即可替换;可整行/整条指令批量改; - 右侧是 Big5/ASCII 实时预览,底部列出改了哪些字节(`+偏移: 原值→新值`); - 长度不变,所以目录表、跳转目标、MZ 头都不动,文件总大小不变;首次修改同样留 `.bak`。 ## TSW 文件格式(逆向结论) ``` 文件头 28 字节: [24 字节保留][u32 图像条目数 count] 索引区: count × 44 字节条目 +0 8 字节 名称/哈希 +8 u32 未知 +20 u32 数据区字节数 +24 u32 数据区文件偏移 +28 u32 图像 id(从 1 开始) 每个数据区(图像组): +0 u32 未知 +4 u16 magic = 0xABCD +6 u16 子图数 +8 u16 bpp(16 或 8;为 8 时 +12 处有 512 字节调色板) +10 u16 未知(常见 12) +12 [bpp==8: 512 字节调色板 256×u16] 然后 子图数 × 36 字节记录: +0 u32 压缩数据偏移(相对数据区起点) +4 u32 压缩大小 +8 u32 解压后大小 +12 u32 是否附带调色板块 +16 u32 调色板压缩大小 +20 u32 调色板解压后大小 +32 u16 宽 / u16 高 之后是各子图 LZO 压缩数据块 ``` **单张图解码链**:`LZO1X 解压 → ARLE 解码 → 像素位图` **像素格式是 RGB555**(R=bit10-14, G=bit5-9, B=bit0-4,bit15 闲置),不是 RGB565。 依据:`InitRleColorTables` 默认掩码 0x7C00/0x03E0/0x001F;实测 16bpp 数据 bit15 恒 0; 8bpp 调色板含 0x7FFF(555 白)不含 0xFFFF。游戏运行时再按 DDraw 表面格式转换显示。 ## LZO1X 流格式(按游戏内解码器反汇编) - 首控制字节: `>17` 字面量(c-17)(<4 字节时后接短匹配用无偏移公式); `<16` 字面量(c+3,c==0 走扩展);`16/17` 直接是匹配令牌 - 匹配令牌: `≥64` M4 长(c>>5)+1 距 1+((c>>2)&7)+(op<<3);`≥32` M3 长(c&31)+2 距 1+(u16>>2); `≥16` M2 长(c&7)+2 距 16384+16384*(c&8)+(u16>>2)(距 0 为流结束标记); `<16` 短匹配长 3,距 2049+(c>>2)+(op<<2)(literal 后)或 1+(c>>2)+(op<<2)(trailer 后) - 每个匹配后: trailer 字面量数 = 最后一个操作数字节 & 3;为 0 则回到循环头,否则先拷贝再读匹配令牌 ## ARLE 格式(arle.cpp) ``` 头部 8 字节: [u16 0xFFFF][u16 w][u16 h][u16 bpp|flags] 每行: [u16 行头(字节数, 不使用)] [令牌...] [u16 0 结束] 最后: [u16 0] 结束整个数据 令牌: 0x8000|n -> n×颜色A; 0xC000|n -> n×颜色B; n -> n 个字面量像素 颜色(InitRleColorTables @0x43E015 初始化): 16bpp: A=0x31BF, B=0x026B 8bpp: A=索引3, B=索引1 ``` 游戏里这两个颜色同时充当粒子系统的背景标记色,查看器提供"特殊色透明"开关。 ## HUGE.lmf / HUGE2.lmf 格式(mapedit) ``` +0x000 u32 索引偏移 +0x004 MSF3 数据块序列 末尾 索引 = N × 16B {u32 块偏移, u32 块大小, u32 地图号, u32 保留} ``` 每个 MSF3 块(偏移相对块起点): ``` +0x000 "MSF3" +0x004 u32 头结构偏移(=260);随后 u32 表项: [2][3] 单元格属性 offset/size(LZO → 4B×格数) [4][5] 对象(传送点)定义 offset/size(u32 数 + 48B 条目:4×u32 + 32B 名称,Big5) [6][7] 事件表 offset/size(u16 数 + 8B 头 + 16B 条目) [8][9] 场景对象摆放 offset/size(u16 数 + 8B 头 + 16B 条目:事件号/x1/y1/x2/y2/标志) [10][11] 每对象脚本表 [14][15] 地图像素块 offset / 头长度(1024) [16][17] [18][19] 附加 LZO 块(部分地图有) +260 u16 地图头:宽(格) 高(格) 格像素(=16) 瓦片数 帧数 ... +280 瓦片索引表:帧数×宽×高 × u32,低 16 位 = 瓦片号 像素块 +0 u32 未知 +4 u32 单块上限(1MB) +8 u32 解压总大小 +12 0 +16 起若干 (u32 数据偏移, u32 压缩长度),LZO 解压后顺序拼接: [0x000:0x200] 512B 调色板区(16bpp 地图全 0) [0x200 起] 瓦片池,每瓦片 0x200 字节 = 16×16 RGB555 ``` 要点(都被 `mapedit` 复现并验证): - 地图像素格式是 **RGB555**(不是 8bpp 索引),瓦片 16×16、每块 0x200 字节; 直接用 `QImage.Format_RGB555` 即可零转换显示(用 `Format_RGB16/565` 会整体偏绿)。 - 瓦片按 **帧平面** 排布(帧0 的 宽×高 块、帧1 的…),引擎用 `瓦片号 × 0x200` 取数据; 同一瓦片可被多格复用(个别地图瓦片池小于格数,或索引不是从 1 连续开始)。 - 帧数 > 1 的地图是 **乒乓动画**(多为水波),引擎逻辑:`dword_51A51C = 格数 × 帧`, 帧号来回递增递减(`sub_4225E0`)。 - 单元格属性位:bit30/bit29 阻挡、bit27 不绘制、bit26 贴图标志、低 8 位对象号。 ## talk*.dat 格式(scriptviewer) 文件 = **512 字节 DOS-MZ 头 + 1000 项偏移目录 + 字节码区**: ``` +0x000 "MZ" | u16 末页字节数 | u32 页数 | u16 头长(段)=0x20 | … | u16 0x18=30 | u16 1 +0x200 1000 × u32 目录项:剧本在文件中的偏移(相对于 +0x200) +0x200+ 字节码区(剧本按目录顺序紧密排列,第一个剧本紧接目录) ``` - 剧本号 → 文件:`talk{(n-1)//1000+1}.dat`,目录槽 `(n-1)%1000` (VM 里是 `ceil(n/1000)` 与 `0x200 + (n%1000)*4`,两式等价) - VM 把 `目录项 + 0x200` 处开始、最多 32KB 读进缓冲区,PC 存在剧本对象 `+0x1C` - 取指 `op = WORD[pc] & 0x3FFF`;分派表 122 + 110 + 9 例,覆盖 `1..122 / 123 / 124..233 / 777 / 778..786 / 1024 / 1025 / 1026 / 0x3FFF` - 每个剧本首条指令都是 `0x0402`,`0x3FFF` 是 Talkend - 台词是内联的 Big5 字节串,夹带 `%` 控制码:`%N` 换行、`%C` 换色、`%Q` 结束; 字符串没有长度前缀,所以 viewer 用“连续合法 Big5 + 常用字区占比”来切段 ## 游戏运行时也能看到「当前正在显示」的台词 IDA 动态调试确认:Talk VM 用 `CreateFileA(..., dwShareMode=0)` **独占**打开当前 正在执行的 `talkN.dat`(实测停在「孩童唱道:呂洞賓,乘風飄…」时独占 talk3.dat, 占用者 Palgame.exe)。此时任何 `open()` / `CreateFileW()` 都报 `PermissionError`, 旧版 `TalkLibrary.open_folder()` 把异常塞进 `errors` 后静默跳过整个文件——那 1000 个剧本(含当前台词所在的 talk2004)从列表和全库搜索里凭空消失,界面上 却没有任何提示。完整库其实能正常解析该剧本,问题只在「读不到文件」。 修复(`scriptviewer/winfile.py`): - 普通读失败时先用 **Restart Manager** 查出占用者 PID,只在该进程的句柄表里 `DuplicateHandle` 复制目标文件句柄,读完整内容并**恢复原文件指针**(复制的 句柄与原句柄共享文件指针,不能打乱正在运行的游戏); - 回退路径全表扫描时用 `GetFileType == FILE_TYPE_DISK` 过滤,避免对管道/设备 句柄查询路径; - 载入错误现在会显示在状态栏、打开目录时的弹窗和搜索结果提示里; - 写回时若目标仍被独占,改动存为 `talkN.dat.pending` 并提示关闭游戏后手动替换; - `%C6` / `%C5` 这类带颜色号的换色码整体渲染为 `[%C6]`,不再切成 `[%C]6`, 编辑往返与 Big5 字节保持完全一致。 实测:游戏运行中直接打开游戏目录,8 个文件 / 7400 个剧本全部载入(0.35s), 搜索「孩童唱道」命中 talk2004,反汇编覆盖 1432/1432 字节。 ## 已验证 - 6 个 `.tsw` 文件(char/item/magic/sys/map1/map2)全部条目索引解析 - 16bpp:640×480 游戏界面、44×96 角色精灵、236×148 物品框等,导出 PNG 目视正确 - 8bpp:调色板 + 索引解码正确(如 all_sys id=122 的 104×104 像素场景) - GUI 离屏冒烟测试通过(渲染 / 缩放 / 透明开关 / 导出) - `huge.lmf` 320 张 + `huge2.lmf` 149 张地图全量解析通过(0 失败), 地图尺寸 640×480 ~ 2560×1920,4 张为 3 帧动画;帧合成缓冲区尺寸校验通过 - talk1..8.dat 全部 7400 个剧本解析通过,抽出 5833 段 Big5 对白( 如 talk100「嘿∼跑得了和尚…」、talk132「我叫趙靈兒∼你呢?」「得到紫金丹」); talk5/talk6 无对白,与“纯调度脚本”的结论一致 - 反汇编的指令长度表来自 VM 伪代码 `a1[14] += N`,配合逐词注释, 约 54% 的字节能被识别为已知指令(其余为对白/未定长指令,单列显示,不会错位) - 对白改写:全库 5833 段对白编码往返(解码→编辑→编码)与原字节完全一致; 在 talk1/talk2 副本上做了等长、+14、-14、+16 字节的改写,重开文件后剧本数、 其它剧本内容、MZ 头声明大小均正确;与目录重叠的首个剧本改长度会被拒绝