网易NeoX引擎NPK文件解包全攻略：用unnpk从零提取游戏资源与脚本源码

网易NeoX引擎NPK文件解包全攻略：用unnpk从零提取游戏资源与脚本源码

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

如果你玩过《阴阳师》或《魔法禁书目录》，一定好奇过客户端里那些精美的立绘、音效和战斗脚本藏在哪里。答案是它们都被打包进了一种名为 NPK 的资源容器中。unnpk 正是一款专门针对网易 NeoX 引擎 NPK 文件解包的开源命令行工具，它能把加密压缩的二进制资源包拆解为按类型归类的普通文件，是游戏资源提取、NeoX 引擎逆向与脚本源码还原研究中绕不开的入门利器。本文将从"为什么要拆包"讲起，带你完成编译、解包、格式剖析、脚本还原直至批量自动化，全程使用真实可执行的命令。

为什么要自己拆开 NPK：先搞懂资源包的"封条"逻辑

游戏客户端为了减少磁盘碎片、加快加载速度并防止资源被轻易拿走，通常会把成百上千个小文件合并成一个大的资源包。NPK 就是网易 NeoX 引擎采用的这种合并格式，它同时承担了三件事：

1. 收纳：纹理、模型、骨骼、音视频、配置 XML、Python 脚本全部塞进单一文件；
2. 压缩：数据区普遍使用 zlib 流压缩，减小安装包体积；
3. 索引：文件尾部维护一张目录表，记录每个内部资源的偏移、大小与压缩标记。

官方客户端只提供"播放资源"的能力，不提供"导出资源"的入口。于是，想分析渲染管线、提取素材、研究技能脚本逻辑，或是做 MOD 与汉化，第一步都得先完成 NPK 文件解包。

unnpk 项目恰好提供了完整的工具链：C 语言编写的unnpk负责真正解包，mapnpk负责只读侦察目录结构，tools/下的 Python 脚本则负责处理最难啃的脚本资源。整个项目体量极小，主程序只有一个文件，非常适合作为学习二进制格式解析的范例。

5 分钟完成环境搭建：依赖安装与编译

unnpk 依赖libmagic（用于识别文件类型）和zlib（用于解压数据），不同系统安装方式略有差异：

依赖就绪后，克隆仓库并编译：

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

编译过程非常快，因为 Makefile 里只有两条 gcc 命令。完成后当前目录会出现两个可执行文件：

• unnpk：主解包工具，解压资源并自动识别类型；
• mapnpk：目录分析工具，只打印资源清单不落盘。

想清理产物重新编译，执行make clean && make即可。

第一次解包实战：一条命令导出全部资源

拿到任意一个 NPK 文件，比如game_res.npk，解包只需要一条命令：

./unnpk game_res.npk output

程序会在终端打印一份 Markdown 风格的清单，随后把文件写入output目录。输出的目录结构很讲究——资源会按 MIME 类型自动分文件夹存放，例如output/image/png/、output/text/xml/、output/video/mp4/，每个文件以 8 位十六进制序号命名（如0A0D60DC.png），序号来自目录表中的内部索引。

提示：NPK 内部并不保存原始文件名，只保存索引号。所以解包后看到的十六进制名是正常的，这正是 NeoX 引擎资源管理的特点。

动手前先用mapnpk侦察一下包内情况，避免盲解：

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

• -f markdown|csv控制输出格式，CSV 便于后续用脚本二次分析；
• -t hex|int|original控制数值展示方式，original会按磁盘上的原始字节序输出，适合核对小端序细节。

生成的清单会告诉你：文件总大小、目录区偏移、每个资源的索引、偏移、压缩前后大小以及是否被压缩，做到心中有数再解包。

核心机制深挖：NPK 的目录区与数据区如何协同工作

要说清 unnpk 的原理，得先看它读取文件的顺序。打开 unnpk.c，流程非常直白：

1. 把文件指针定位到偏移0x14（即头部第 21 个字节），读取一个uint32作为目录区起始偏移map_offset；
2. 从map_offset开始，每 28 字节（7 个uint32）解析一条目录记录，直到文件末尾；
3. 按记录中的偏移与大小把数据段读入内存，必要时用 zlib 解压；
4. 用 libmagic 识别内容类型，决定扩展名与存放目录。

目录记录的核心代码如下（节选自 unnpk.c 的循环主体）：

uint32_t entry[7]; // 每条记录固定 7 个 uint32 字段 for (uint32_t pos = map_offset; pos < npk_size; pos += 7 * 4) { fseek(npk, pos, SEEK_SET); fread(entry, 4, 7, npk); // entry[0] 资源序号（输出文件名来源） // entry[1] 数据在文件中的偏移 // entry[2] 压缩后大小（若未压缩则等于原始大小） // entry[3] 解压后大小 // entry[6] 压缩标记：非 0 表示数据被压缩 }

解压逻辑同样值得学习，它处理了三种异常分支：

uLongf expect = entry[3]; int rc = uncompress(out_buf, &expect, raw_buf, entry[2]); switch (rc) { case Z_OK: break; // 正常解压 case Z_BUF_ERROR: /* 目录表大小不一致，回退输出原始数据 */ case Z_DATA_ERROR:/* 数据根本不是 zlib 流，同样回退原始数据 */ }

这个"解压失败就降级输出原始字节"的设计非常实用：它保证了即使个别目录记录被篡改或版本不同，解包过程也不会中断，最多产出几个内容存疑的文件。理解这一点，对后续排查问题很有帮助。

类型识别引擎：如何让每份资源"对号入座"

解压出的字节流只是一堆二进制，怎么知道它是 PNG 还是 XML？unnpk 采用了"两层识别"策略：

第一层：libmagic 嗅探 MIME 类型。代码用magic_buffer对内存中的解压结果做内容识别，得到类似image/png、text/xml的类型字符串，直接用作输出子目录名。

第二层：特征匹配细化扩展名。通用 MIME 只能粗分类，unnpk 还针对 NeoX 引擎的特色资源做了精细识别：

对应的判定代码形如（节选自 unnpk.c）：

if (strstr(type, "image/png")) ext = ".png"; else if (strstr(type, "video/mp4")) ext = ".mp4"; else if (memmem(buf, len, "vec4", 4)) ext = ".glsl"; else if (buf[0] == '{' && buf[len-1] == '}') ext = ".json";

可以看出，这套识别规则是"通用库 + 领域特征"的组合拳，对研究同类资源包的开发者有很强的借鉴意义。

高阶链路：把 script.npk 还原成可读的 Python 源码

普通资源解包只是热身，NeoX 引擎更硬核的地方在于：游戏逻辑脚本被打包成了加密的 Python 字节码。以《阴阳师》的script.npk为例，完整还原链路需要三步，对应 tools/ 下的三个脚本。

第一步：解密脚本内容。从包中解出的某个文件（例如0A0D60DC）是经过 ROTOR 加密、zlib 压缩并做了字节反转的 marshal 数据。 tools/script_redirect.py 把密钥拆成三段字符串拼接而成，还原过程如下：

def restore(data): k1 = 'j2h56ogodh3se' k2 = '=dziaq.' k3 = '|os=5v7!"-234' seed = k1 * 4 + (k2 + k1 + k3) * 5 + '!#' + k2 * 7 + k3 * 2 + "*&'" cipher = rotor.newrotor(seed) # ROTOR 流密码解密 plain = cipher.decrypt(data) plain = zlib.decompress(plain) # 解掉 zlib 压缩层 return _flip(plain) # 反转字节序并做异或还原

注意_flip会对前 128 个字节逐个与154异或，再整体反转，这是防静态分析的障眼法。

第二步：修复被替换的 opcode。解密得到的字节码并不能直接反编译——网易对 Python 2.7 的指令码做了替换，比如把原 opcode1换成了38。tools/pyc_decryptor.py 内置了一张"密文 opcode → 明文 opcode"的映射表，配合 tools/pymarshal.py 这套自实现的 Python marshal 序列化器，遍历代码对象的co_code逐字节替换，最后补上\x03\xf3\x0d\x0a开头的 pyc 文件头：

./tools/script_redirect.py 0A0D60DC > 0A0D60DC.out ./tools/pyc_decryptor.py 0A0D60DC.out 0A0D60DC.pyc

第三步：反编译为源码。

uncompyle2 -o 0A0D60DC.py 0A0D60DC.pyc

注意：不同游戏的redirect.py密钥可能不同。一个实用思路是——redirect.pyc本身就藏在script.npk里，解包后按特征找出来再逆向它，就能拿到该游戏专属的密钥与 opcode 表。

批量解包与自动化：面对海量 NPK 的提效方案

一个游戏客户端往往有几十个 NPK 包，逐个手动解太慢。下面这套组合拳可以把流程完全自动化：

# 方案一：循环逐个解包并统计结果 for npk in *.npk; do out="${npk%.npk}_out" ./unnpk "$npk" "$out" >/dev/null 2>&1 echo "$npk -> $out : $(find "$out" -type f | wc -l) files" done # 方案二：四路并行处理，显著缩短总耗时 ls *.npk | xargs -n 1 -P 4 -I {} ./unnpk {} {}_out

如果只想提取包内某类资源，可以先用mapnpk导出 CSV 清单，再交给脚本筛选：

./mapnpk -i game_res.npk -o index.csv -f csv -t hex grep "image/png" index.csv # 结合 awk/cut 进一步定位感兴趣的资源

常见问题与排查清单

实际使用中，新手最容易遇到下面几类问题，这里给出定位思路：

如果怀疑某个资源内容不对，最直接的办法是用hexdump -C查看解出文件的前若干字节，对照 unnpk.c 的识别分支就能判断是哪一步出了问题。

在 unnpk 之上：还能做哪些延伸开发

读懂源码之后，这个项目完全可以作为二次开发的起点：

• 扩展类型识别：在 unnpk.c 的扩展名判定链中追加新分支，比如识别astc、webp等新格式；
• 增强容错：目前解压失败会降级输出原始数据，可以改成记录错误日志并继续，便于批量审计；
• 多游戏适配：针对不同 NeoX 版本维护独立的密钥与 opcode 表，封装成配置文件驱动；
• GUI 封装：用 Python 的 tkinter 或 Electron 包一层界面，把unnpk变成拖拽即用的图形工具。

延伸方向的具体实现可参考 tools/pymarshal.py 的自定义序列化写法，它展示了如何在不依赖官方 marshal 的情况下按需改写字节流。

结语：从拆包开始，打开资源研究的大门

回顾全文，unnpk 的价值不只是"能解包"，更在于它用极简的代码把 NPK 文件解包、类型识别、加密脚本还原这三件事讲清楚了：一条命令搞定资源提取，28 字节的目录记录揭示格式本质，三层解密链路展示实战级逆向思路。无论你是想提取游戏素材、研究 NeoX 引擎逆向，还是单纯想学习二进制解析，都可以从克隆仓库、跑通make开始，亲手解开第一个 NPK 包。项目使用说明与后续更新请以仓库内的 README.md 为准，也欢迎为它补充更多游戏的适配经验。

关键词清单

• 核心关键词：NPK 文件解包、unnpk 工具、网易 NeoX 引擎
• 长尾关键词：阴阳师资源提取、NeoX 引擎逆向、NPK 格式解析、script.npk 反编译、pyc 字节码还原、libmagic 文件类型识别、zlib 解压、游戏资源包分析

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