xnbcli：星露谷物语XNB文件处理利器

xnbcli是一款专为《星露谷物语》游戏设计的命令行工具，能够高效处理XNB文件的打包和解包操作。这款工具为游戏模组开发者和资源定制爱好者提供了便捷的解决方案。

工具核心特性

多平台兼容性

• 支持Windows、macOS和Linux三大操作系统
• 提供批处理脚本和Shell脚本，满足不同用户习惯
• 基于Node.js开发，确保运行环境的统一性

专业算法支持

• 针对LZX压缩格式进行专门优化
• 内置XACT音频处理基础框架
• 支持多种游戏资源格式解析

快速上手指南

环境准备

确保系统已安装Node.js运行环境，建议使用14及以上版本。

获取项目代码

git clone https://gitcode.com/gh_mirrors/xn/xnbcli
cd xnbcli
npm install

文件解包操作

1. 将需要解包的XNB文件放入packed目录
2. 根据操作系统执行相应脚本：
   • Windows：运行unpack.bat
   • macOS：执行./unpack.command
   • Linux：运行./unpack.sh

文件打包流程

1. 在unpacked目录中编辑解包后的资源文件
2. 使用对应的打包脚本进行处理
3. 生成的XNB文件将保存在packed目录

技术架构解析

模块化设计

项目采用高度模块化的架构设计：

核心处理模块

• app/Xnb：XNB格式文件解析核心
• app/Presser：LZX压缩算法实现
• app/Xact：音频资源处理支持

数据读取器系统 包含20多种专业数据读取器，支持Texture2D、SoundEffect等常用资源格式，确保游戏资源能够被完整解析。

命令行接口

提供完整的命令行操作方式：

# 基础命令格式
xnbcli (pack|unpack) [输入路径] [输出路径]

# 实用示例
xnbcli unpack ./custom/ ./extracted/
xnbcli pack ./modified/ ./final/

便捷脚本支持

项目预设了实用的npm脚本：

# 快速解包所有文件
npm run unpack

# 一键打包全部资源
npm run pack

使用注意事项

文件格式兼容性

当前工具主要支持《星露谷物语》使用的LZX压缩格式XNB文件。在处理其他游戏或压缩格式时可能需要额外适配。

资源命名规范

建议使用英文命名资源文件，避免特殊字符和中文路径，确保打包过程的顺利进行。

备份策略

在进行任何文件修改前，强烈建议备份原始XNB文件，以防意外情况导致游戏无法正常运行。

技术规范说明

xnbcli遵循LGPL-3.0开源许可证，允许商业使用和二次开发。详细的技术规范可在项目根目录的LICENSE.md文件中查看。

应用场景

游戏模组开发

• 自定义游戏纹理和图像资源
• 修改游戏音效和背景音乐
• 创建个性化游戏界面

资源定制优化

• 调整游戏内物品外观
• 优化游戏性能表现
• 实现个性化游戏体验

通过xnbcli工具，用户可以轻松解锁《星露谷物语》游戏资源的无限定制可能性，为游戏体验增添更多个性化元素。