星露谷物语模组制作终极指南：xnbcli零基础完全教程

想要为《星露谷物语》制作个性化模组却不知从何开始？xnbcli 正是你需要的 XNB 打包解包工具！这款专为星露谷物语设计的 CLI 工具，让模组制作变得简单高效。

什么是 xnbcli 工具？

xnbcli 是一个命令行工具，专门用于处理《星露谷物语》中的 XNB 文件格式。XNB 文件是游戏中存储图像、音频、字体等资源的核心格式，通过这个 XNB 打包解包工具，你可以轻松修改游戏内容，打造独一无二的游戏体验。

快速上手：三分钟学会基本操作

解包 XNB 文件 🎮

将想要解包的 XNB 文件放入 packed 文件夹，然后运行对应的解包脚本：

• Windows: 双击 unpack.bat
• macOS: 运行 unpack.command
• Linux: 执行 unpack.sh

打包 XNB 文件 📦

修改完资源后，将文件放入 unpacked 文件夹，运行对应的打包脚本即可重新打包为 XNB 格式。

进阶用法：终端命令操作

如果你熟悉命令行，可以直接使用更灵活的命令：

# 解包单个文件
xnbcli unpack input.xnb output.json

# 打包单个文件  
xnbcli pack input.json output.xnb

开发者模式：深入定制

对于想要二次开发的用户，项目提供了完整的源码结构：

核心模块位于 app/ 目录，其中：

• Xnb/ - XNB 文件处理核心
• Presser/ - 压缩解压功能
• Xact/ - 音频处理模块

技术特性深度解析

支持的文件类型

xnbcli 支持多种资源类型的处理：

• 纹理图片（Texture2D）
• 音效文件（SoundEffect）
• 字体文件（SpriteFont）
• 特效文件（Effect）

智能错误处理

工具内置完善的错误处理机制，即使部分文件处理失败，也不会影响整个批处理流程。

常见问题解答 ❓

Q: 需要什么环境才能运行？ A: 需要安装 Node.js、npm 和 Python 环境。

Q: 支持哪些压缩格式？ A: 目前完全支持 LZX 压缩的 XNB 文件。

Q: 如何批量处理文件？ A: 只需将多个文件放入对应文件夹，工具会自动批量处理。

开始你的模组制作之旅

现在你已经掌握了 xnbcli 的基本使用方法，是时候开始你的星露谷物语模组创作了！无论是替换角色立绘、修改界面UI，还是添加新的音效，这个强大的 XNB 打包解包工具 都将成为你的得力助手。

记住，模组制作最重要的是创意和耐心。通过 xnbcli，你可以将自己的想法变成现实，为《星露谷物语》带来全新的游戏体验。开始你的模组制作之旅吧！✨