企业官网建设流程全解析

一文搞懂NPK文件解析：用unnpk打开网易游戏的资源保险箱

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

你有没有过这样的瞬间：从游戏目录里翻出一个 .npk 文件，双击报错，改名无用，换遍解压软件都只换来一句"不支持"。别急着删——这个文件很可能装着一整座资源宝库，而 NPK文件解析，就是打开它的那把钥匙。今天我们要认识的工具 unnpk，专为网易 NeoX 引擎游戏（阴阳师、魔法禁书目录等）打造，能把加了密、压过缩的资源包完整拆开，让图片、音频、脚本逐一现出原形。本文不讲高深理论，只带你从"撞见问题"一路走到"亲手拆包"，全程陪跑。

一、问题现场：不是文件坏了，而是被"上了三道锁"

先给你一个反常识的结论：当你发现 npk 文件打不开时，绝大多数情况下文件本身好端端的，它只是被精心保护起来了。

你可以把 NPK 想象成一个上了三道锁的资源保险箱：

• 第一道锁：专有封装。NeoX 引擎用自己设计的格式装资源，通用的 zip、rar 解压器根本不认识它的"签名"，连门都摸不着。
• 第二道锁：zlib 压缩。即使你强行读出里面的数据，也只是一堆压成一团的字节，需要先解压才能还原。
• 第三道锁：脚本加密。像阴阳师里的 Python 脚本，还会被额外的算法再加密一次，属于"保险箱里的暗格"。

通用工具为什么全军覆没？因为它们只认识标准锁，而 NPK 是"私房锁"。unnpk 则不同：它认得 NeoX 的签名，能读索引、能解压、能识别文件类型，三道锁逐层打开，全程无需你操心。

二、认识 unnpk：一个只有两个命令的小工具

你可能会反问：一个连图形界面都没有的命令行小工具，凭什么值得专门为它写一篇文章？

答案很简单：它把最难的"读索引、解压、识别类型"三件事全做完了，留给你的操作只有一条命令。更贴心的是，编译一次你会得到两个小工具——unnpk负责取货，mapnpk负责看货单，一个动手一个动眼。

编译前的准备其实就一样：装上文件类型识别库 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

编译成功后，目录里会多出unnpk和mapnpk两个可执行文件。💡 小提示：编译依赖的是系统自带的 gcc 和 zlib，绝大多数环境都齐备，基本不会卡在这一步。

三、三步完成资源提取：亲手拆开第一个 NPK 包

如果一切顺利，三分钟之内你就能看到第一批战利品。整个提取过程只有三步：

mkdir extracted # 第 1 步：准备一个输出目录 ./unnpk game_res.npk extracted # 第 2 步：传入 npk 路径和输出目录 ls extracted # 第 3 步：查看战利品

打开输出目录，你会看到两个很有意思的现象：

1. 文件按类型自动归档。图片进image/、文本进text/、视频进video/……unnpk 就像一个"搬运工加鉴定师"，搬完货还顺手给你分了类。
2. 每个文件都被补上了扩展名。原始包里的资源往往光秃秃没有后缀，unnpk 靠分析文件内容特征来补全——认出 PNG 给.png，认出 MP4 给.mp4，认出 JSON 给.json。

至于那些 8 位十六进制的文件名（比如0A0D60DC），其实是文件在索引表里的编号，后面解阴阳师脚本时还会跟它打交道。

四、取货之前先看货单：mapnpk 读出包内清单

这里有个反常识的观点：在 unnpk 的体系里，真正值钱的往往不只是文件本身，还有那张"货单"——也就是包内的索引表。

想先看清包里有什么再动手，就轮到mapnpk出场了：

./mapnpk -i game_res.npk # 直接在终端打印清单 ./mapnpk -i game_res.npk -o list.md # 存成 Markdown 文件方便翻阅 ./mapnpk -i game_res.npk -f csv -t int # 输出 CSV 格式、用十进制数字显示

它会告诉你三件事：整个包多大、索引表从文件哪个位置开始、每个文件占用哪一段。每条文件记录都包含 7 个字段——编号、在包内的偏移、压缩后大小、解压后大小、两个校验值和"是否压缩"的标志位。

把 NPK 想象成一本仓库账本：mapnpk让你先翻账本看条目，unnpk才是按账本去库房搬货。先看后取，能帮你提前判断这个包值不值得解、里面有没有你要的东西。

五、NPK 的"肚皮"里有什么：一次看懂内部结构

在真正打开数据区之前，unnpk 其实只做了两件不起眼的小事，但正是这两件事决定了整个流程的成败。

第一件：找到索引表的位置。它直接跳到文件偏移 0x14（第 20 个字节）处，读出一个 4 字节的数字。这个数字就是索引表的起始位置——好比快递单上写着"内件清单在第 X 页"。

第二件：逐条读取文件记录。从索引表起点开始，每 28 个字节（7 个 4 字节整数）描述一个文件，一直读到文件末尾。每一条记录都像一张小快递单：货号、放在哪个货架、毛重多少、解开后多重、有没有被压缩。

接下来是解压判断：如果"压缩大小"和"解压大小"对不上，或者压缩标志位为 1，说明数据是 zlib 压缩过的，先解压再继续。最后用 libmagic 分析内容、补全扩展名。有意思的是，unnpk 对文本类资源还有一套"看开头识字"的技巧——以<NeoX开头就给.NeoX.xml，以{开头且以}结尾就给.json，内容里出现vec4、tex2D这类关键词就识别成.glsl着色器。这套"看内容猜类型"的设计，让它在面对无扩展名的资源时依然游刃有余。

六、阴阳师脚本的解密全流程：从乱码到可读源码

提取出来的文件里躺着一堆没有扩展名的脚本，打开全是乱码——这时候就放弃了吗？别急，离成功只差三步。

以阴阳师的script.npk为例，第一步照常解包：

./unnpk script.npk script_raw

第二步，挑一个解出来的脚本文件（比如0A0D60DC），用工具目录下的解密脚本处理：

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

这一步一口气做了三件事：用 rotor 算法解密、用 zlib 解压、把整段字符串倒过来。类比一下就是：先给暗格配上钥匙，再抖开揉皱的纸团，最后把倒着写的字正过来读。

第三步，纠正字节码并反编译：

python2 tools/pyc_decryptor.py 0A0D60DC.out 0A0D60DC.pyc uncompyle2 -o 0A0D60DC.py 0A0D60DC.pyc

阴阳师把 Python 字节码的操作码（opcode）整体打乱过，直接反编译会失败。pyc_decryptor.py的作用就是查表把被打乱的 opcode 翻译回标准写法，再补上正常的文件头，之后uncompyle2就能把它还原成可读的 Python 源码。至此，一段游戏内的脚本逻辑就完整呈现在你面前了。

七、换一个游戏就失灵？先找这把新"钥匙"

这里藏着一个容易踩的坑：同一个工具，昨天还能解包阴阳师，今天换一个网易游戏，脚本解密这步就失败了。为什么？

因为脚本的加密密钥藏在游戏自己的redirect.py里。以阴阳师为例，密钥由asdf_dn、asdf_dt、asdf_df三个字符串拼装而成，而其他游戏的这三段字符串很可能完全不同——换了锁，就得换钥匙。

更妙的是，这把"钥匙"并不难找：redirect.py本身就藏在script.npk里，比如阴阳师某个版本中对应FB54F059这个文件（文件名就是它在包里的偏移量）。你只要在解出来的文件里找到这个特征文件，就能逆向提取出当前版本的密钥，再去调整解密脚本。这也是社区解包新游戏时的通用思路：先解包，再找 redirect，后定密钥。

八、避坑手册：这些报错其实是在救你

再给你一个反常识的结论：遇到报错先别慌，unnpk 的好几条"警告"，翻译过来其实是"我在尽力救你"。

• 提示找不到 libmagic：依赖没装全，回到第二节补装对应系统的开发包即可。
• 提示 Uncompress failed，随后跟着 "The raw data will be output"：这说明某条数据不是标准 zlib，但工具没有放弃，而是把原始数据原样输出，尽量减少损失。这是设计好的兜底行为，不是崩溃。
• 提示 mkdir failed：多半是输出目录已存在，属于无害提示，后续写入通常不受影响。
• 遇到超大资源包内存吃紧：工具按索引逐条读取、逐个释放，尽量让内存占用平稳，但单文件特别大时，还是给机器留足余量比较稳妥。
• 关于操作系统：工具按 Unix 习惯开发，官方建议在 macOS、Linux、FreeBSD 下使用，Windows 上折腾成本较高，不太推荐。

九、最后一步：从"看完"到"上手"

到这里，从编译、解包、看货单到解密脚本的完整路径你已经全部走过了。剩下的，就是亲自动手验证一遍。

给你三个可以立刻执行的小建议：

1. 找一个 npk 文件，先mapnpk看货单，再unnpk取货，对照结果感受一下"先看后取"的效率。
2. 想研究脚本解密，可以深入tools/目录下的三个脚本——script_redirect.py、pyc_decryptor.py、pymarshal.py，它们就是整套解密链路的源码级教材。
3. 如果你在解包时发现了新的 NPK 变体，或者想让工具适配更多游戏，欢迎给项目提交代码或反馈建议，社区的力量正是这个工具持续进化的动力。

最后提醒一句：提取出来的资源请仅用于学习和研究，尊重游戏厂商的授权协议与开发者的劳动成果。工具在手，好奇心才是你最好的通行证——现在，去找你的第一个 NPK 文件吧。

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