Installation

Installation

本文说明 XiaoNuoClean 的安装方式。

环境要求

• Minecraft Java Edition: 26.1.2 到 26.2.x
• Java: 25+
• Fabric 服务端:
  • Fabric Loader: 0.19.3+
  • Fabric API: 0.154.2+26.1.2
• NeoForge 服务端:
  • NeoForge: 26.1.2.76+

选择安装文件

XiaoNuoClean 从 1.1.0 开始按加载器分别发布：

xiaonuoclean-fabric-1.1.0.jar
xiaonuoclean-neoforge-1.1.0.jar

• Fabric 服务端安装 xiaonuoclean-fabric-1.1.0.jar。
• NeoForge 服务端安装 xiaonuoclean-neoforge-1.1.0.jar。
• 不要在同一个服务端同时安装 Fabric 版和 NeoForge 版。

发布页或 Git 标签可以使用 v1.1.0，但 jar 内部的模组版本必须是 1.1.0，不能带前缀 v。NeoForge 会按 Maven 版本规范解析 neoforge.mods.toml 的 version 字段，v1.1.0 会被判定为非法版本。

Fabric 服务端安装

1. 安装对应版本的 Fabric Loader。
2. 将 Fabric API 放入服务器 mods 目录。
3. 将 Fabric 版 XiaoNuoClean 放入服务器 mods 目录：

xiaonuoclean-fabric-1.1.0.jar

4. 启动服务器。
5. 首次启动后会自动生成配置文件：

config/xiaonuoclean.json

NeoForge 服务端安装

1. 安装对应版本的 NeoForge 服务端。
2. 将 NeoForge 版 XiaoNuoClean 放入服务器 mods 目录：

xiaonuoclean-neoforge-1.1.0.jar

3. 启动服务器。
4. 首次启动后会自动生成配置文件：

config/xiaonuoclean.json

NeoForge 版不需要 Fabric API。

客户端安装

XiaoNuoClean 主要面向服务端使用。单人游戏或局域网世界也可以将 jar 放入客户端 mods 目录使用。

更新版本

1. 关闭服务器。
2. 删除旧版本 jar。
3. 放入与你的加载器对应的新版本 jar。
4. 启动服务器。

已有配置文件会继续保留。若配置文件存在 JSON 语法错误，MOD 会使用默认配置运行，但不会覆盖原配置文件。