NPK文件解析实战：用unnpk快速解包网易NeoX游戏资源-平芜编程栈

NPK文件解析实战：用unnpk快速解包网易NeoX游戏资源

【免费下载链接】unnpk解包网易游戏NeoX引擎NPK文件，如阴阳师、魔法禁书目录。项目地址: https://gitcode.com/gh_mirrors/un/unnpk

想从阴阳师、魔法禁书目录这类网易NeoX引擎游戏里提取美术素材和配置文件？很多朋友第一反应是找个通用解压工具硬上，结果全是"无法识别的文件格式"。原因很简单：NPK不是普通压缩包，它自带一套私有索引结构和压缩标记，普通工具根本不认。开源工具unnpk正是为NPK文件解析而生，它用两个C程序搞定解包全流程，还附带一套阴阳师加密脚本的解密工具链。这篇文章就带你把"NPK文件解析"这件事从原理到实战彻底跑通。

一、先讲个让人头疼的场景：你下载的资源包打不开

假设你费尽周折拿到了某个游戏的.npk资源包，兴冲冲地双击或者用 zip/7z 打开，得到的只有乱码。这不是文件损坏，而是 NPK 的封装方式决定的：

文件内部没有标准目录树，而是一张二进制索引表；
大部分条目是zlib 压缩过的，文件名也早已被丢弃，只剩一串十六进制编号；
部分敏感文件（比如脚本）还会再做一层自研加密。

也就是说，哪怕你硬把数据抠出来，也不知道它原来是什么格式、该叫什么名字。unnpk 的价值就在这里：它把"读索引 → 解压 → 识别类型 → 自动命名归类"整条链路做成了两条命令。

二、先看内部构造：NPK 到底长什么样

要理解 unnpk 为什么这么写，先看 NPK 的布局。简单说，一个 NPK 文件可以拆成三块：

┌─────────────────────────────────────────┐ │ 头部 (Header) │ │ 0x00~0x13 签名与版本等元信息 │ │ 0x14 文件索引表偏移量 map_offset │ ├─────────────────────────────────────────┤ │ 数据区 (Data) │ │ 各文件原始数据，按索引指向的偏移存放 │ ├─────────────────────────────────────────┤ │ 索引表 (Index / Map) │ │ 每 28 字节一条，共 7 个 uint32 字段 │ └─────────────────────────────────────────┘

索引表每一条记录是 7 个 4 字节整数，对应含义如下：

字段	含义
file_info[0]	文件编号（输出文件名就用它）
file_info[1]	数据在包内的偏移量
file_info[2]	压缩后大小
file_info[3]	解压后大小
file_info[6]	是否压缩（非 0 为是）

unnpk 的解包逻辑在 unnpk.c 里非常直白：先跳到0x14位置读出索引表偏移，然后从那里每隔 28 字节读一条记录，按偏移把数据抠出来。如果file_info[6]非零或者压缩前后大小不一致，就调用 zlib 的uncompress解压；解压失败时它不会崩溃，而是把原始数据原样输出并打一行警告——这种"宁可给原始数据也不让你空手而归"的设计，对折腾党非常友好。

三、三步完成环境搭建与编译

编译 unnpk 只依赖两个库：zlib（通常系统自带）和 libmagic（用于识别文件类型）。按你的系统装依赖：

# macOS brew install libmagic # CentOS / RHEL sudo yum install file-libs file-devel # Debian / Ubuntu sudo apt-get install libmagic-dev

获取源码并编译：

git clone https://gitcode.com/gh_mirrors/un/unnpk cd unnpk make

编译规则写在 Makefile 里，只有两条gcc命令，几秒钟就能出两个可执行文件：

unnpk：主程序，负责解包；
mapnpk：辅助工具，负责"体检"NPK 的索引结构。

验证一下：

ls -la unnpk mapnpk

预期输出两个带执行权限的二进制文件，能看到-rwxr-xr-x之类的权限位就说明编译成功。

四、实战走查：先体检，再解包

第 1 步：用 mapnpk 给 NPK 做体检

解包前先用mapnpk看看包内索引长什么样，做到心里有数：

./mapnpk -i game_res.npk

输出会是一张 Markdown 表格，包含每个文件的编号、偏移量、压缩前后大小和是否压缩的标志。如果嫌屏幕滚动太烦，可以直接导出：

./mapnpk -i game_res.npk -o structure.md -f markdown -t hex

-f支持markdown和csv两种格式，-t支持hex/int/original三种数值显示方式。其中original会按原始字节序输出，方便对照十六进制编辑器里的内容。想拿去做二次分析，用 CSV 格式最顺手：

./mapnpk -i game_res.npk -f csv -t int > structure.csv

第 2 步：一行命令完成解包

mkdir -p extracted ./unnpk game_res.npk extracted

运行期间控制台会实时打印一张"解包清单"，包含编号、偏移、压缩前后大小、是否压缩、MIME 类型和扩展名，每一行代表一个成功落盘的文件。落盘规则是这样的：

extracted/ └── 按 MIME 类型分目录/ └── 文件编号(十六进制) + 自动识别的扩展名

比如一张图会落在extracted/image/png/0A0D60DC.png，一段视频落在extracted/video/mp4/xxxx.mp4。这就是 libmagic 的功劳——它不看扩展名，直接嗅探文件内容，所以哪怕包内所有文件名都被抹掉，也能还原出正确的类型。

第 3 步：验证结果

find extracted -type f | head -20 find extracted -type f | wc -l

wc -l输出的数字应该和刚才解包清单的行数一致。如果某个文件是Z_BUF_ERROR或Z_DATA_ERROR警告输出的原始数据，它也会出现在目录里，只是扩展名为空。

五、进阶玩法：阴阳师脚本解密的完整四步

普通资源解包到这里就结束了，但阴阳师的script.npk里藏的是加密过的 Python 2.7 字节码，直接解包拿到的还是乱码。这套解密流程需要走四步，工具链都在 tools/ 目录下。

先补齐 Python 2.7 环境（macOS 示例）：

brew install python2 pip install rotor git clone https://github.com/wibiti/uncompyle2.git cd uncompyle2 && python setup.py install

说明：rotor是 Python 2 时代的加密模块，uncompyle2 是专门反编译 Python 2.7 字节码的工具，这两个都是这套流程的硬依赖。

第 1 步：解包 script.npk

./unnpk script.npk script_raw

第 2 步：用 script_redirect.py 做第一层解密

python2 tools/script_redirect.py script_raw/0A0D60DC > 0A0D60DC.out

这个脚本是根据逆向阴阳师得到的redirect.py改写而来（源码见 tools/script_redirect.py），解密逻辑是"rotor 解密 → zlib 解压 → 前 128 字节逐字节异或 154 再整体反转"。三层全部做完，输出就是接近原始的字节码数据。

第 3 步：用 pyc_decryptor.py 纠正 opcode

阴阳师的字节码还做了 opcode 重映射，直接把上一步输出当 pyc 用 uncompyle2 会报错。需要用 tools/pyc_decryptor.py 按内置的映射表还原，并补回 Python 2.7 的 pyc 头：

python2 tools/pyc_decryptor.py 0A0D60DC.out 0A0D60DC.pyc

第 4 步：反编译成可读源码

uncompyle2 -o 0A0D60DC.py 0A0D60DC.pyc

到这一步，你就能在0A0D60DC.py里看到接近原始写法的 Python 代码了。

六、高频报错自查清单

症状	原因	处理办法
`E: npk file open failed`	路径不对或没权限	检查文件是否存在、当前用户是否有读权限
`W: mkdir failed`	输出目录已存在	这是警告不是错误，换一个新目录名即可
`Z_DATA_ERROR: Data is not zlib`	索引与数据不匹配，或该文件本身未压缩	unnpk 会自动输出原始数据，扩展名可能为空
`Z_BUF_ERROR: Map is not right`	索引表损坏或版本差异	先跑`mapnpk`核对索引，确认文件是否完整
`E: No enough memory!`	单文件过大或内存不足	拆分处理，或换台内存更大的机器
`ImportError: No module named rotor`	Python 2 环境没装 rotor	`pip install rotor`后重试
`uncompyle2: command not found`	uncompyle2 没装好	按上文安装流程重装，注意它只支持 Python 2

七、想自己扩展？二次开发就这么简单

unnpk 的代码量很小，扩展点也很清晰：

加文件类型规则：类型判断集中在 unnpk.c 里的一串strstr/strcmp分支。想支持新格式，照着image/png分支抄一段，把 MIME 判断和扩展名替换掉，重新make即可。比如 KTX、RGIS、PKM 这类引擎专用纹理格式就是这么加进去的。
改输出结构：输出路径规则在sprintf(file_out_name, ...)那一行，想改成"按文件编号直接平铺"或"保留扩展名分组"，改这一行就行。
调 mapnpk 输出：格式模板在 mapnpk.c 里，markdown/csv两种模板都是硬编码的fprintf，想加个 JSON 输出，照葫芦画瓢加一个FORMAT枚举值即可。