使用xnbcli工具轻松处理《星露谷物语》XNB文件

xnbcli是一款专门为《星露谷物语》玩家设计的命令行工具，能够快速实现XNB文件的打包与解包操作。无论是修改游戏资源还是制作个性化MOD，这款轻量级工具都能帮你轻松搞定文件格式转换。

工具特点与优势

专为游戏优化

作为针对《星露谷物语》开发的专用工具，xnbcli完美支持所有LZX压缩格式的XNB文件，包括纹理、音频和字体资源。无需担心兼容性问题，让MOD制作过程更加顺畅。

简单易用的操作流程

通过预设脚本实现一键操作，无需记忆复杂命令：

• 解包：将文件放入packed文件夹，运行对应脚本
• 打包：编辑后文件放入unpacked文件夹，运行对应脚本

工具提供全平台支持，包括Windows系统的unpack.bat和pack.bat，macOS系统的unpack.command和pack.command，以及Linux系统的unpack.sh和pack.sh。

完全免费开源

基于GNU LGPL v3.0开源协议，代码完全透明可审计。无任何隐藏收费项，开发者和普通玩家都能自由使用和二次开发。

快速使用指南

环境准备

首先需要安装Node.js环境，这是运行工具的基础。然后通过git clone命令获取工具源代码。

解包XNB文件

1. 将游戏原文件（如Content/Characters目录下的XNB文件）复制到项目的packed文件夹
2. 根据操作系统运行对应的解包脚本
3. 解压后的文件会自动生成到unpacked目录

重新打包文件

1. 将编辑好的文件（保持原目录结构）放入unpacked文件夹
2. 运行对应的打包脚本
3. 生成的XNB文件会保存在packed目录，可直接替换游戏原文件使用

进阶使用方法

终端命令操作

在项目根目录打开终端，可以使用以下命令实现自定义路径操作： node xnbcli.js unpack [输入路径] [输出路径] node xnbcli.js pack [输入路径] [输出路径]

例如：node xnbcli.js unpack ./myfiles ./output

技术架构解析

项目采用模块化设计，核心功能实现位于app目录下的各个模块：

• XNB文件处理：app/Xnb/目录包含完整的读取器系统
• 压缩算法：app/Presser/模块处理LZX压缩
• 音频资源：app/Xact/组件处理游戏音效

支持的资源类型

工具内置了多种读取器，支持处理以下类型的游戏资源：

• 纹理图片（Texture2DReader）
• 音效文件（SoundEffectReader）
• 字体资源（SpriteFontReader、BmFontReader）
• 数组和列表（ArrayReader、ListReader）
• 基本数据类型（BooleanReader、Int32Reader等）
• 向量和矩阵数据（Vector2Reader、Vector3Reader等）

使用建议与注意事项

• 修改游戏文件前务必做好备份，避免影响原始游戏体验
• 确保修改后的文件格式与原文件保持一致
• 检查unpacked文件夹内是否保持原始目录结构
• 所有MOD制作请遵守游戏开发者的使用条款

开发者资源

对于开发者，项目提供了完整的开发环境支持：

• 运行npm install安装node包依赖
• 使用npm run unpack和npm run pack脚本
• 可通过修改源代码实现自定义功能扩展

xnbcli虽然是命令行工具，但通过预设脚本极大降低了使用门槛。无论是想简单修改游戏字体，还是制作复杂的角色外观MOD，这款工具都能成为你的得力助手。