unnpk解包工具完整实战指南：5分钟提取网易游戏资源-平芜编程栈

unnpk解包工具完整实战指南：5分钟提取网易游戏资源

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

你有没有过这种经历？在游戏目录里翻出一个几百 MB 的.npk文件，直觉告诉你里面藏着精美的角色立绘和地图资源，可打开一看全是乱码和十六进制数字，连个像样的文件名都找不到。unnpk就是为这个场景而生的解包工具：一条命令，把网易 NeoX 引擎的 NPK 资源包完整拆开，图片、音频、脚本、配置全部还原成能直接查看的样子。

一、它到底替你解决了什么

先打个比方。NPK 文件就像一个压缩行李箱：游戏把成千上万的资源——立绘、特效、音频、脚本、XML 配置——一股脑塞进一个大箱子，还上了锁、做了压缩。你要做的不是拿十六进制编辑器对着箱子硬撬，而是用 unnpk 这个"开箱工具"把拉链拉开，把里面的东西一件件整理好。

过去和现在对比一下，差别很明显：

过去（手动逆向）	现在（unnpk 一键解包）
面对乱码二进制，无从下手	一条命令自动解析 NPK 结构
不知道文件是什么类型	自动识别 MIME 类型并补全扩展名
压缩数据要自己写代码解压	内部自动完成 zlib 解压
提取出的文件混成一堆	按类型自动归类到独立文件夹
阴阳师脚本加密难解	配套脚本构成完整解密链

这对你意味着什么？从此你不用再研究 NPK 的二进制格式，就能直接拿到 PNG 原图、PSD 源文件、MP4 视频、字体和各类配置；解包出来的文件自动带正确扩展名，双击就能打开，不用一个个去猜。想更进一步的话，tools目录里的三个 Python 脚本还能带你走通阴阳师脚本的完整解密流程，后面会细说。

二、30秒初见成果：一条命令完成解包的快速方法

先别管别的，直接动手。整个工具的核心就一条命令：

./unnpk 你的游戏文件.npk 输出目录

这条命令会读取 NPK 内部的资源清单，逐个解压文件，按 MIME 类型（如image/png、text/xml）自动创建分类文件夹，并在终端实时打印每个文件的索引、大小、类型和扩展名。

快速上手四步走：

① 获取源码：

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

② 安装依赖：macOS 用brew install libmagic，Ubuntu 用sudo apt-get install libmagic-dev，CentOS 用sudo yum install file-libs file-devel。

③ 编译：执行make，会生成unnpk和mapnpk两个可执行文件。

④ 解包：执行./unnpk scene.npk scene_resources，然后打开scene_resources目录看结果。

看到终端里一行行表格刷出来，输出目录里自动出现了image/png、text/xml这样的分类文件夹，是不是比想象中简单多了？

三、三个让你直呼好用的真实场景

场景一：想拿到阴阳师的立绘原图？三步搞定

为什么需要：官方压包后的立绘无法直接预览，想收集素材只能靠解包。怎么做：解包后进入输出目录的image/png文件夹，找到按索引命名的图片；如果运气好，还能在image/vnd.adobe.photoshop里翻到PSD 源文件，图层都还在。你能得到什么：高清原图，直接用于学习配色、临摹线稿或制作同人作品。

场景二：想研究地图和特效是怎么配置的？

NPK 里不止有图片。解包后进入text分类目录，你会看到.NeoX.xml、.SceneConfig.xml这类场景配置文件，以及.glsl着色器、.obj模型文件。用文本编辑器打开这些 XML，场景的地图配置、音乐触发逻辑、特效参数都一目了然。对想做 MOD 或研究游戏设计的人来说，这些就是最权威的"设计文档"。

场景三：想读懂阴阳师的游戏逻辑？

这才是 unnpk 的完整形态。阴阳师的脚本藏在script.npk里，并且经过多层加密，普通解包只能拿到密文。完整的解密链是四步：

./unnpk script.npk script_extracted ./tools/script_redirect.py 0A0D60DC > 0A0D60DC.out ./tools/pyc_decryptor.py 0A0D60DC.out 0A0D60DC.pyc uncompyle2 -o 0A0D60DC.py 0A0D60DC.pyc

第一行把脚本包解出来，找到目标文件（如0A0D60DC）；第二行用tools/script_redirect.py完成 rotor 解密和 zlib 解压；第三行用tools/pyc_decryptor.py纠正被改过的 Python opcode；最后用uncompyle2反编译成可读的.py源码。走完这四步，游戏的数值、抽卡逻辑、战斗算法就都摊在你面前了。

四、解包常见问题：新手最容易踩的5个坑

编译报错"magic.h not found"：没装 libmagic 开发包。macOS 装 libmagic，Ubuntu 装 libmagic-dev，CentOS 装 file-libs 和 file-devel，装完再 make。
在 Windows 上硬折腾：项目作者明确建议 macOS、Linux 或 FreeBSD，Windows 上各种坑会让你怀疑人生，建议直接用虚拟机或 WSL。
解出来的文件没有扩展名：这是自动识别失败了，不代表文件损坏。用file 文件名查看真实类型，再手动补上扩展名即可。
解密脚本报No module named rotor：脚本需要 Python 2.7 环境，先pip install rotor，再安装 uncompyle2，顺序别搞反。
大文件解包很慢或磁盘爆满：NPK 解包后体积可能膨胀好几倍，建议预留至少 2 倍于原始文件的空间，并尽量放在 SSD 上。

一句话记住：先装依赖，再编译，后解包，大部分报错都出在前两步。

五、从新手到高手的进阶地图

入门：能编译、能解包、能看懂输出目录的结构。练习目标：把自己游戏目录里的 NPK 全部解一遍，熟悉常见的 MIME 分类。

进阶：学会用mapnpk分析 NPK 内部结构。执行./mapnpk game.npk会输出一张包含每个文件索引、偏移量、压缩前后大小、是否压缩的表格；加-f csv参数还能导出 CSV，方便用表格软件做统计分析，比如找出占用空间最大的资源、判断哪些资源被压缩了。

高手：挑战两条路线。一条是研究 NPK 格式本身，对照unnpk.c源码理解资源清单的存储结构，尝试为其他 NeoX 游戏编写支持代码；另一条是逆向脚本加密，README 里提到redirect.py其实就藏在 script.npk 中，不同游戏的密钥可能不同，找到它，就等于拿到了破解该游戏脚本的钥匙。最后，把研究心得整理成 PR 提交给项目，让更多人受益。