**XNBCLI安装与配置完全指南**

XNBCLI安装与配置完全指南

xnbcli A CLI tool for XNB packing/unpacking purpose built for Stardew Valley. 项目地址: https://gitcode.com/gh_mirrors/xn/xnbcli

---

项目基础介绍及编程语言

XNBCLI 是一个专为《星露谷物语》(Stardew Valley)打造的命令行工具，用于XNB文件的打包与解包操作。XNB文件是用于游戏资源存储的一种特殊格式。此项目采用 JavaScript 为主要开发语言，并兼容Node.js环境，确保了跨平台的特性。它支持对所有LZX压缩的XNB文件进行解压，且已为XACT功能奠定了初步基础，旨在简化普通用户与XNB文件交互的复杂度。

关键技术和框架

• Node.js: 应用的核心运行环境，负责执行JavaScript代码。
• 命令行界面(CLI): 提供直观的命令输入方式，让用户通过终端或命令提示符操作。
• 可能涉及的Python脚本: 对于Windows用户，安装过程中可能会用到Python，尤其是通过windows-build-tools安装依赖时。

安装与配置步骤

准备工作

1. 安装Node.js: 确保你的计算机上安装了最新版本的Node.js。这将提供JavaScript的运行环境和NPM（Node Package Manager）。

2. Python环境（仅限Windows用户）: 在Windows系统上，需要安装Python并推荐通过运行npm i --g --production windows-build-tools来安装必要的构建工具。

3. Git客户端: 如没有安装，访问Git官网下载并安装，以便克隆项目源码。

详细安装步骤

克隆项目

打开终端（Mac/Linux下通常是Terminal，Windows下则为CMD或PowerShell），然后输入以下命令来克隆XNBCLI项目：

git clone https://github.com/LeonBlade/xnbcli.git
cd xnbcli

安装依赖

在项目根目录中，运行以下命令以安装所有必需的Node.js依赖项：

npm install

这是通过NPM完成的，过程可能会因为网络原因稍有延迟。

运行XNBCLI

项目提供了方便的脚本来执行打包和解包操作。不过，在进行任何操作之前，理解基本用法很重要：

• 解包XNB文件: 将XNB文件放入packed目录，然后运行以下命令之一：

  # Windows用户可以使用批处理文件
  npm run unpack
  
  # 或者在Linux/Mac环境下
  npm run unpack:posix
  

• 打包文件回XNB格式: 把要打包的文件放到unpacked目录，然后执行相应的打包命令：

  # 同样，选择适合您操作系统的命令
  npm run pack
  
  # Linux/Mac
  npm run pack:posix
  

注意事项

• 首次使用可能需要配置相关权限或解决可能出现的路径问题。
• 在进行文件操作前，请备份原始数据以防意外损失。
• 涉及到具体文件路径或者额外的定制需求，请参照项目文档和readme中的说明。

至此，您已经成功安装并配置了XNBCLI，能够轻松地对《星露谷物语》的XNB文件进行打包和解包操作，享受自定义游戏资源的乐趣。

xnbcli A CLI tool for XNB packing/unpacking purpose built for Stardew Valley. 项目地址: https://gitcode.com/gh_mirrors/xn/xnbcli