樱花更新器

(中文版请向下滚动 | Scroll down for Chinese version)

简介

SakuraUpdater 是一个 NeoForge Minecraft 模组，用于在服务器和客户端之间自动同步模组文件，让玩家能够像其他游戏一样自动获取服务器更新。

功能特性

• 🔄 自动检查服务器更新
• 🕒 在更新界面显示更新日志
• 📁 支持多种同步模式（mirror、push、ignore）
• 🎮 图形化更新界面
• ⚙️ 可配置的客户端和服务器设置
• 🚀 服务端可独立运行

安装步骤

服务器端安装

1. 将 sakuraupdater-[version].jar 放入服务器的 mods 文件夹。
2. 启动服务器。首次运行会生成配置文件。
3. 编辑服务器配置文件 config/sakuraupdater-server.toml。

客户端安装

1. 将 sakuraupdater-[version].jar 放入客户端的 mods 文件夹。
2. 启动游戏。首次运行会生成配置文件。
3. 编辑客户端配置文件 config/sakuraupdater-client.toml。

服务端独立运行

1. 将 sakuraupdater-[version].jar 放入单独文件夹。
2. 直接使用 java -jar sakuraupdater-[version].jar 运行服务端。
3. 编辑客户端配置文件 sakuraupdater-client.toml。

配置说明

服务器配置 (sakuraupdater-server.toml)

# 文件服务器端口
port = 25564

# 同步目录配置，格式: ["目标目录:模式:源目录:额外的源目录:..."]
# 模式说明:
# - mirror: 镜像模式，完全同步源目录到目标目录
# - push: 推送模式，将服务器文件推送到客户端
# - pull: 拉取模式，从客户端拉取文件到服务器
# - ignore: 忽略模式，使用正则匹配忽略文件。匹配时前面带路径，推荐用 ".*文件名$" 格式。
SYNC_DIR = [
    "mods:mirror",                           # 同步 mods 文件夹
    "config:push:clientconfig:config",       # 将 config 和 clientconfig 推送到客户端
    "resourcepacks:mirror",                  # 同步资源包文件夹
    "mods:ignore:.*abc\.jar$"                # 忽略以 abc.jar 结尾的文件
]

客户端配置 (sakuraupdater-client.toml)

# 服务器主机地址
host = "localhost"

# 服务器端口（需与sakuraupdater-server.toml配置一致，如使用frp等代理后的端口）
port = 25564

# 当前客户端版本（自动管理，请勿手动修改）
now_version = ""

使用方法

1. 服务器管理员操作

在使用独立服务端时，需去除 /sakuraupdater 命令前缀，直接使用 commit、data 命令

创建更新版本

/sakuraupdater commit <版本号> <描述信息/描述文件路径>

例如: /sakuraupdater commit v1.0.1 修复了物品复制bug\n添加了新的附魔

或使用文本文件(极少的md格式支持): /sakuraupdater commit v1.0.1 description.md

管理数据版本

# 查看所有版本
/sakuraupdater data list

# 查看特定版本详情
/sakuraupdater data show v1.0.1

# 编辑版本描述
/sakuraupdater data edit v1.0.1 "更新了版本描述"

# 删除版本
/sakuraupdater data delete v1.0.1

# 清空所有版本数据
/sakuraupdater data clear

2. 客户端玩家操作

自动检查更新

当玩家进入游戏时，如果检测到服务器有新版本，客户端会自动检查并弹出更新界面。

---

SakuraUpdater (中文)

简介

SakuraUpdater 是一个 Minecraft NeoForge 模组，用于自动更新服务器的 mod 文件，让玩家能够像其他游戏一样自动获取服务器更新。

功能特性

• 🔄 自动检查服务器更新
• 🕒 在更新界面显示更新日志
• 📁 支持多种文件同步模式（mirror、push、ignore）
• 🎮 图形化更新界面
• ⚙️ 可配置的客户端和服务器设置
• 🚀 服务端可独立运行

安装步骤

服务器端安装

1. 将 sakuraupdater-[version].jar 放入服务器的 mods 文件夹。
2. 启动服务器，首次运行会生成配置文件。
3. 编辑 config/sakuraupdater-server.toml 配置文件。

客户端安装

1. 将 sakuraupdater-[version].jar 放入客户端的 mods 文件夹。
2. 启动游戏，首次运行会生成配置文件。
3. 编辑 config/sakuraupdater-client.toml 配置文件。

服务端独立运行

1. 将 sakuraupdater-[version].jar 放入单独文件夹。
2. 直接 java -jar sakuraupdater-[version].jar 即可运行服务端。
3. 编辑 sakuraupdater-client.toml 配置文件。

配置说明

服务器配置 (sakuraupdater-server.toml)

# 文件服务器端口
port = 25564

# 同步目录配置，格式: ["目标目录:模式:源目录:额外的源目录:..."]
# 模式说明:
# - mirror: 镜像模式，完全同步源目录到目标目录
# - push: 推送模式，将服务器文件推送到客户端
# - pull: 拉取模式，从客户端拉取文件到服务器
# - ignore: 忽略模式，使用正则匹配忽略文件。匹配时前面带路径，推荐用 ".*文件名$" 格式。
SYNC_DIR = [
    "mods:mirror",                           # 同步 mods 文件夹
    "config:push:clientconfig:config",       # 将 config 和 clientconfig 推送到客户端
    "resourcepacks:mirror",                  # 同步资源包文件夹
    "mods:ignore:.*abc\.jar$"                # 忽略以 abc.jar 结尾的文件
]

客户端配置 (sakuraupdater-client.toml)

# 服务器主机地址
host = "localhost"

# 服务器端口（需与sakuraupdater-server.toml配置一致，如使用frp等代理后的端口）
port = 25564

# 当前客户端版本（自动管理，请勿手动修改）
now_version = ""

使用方法

1. 服务器管理员操作

在使用独立服务端时，需去除 /sakuraupdater 命令前缀，直接使用 commit、data 命令

创建更新版本

/sakuraupdater commit <版本号> <描述信息/描述文件路径>

例如: /sakuraupdater commit v1.0.1 修复了物品复制bug\n添加了新的附魔

或使用文本文件(极少的md格式支持): /sakuraupdater commit v1.0.1 description.md

管理数据版本

# 查看所有版本
/sakuraupdater data list

# 查看特定版本详情
/sakuraupdater data show v1.0.1

# 编辑版本描述
/sakuraupdater data edit v1.0.1 "更新了版本描述"

# 删除版本
/sakuraupdater data delete v1.0.1

# 清空所有版本数据
/sakuraupdater data clear

2. 客户端玩家操作

自动检查更新

当玩家进入游戏时，如果检测到服务器有新版本，会自动弹出更新界面。