网易NeoX引擎NPK文件解包全攻略用unnpk从零提取游戏资源与脚本源码【免费下载链接】unnpk解包网易游戏NeoX引擎NPK文件如阴阳师、魔法禁书目录。项目地址: https://gitcode.com/gh_mirrors/un/unnpk如果你玩过《阴阳师》或《魔法禁书目录》一定好奇过客户端里那些精美的立绘、音效和战斗脚本藏在哪里。答案是它们都被打包进了一种名为 NPK 的资源容器中。unnpk 正是一款专门针对网易 NeoX 引擎 NPK 文件解包的开源命令行工具它能把加密压缩的二进制资源包拆解为按类型归类的普通文件是游戏资源提取、NeoX 引擎逆向与脚本源码还原研究中绕不开的入门利器。本文将从为什么要拆包讲起带你完成编译、解包、格式剖析、脚本还原直至批量自动化全程使用真实可执行的命令。为什么要自己拆开 NPK先搞懂资源包的封条逻辑游戏客户端为了减少磁盘碎片、加快加载速度并防止资源被轻易拿走通常会把成百上千个小文件合并成一个大的资源包。NPK 就是网易 NeoX 引擎采用的这种合并格式它同时承担了三件事收纳纹理、模型、骨骼、音视频、配置 XML、Python 脚本全部塞进单一文件压缩数据区普遍使用 zlib 流压缩减小安装包体积索引文件尾部维护一张目录表记录每个内部资源的偏移、大小与压缩标记。官方客户端只提供播放资源的能力不提供导出资源的入口。于是想分析渲染管线、提取素材、研究技能脚本逻辑或是做 MOD 与汉化第一步都得先完成 NPK 文件解包。unnpk 项目恰好提供了完整的工具链C 语言编写的unnpk负责真正解包mapnpk负责只读侦察目录结构tools/下的 Python 脚本则负责处理最难啃的脚本资源。整个项目体量极小主程序只有一个文件非常适合作为学习二进制格式解析的范例。5 分钟完成环境搭建依赖安装与编译unnpk 依赖libmagic用于识别文件类型和zlib用于解压数据不同系统安装方式略有差异操作系统安装命令说明macOSbrew install libmagicHomebrew 提供现成包CentOS / RHELsudo yum install file-libs file-devel需同时安装运行时与开发头文件Debian / Ubuntusudo apt-get install libmagic-devlibmagic-dev 已包含头文件依赖就绪后克隆仓库并编译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流程非常直白把文件指针定位到偏移0x14即头部第 21 个字节读取一个uint32作为目录区起始偏移map_offset从map_offset开始每 28 字节7 个uint32解析一条目录记录直到文件末尾按记录中的偏移与大小把数据段读入内存必要时用 zlib 解压用 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 还是 XMLunnpk 采用了两层识别策略第一层libmagic 嗅探 MIME 类型。代码用magic_buffer对内存中的解压结果做内容识别得到类似image/png、text/xml的类型字符串直接用作输出子目录名。第二层特征匹配细化扩展名。通用 MIME 只能粗分类unnpk 还针对 NeoX 引擎的特色资源做了精细识别识别特征判定结果典型场景内容以KTX第 2 字节起开头.ktx显卡压缩纹理内容以RGIS或PKM开头对应扩展名移动端贴图格式文本以NeoX、FxGroup开头.NeoX.xml等引擎场景配置文本含vec4、tex2D、float等关键字.glsl着色器源码文本同时含v、vt、f行.obj三维模型首尾字符为{与}.json配置数据对应的判定代码形如节选自 unnpk.cif (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 |os5v7!-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 21 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 进一步定位感兴趣的资源优化策略具体做法预期效果并行解包xargs -P 4同时处理多个包多包场景耗时约降为 1/4磁盘加速输出目录放到 SSD 或 tmpfs大量小文件写入提速明显增量处理按输出目录是否已存在跳过重复执行不浪费时间清单驱动用 CSV 清单预筛资源避免解出无用文件常见问题与排查清单实际使用中新手最容易遇到下面几类问题这里给出定位思路现象可能原因处理办法提示E: npk file open failed路径错误或权限不足检查文件是否存在、是否有读权限解出的文件大小为 0目录记录异常或压缩标记不符用mapnpk对比压缩前后大小确认是否回退输出出现W: Uncompress failed该资源不是 zlib 流或目录表损坏属正常降级原始字节已输出可自行用 hexdump 检查扩展名为空或Nonelibmagic 无法识别该类型更新 libmagic或参考源码自行补充特征规则脚本反编译失败密钥或 opcode 表不匹配当前版本回到包内找redirect.pyc重新分析密钥与映射如果怀疑某个资源内容不对最直接的办法是用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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 网易NeoX引擎NPK文件解包全攻略：用unnpk从零提取游戏资源与脚本源码
网易NeoX引擎NPK文件解包全攻略用unnpk从零提取游戏资源与脚本源码【免费下载链接】unnpk解包网易游戏NeoX引擎NPK文件如阴阳师、魔法禁书目录。项目地址: https://gitcode.com/gh_mirrors/un/unnpk如果你玩过《阴阳师》或《魔法禁书目录》一定好奇过客户端里那些精美的立绘、音效和战斗脚本藏在哪里。答案是它们都被打包进了一种名为 NPK 的资源容器中。unnpk 正是一款专门针对网易 NeoX 引擎 NPK 文件解包的开源命令行工具它能把加密压缩的二进制资源包拆解为按类型归类的普通文件是游戏资源提取、NeoX 引擎逆向与脚本源码还原研究中绕不开的入门利器。本文将从为什么要拆包讲起带你完成编译、解包、格式剖析、脚本还原直至批量自动化全程使用真实可执行的命令。为什么要自己拆开 NPK先搞懂资源包的封条逻辑游戏客户端为了减少磁盘碎片、加快加载速度并防止资源被轻易拿走通常会把成百上千个小文件合并成一个大的资源包。NPK 就是网易 NeoX 引擎采用的这种合并格式它同时承担了三件事收纳纹理、模型、骨骼、音视频、配置 XML、Python 脚本全部塞进单一文件压缩数据区普遍使用 zlib 流压缩减小安装包体积索引文件尾部维护一张目录表记录每个内部资源的偏移、大小与压缩标记。官方客户端只提供播放资源的能力不提供导出资源的入口。于是想分析渲染管线、提取素材、研究技能脚本逻辑或是做 MOD 与汉化第一步都得先完成 NPK 文件解包。unnpk 项目恰好提供了完整的工具链C 语言编写的unnpk负责真正解包mapnpk负责只读侦察目录结构tools/下的 Python 脚本则负责处理最难啃的脚本资源。整个项目体量极小主程序只有一个文件非常适合作为学习二进制格式解析的范例。5 分钟完成环境搭建依赖安装与编译unnpk 依赖libmagic用于识别文件类型和zlib用于解压数据不同系统安装方式略有差异操作系统安装命令说明macOSbrew install libmagicHomebrew 提供现成包CentOS / RHELsudo yum install file-libs file-devel需同时安装运行时与开发头文件Debian / Ubuntusudo apt-get install libmagic-devlibmagic-dev 已包含头文件依赖就绪后克隆仓库并编译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流程非常直白把文件指针定位到偏移0x14即头部第 21 个字节读取一个uint32作为目录区起始偏移map_offset从map_offset开始每 28 字节7 个uint32解析一条目录记录直到文件末尾按记录中的偏移与大小把数据段读入内存必要时用 zlib 解压用 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 还是 XMLunnpk 采用了两层识别策略第一层libmagic 嗅探 MIME 类型。代码用magic_buffer对内存中的解压结果做内容识别得到类似image/png、text/xml的类型字符串直接用作输出子目录名。第二层特征匹配细化扩展名。通用 MIME 只能粗分类unnpk 还针对 NeoX 引擎的特色资源做了精细识别识别特征判定结果典型场景内容以KTX第 2 字节起开头.ktx显卡压缩纹理内容以RGIS或PKM开头对应扩展名移动端贴图格式文本以NeoX、FxGroup开头.NeoX.xml等引擎场景配置文本含vec4、tex2D、float等关键字.glsl着色器源码文本同时含v、vt、f行.obj三维模型首尾字符为{与}.json配置数据对应的判定代码形如节选自 unnpk.cif (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 |os5v7!-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 21 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 进一步定位感兴趣的资源优化策略具体做法预期效果并行解包xargs -P 4同时处理多个包多包场景耗时约降为 1/4磁盘加速输出目录放到 SSD 或 tmpfs大量小文件写入提速明显增量处理按输出目录是否已存在跳过重复执行不浪费时间清单驱动用 CSV 清单预筛资源避免解出无用文件常见问题与排查清单实际使用中新手最容易遇到下面几类问题这里给出定位思路现象可能原因处理办法提示E: npk file open failed路径错误或权限不足检查文件是否存在、是否有读权限解出的文件大小为 0目录记录异常或压缩标记不符用mapnpk对比压缩前后大小确认是否回退输出出现W: Uncompress failed该资源不是 zlib 流或目录表损坏属正常降级原始字节已输出可自行用 hexdump 检查扩展名为空或Nonelibmagic 无法识别该类型更新 libmagic或参考源码自行补充特征规则脚本反编译失败密钥或 opcode 表不匹配当前版本回到包内找redirect.pyc重新分析密钥与映射如果怀疑某个资源内容不对最直接的办法是用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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考