企业官网建设流程全解析

3分钟解开阴阳师NPK文件：UNNPK网易游戏资源解包工具入门指南

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

每次看到《阴阳师》《魔法禁书目录》这类网易NeoX引擎游戏里那些精美的立绘、技能特效和地图素材，你是不是也好奇过——这些资源到底藏在哪？能不能提取出来做同人创作、技能拆解或者技术研究？答案就藏在一个叫 NPK 的文件包里。而 UNNPK，就是专门为网易 NeoX 引擎 NPK 文件解包而生的开源小工具，两条命令就能把封闭的游戏资源包拆成看得懂、用得上的普通文件。

一、为什么你的游戏资源"打不开"？

1.1 NPK 是什么：游戏界的"带锁行李箱"

NPK 是网易 NeoX 引擎用来打包资源的专有格式。你可以把它想象成一只带密码锁的行李箱：游戏立绘、UI 图片、场景配置、Python 脚本统统塞在里面，统一压缩、统一管理。

好处是游戏加载快、文件整洁；坏处是——这只箱子只有游戏自己打得开。你用普通的解压软件去开 NPK，只会得到一堆乱码报错，因为它的"锁芯"（文件头格式、目录索引位置、压缩方式）都是网易自研的，外界一无所知。

1.2 没有它 vs 有它

[!TIP] UNNPK 的核心价值就一句话：把网易专有的游戏资源格式，变成你能直接打开、编辑、复用的标准文件。对做 mod、写攻略站、研究游戏技术的朋友来说，这是省下几十小时逆向时间的捷径。

二、3 分钟跑通第一个解包

2.1 第一步：装好依赖并编译

UNNPK 是 C 语言写的，依赖两个库：zlib（负责解压）和libmagic（负责识别文件类型）。按你的系统装好即可：

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

[!NOTE] 这一步是把"开锁工具"提前备好，之后编译才会通过。若编译时报libmagic not found，多半是开发库没装全，装好重试即可。

然后克隆并编译：

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

这段做了什么：克隆项目、进入目录、用make一键编译。成功后目录里会出现两个可执行文件unnpk（解包主工具）和mapnpk（结构分析工具），就像同时拿到了一把钥匙和一张行李箱内部结构图。

2.2 第二步：解包你的第一个 NPK 文件

./unnpk game_data.npk ./extracted

这段做了什么：把game_data.npk里的所有资源解压到extracted目录。就这么一条命令，工具会自动完成"读取索引 → 逐个解压 → 识别类型 → 归类存放"全部流程。

解压过程中终端会打印一张表格，长这样：

| Index | Offset | Size | Unzip size | zip | MIME Type | Extension | | - | - | - | - | - | - | - | | 00000001 | 0x00001000 | 1.2 MB | 3.5 MB | Yes | image/png | .png | | 00000002 | 0x00015000 | 450 KB | 450 KB | No | text/xml | .NeoX.xml |

看到什么：第一列是文件序号，第二列是文件在 NPK 里的偏移量，zip列告诉你这个文件是否压缩过。解压完成后，去extracted目录看看——文件已经按 MIME 类型分好了文件夹，比如extracted/image/png/00000001.png，整整齐齐，一目了然。

2.3 彩蛋：解包前先"透视"一下

想在不解压的情况下先看看 NPK 里有什么？用mapnpk：

./mapnpk game_data.npk -f markdown -t hex -o report.md

这段做了什么：生成一份 Markdown 格式的 NPK 结构报告，包含文件总大小、索引表偏移量，以及每个内部文件的偏移、压缩大小、解压大小等元数据，保存到report.md。-f选格式（markdown/csv），-t选数值显示方式（hex 十六进制 / int 十进制 / original 原始字节）。

三、藏在代码里的三个巧妙设计

作为一个只有几百行的开源工具，UNNPK 最精彩的地方在于它用极简的代码解决了一个看似复杂的格式问题。挑三个细节给你看。

3.1 巧思一：像查黄历一样"翻到指定页"

NPK 文件怎么知道资源目录存在哪？UNNPK 的做法是：直接跳到文件偏移 0x14 处，读出一个 4 字节的数字，这个数字就是目录索引表（map）的起始位置。

fseek(npk, 0x14, SEEK_SET); // 跳到固定偏移 fread(&map_offset, 4, 1, npk); // 读出目录表位置

这段做了什么：就像一本词典在固定页码印着"正文索引见第 X 页"，UNNPK 从固定的 0x14 偏移读出"第 X 页"（map_offset），然后顺着索引表逐条读文件信息。整个格式解析的钥匙，就藏在这 4 个字节里。

3.2 巧思二：用"大小不一致"判断要不要解压

NPK 里的文件有的压缩过、有的没有。UNNPK 怎么判断？看两个字段：压缩后大小和解压后大小。如果大小不一致，或者标志位为真，说明压缩过，就调 zlib 的uncompress解压；否则直接原样输出。

if (file_info[6] || file_info[2] != file_info[3]) { uncompress(file_out_buf, &file_destLen, file_read_buf, file_info[2]); }

这段做了什么：一句话点破判断逻辑——"变大了"就说明是压缩包，拆开它；"没变大"就直接拿走。这让工具不必逐个试探，又快又准。

3.3 巧思三：像文物鉴定一样"看细节认类型"

解出来的文件怎么知道是什么格式？UNNPK 用两层判断：先用libmagic库识别 MIME 类型（image/png、text/xml……），再看文件内容里的特征字符串做精确分类。比如内容里同时出现vec4、tex2D这类关键字，就判定为 GLSL 着色器文件，后缀改成.glsl；开头是<NeoX的 XML，就命名为.NeoX.xml。

这段做了什么：普通工具只认扩展名，UNNPK 直接"读心"——靠内容特征判断真实类型，所以从 NPK 里解出来的文件几乎都能自动恢复正确的后缀，省去你手动辨认的麻烦。

四、完整实战：解开阴阳师 script.npk 里的游戏脚本

前面解出来的多半是图片、配置这类资源，而真正让 mod 爱好者两眼放光的是游戏脚本。阴阳师的script.npk里藏着 Python 字节码文件，但它们是加密+魔改过的，直接解出来也读不懂。UNNPK 的 tools 目录为此准备了一条完整的解密链。下面四步走完，你就能把加密脚本还原成可读的 Python 源码。

4.1 准备 Python 2 环境

先说明：script_redirect.py依赖 Python 2 和rotor加密库，所以要先装好：

pip install rotor # 在 Python 2 环境下执行

[!WARNING] 这是整条链路里最容易卡住的一步——Python 2 已经停止维护，建议用虚拟环境或 pyenv 单独装一个，别污染你日常的 Python 3 环境。

4.2 第一步：解包 script.npk

./unnpk script.npk script

这段做了什么：解出阴阳师的全部脚本资源。注意看输出，解出来的文件名是十六进制编号（比如0A0D60DC），它对应文件在 NPK 里的偏移量——这是 UNNPK 的命名规则，靠它保证文件名唯一。

4.3 第二步：rotor 解密 + 解压

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

这段做了什么：对单个脚本文件做三层处理——先逆向 rotor 加密算法解密，再 zlib 解压，最后反转字符串（原脚本把内容倒着存了）。输出重定向保存到.out文件。

[!NOTE] 这个脚本是根据逆向《阴阳师》得到的redirect.py改写而来。里面的三个密钥字符串（asdf_dn、asdf_dt、asdf_df）是按游戏区分的——换一个网易游戏，密钥可能就不同，需要你自行分析。这个思路本身，就是工具作者留给你的寻宝线索。

4.4 第三步：修正魔改的字节码

阴阳师对 Python 字节码做了手脚——opcode 被重新映射过，直接反编译会报错。pyc_decryptor.py内置了一张 opcode 对照表，把它修正回来：

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

这段做了什么：解析魔改后的 marshal 数据，把每个被替换的字节码指令换回标准值，再补上标准 PYC 文件头，生成一个正常工具能识别的.pyc文件。

4.5 第四步：反编译成 Python 源码

uncompyle2 -o 0A0D60DC.py 0A0D60DC.pyc

这段做了什么：调用uncompyle2反编译器，把字节码还原成接近原始形态的 Python 源码。打开0A0D60DC.py，你就能看到游戏某个模块的真实逻辑了。

预期结果：四步走完，0A0D60DC.py是一个语法完整的 Python 文件，可以正常阅读甚至重新运行。至此，一条"NPK 加密脚本 → 可读源码"的完整流水线就跑通了。

五、避坑指南：新手最容易踩的 4 个坑

坑 1：Windows 用户劝退。README 里作者明说"不建议使用 Windows，太折腾了"。建议用 Linux/macOS，或者 WSL 里的 Linux 环境。

坑 2：目录参数结尾别带斜杠。./unnpk game.npk ./out/这种写法工具会自己去掉结尾斜杠，但如果你在脚本里拼路径时想当然，容易出问题。建议统一不带斜杠。

坑 3：解压失败不一定是坏了。运行时会打印Z_DATA_ERROR: Data is not zlib之类的警告——这不是报错，而是说明该文件本来就没用 zlib 压缩，工具会原样输出原始数据，别误删。

坑 4：密钥不通用。阴阳师能解，不代表《哈利波特：魔法觉醒》也能一把梭。不同游戏、不同版本，加密参数可能都不同，需要你结合文件特征自行分析（README 里也留了思路：redirect.pyc本身就存在script.npk里）。

六、结语：从"打不开"到"看得懂"，只差一次动手

NPK 文件解包看起来高深，其实拆开看就是"找索引、解压缩、认类型"三步。UNNPK 把这三步浓缩成了几百行 C 代码和两条命令，让你不用懂格式细节也能立刻上手；而当你深入研究时，源码本身又是极好的格式逆向教材。

下一步建议：先拿一个不太大的 NPK 文件试试unnpk，看看解出来的资源长什么样；再试试mapnpk生成结构报告，感受一下"透视"游戏的乐趣。如果你解开了其他网易游戏，欢迎把经验补回项目文档——开源的意义，就是让下一个卡住的人少走弯路。

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