{"id":135353,"date":"2026-06-08T02:46:58","date_gmt":"2026-06-07T23:46:58","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/"},"modified":"2026-06-08T02:46:58","modified_gmt":"2026-06-07T23:46:58","slug":"sakuraupdater","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/","title":{"rendered":"SakuraUpdater"},"content":{"rendered":"

# SakuraUpdater \u2014 Usage Guide [\u4e0b\u9762\u6709\u4e2d\u6587]()<\/p>\n

## Introduction<\/p>\n

SakuraUpdater is a NeoForge Minecraft mod that enables automatic synchronization of mod files between a server and clients, allowing players to receive server updates automatically, similar to other games.<\/p>\n

## Features<\/p>\n

– [x] \ud83d\udd04 Automatic server update checks
\n– [x] \ud83d\udcc1 Multiple sync modes supported (mirror, push)
\n– [x] \ud83c\udfae Graphical update UI
\n– [x] \u2699\ufe0f Configurable client and server settings
\n– [x] \ud83d\ude80 The server can run independently<\/p>\n

## Installation<\/p>\n

### Server-side installation<\/p>\n

1. Place `sakuraupdater-[version].jar` into the server’s `mods` folder.
\n2. Start the server. Configuration files will be generated on first run.
\n3. Edit the server configuration file at `config\/sakuraupdater-server.toml`.<\/p>\n

### Client-side installation<\/p>\n

1. Place `sakuraupdater-[version].jar` into the client’s `mods` folder.
\n2. Start the game. Configuration files will be generated on first run.
\n3. Edit the client configuration file at `config\/sakuraupdater-client.toml`.<\/p>\n

### Server-side independent operation
\n1. place `sakuraupdater-[version]-standalone.jar` into a separate folder.
\n2. Run the server independently with `java -jar sakuraupdater-[version]-standalone.jar`.
\n3. Edit the client configuration file at `sakuraupdater-client.toml`.<\/p>\n

## Configuration<\/p>\n

### Server configuration (`sakuraupdater-server.toml`)<\/p>\n

“`toml
\n# File server port
\nport = 25564<\/p>\n

# Sync directory configuration, format: [“target_dir:mode:source_dir:extra_source_dir:…”]
\n# Mode explanations:
\n# – mirror: mirror mode, fully synchronize source directory to the target directory
\n# – push: push mode, push server files to clients
\n# – pull: pull mode, pull files from clients to the server
\nSYNC_DIR = [
\n “mods:mirror”, # synchronize the mods folder
\n “config:push:clientconfig:config”, # push config and clientconfig to the client
\n “resourcepacks:mirror” # synchronize resourcepacks folder
\n]
\n“`<\/p>\n

### Client configuration (`sakuraupdater-client.toml`)<\/p>\n

“`toml
\n# Server host address
\nhost = “localhost”<\/p>\n

# Server port (should match the server configuration)
\nport = 25564<\/p>\n

# Current client version (managed automatically; do not edit manually)
\nnow_version = “”
\n“`<\/p>\n

## Usage<\/p>\n

### 1. Server administrator operations
\n> ### When using the independent server, remove the \/sakuraupdater command prefix and use the commit and data commands directly
\n#### Create a release\/commit
\n`\/sakuraupdater commit `
\nExample:
\n`\/sakuraupdater commit v1.0.1 Fixed item duplication bugnAdded new enchantments`
\nor using a text file (minimal markdown supported):
\n`\/sakuraupdater commit v1.0.1 description.md`<\/p>\n

#### Manage data versions<\/p>\n

“`
\n# List all versions
\n\/sakuraupdater data list<\/p>\n

# Show details for a specific version
\n\/sakuraupdater data show v1.0.1<\/p>\n

# Edit version description
\n\/sakuraupdater data edit v1.0.1 “Updated version description”<\/p>\n

# Delete a version
\n\/sakuraupdater data delete v1.0.1<\/p>\n

# Clear all version data
\n\/sakuraupdater data clear
\n“`<\/p>\n

### 2. Client player operations<\/p>\n

#### Automatic update check<\/p>\n

When a player joins the game, the client will automatically check whether the server has a newer version and will open the update UI if an update is available.<\/p>\n

# SakuraUpdater \u4f7f\u7528\u6559\u7a0b <\/p>\n

## \u7b80\u4ecb<\/p>\n

SakuraUpdater \u662f\u4e00\u4e2a Minecraft NeoForge \u6a21\u7ec4\uff0c\u7528\u4e8e\u81ea\u52a8\u66f4\u65b0\u670d\u52a1\u5668\u7684 mod \u6587\u4ef6\uff0c\u8ba9\u73a9\u5bb6\u80fd\u591f\u50cf\u5176\u4ed6\u6e38\u620f\u4e00\u6837\u81ea\u52a8\u83b7\u53d6\u670d\u52a1\u5668\u66f4\u65b0\u3002<\/p>\n

## \u529f\u80fd\u7279\u6027<\/p>\n

– [x] \ud83d\udd04 \u81ea\u52a8\u68c0\u67e5\u670d\u52a1\u5668\u66f4\u65b0
\n– [x] \ud83d\udcc1 \u652f\u6301\u591a\u79cd\u6587\u4ef6\u540c\u6b65\u6a21\u5f0f\uff08mirror\u3001push\uff09
\n– [x] \ud83c\udfae \u56fe\u5f62\u5316\u66f4\u65b0\u754c\u9762
\n– [x] \u2699\ufe0f \u53ef\u914d\u7f6e\u7684\u5ba2\u6237\u7aef\u548c\u670d\u52a1\u5668\u8bbe\u7f6e
\n– [x] \ud83d\ude80 \u670d\u52a1\u7aef\u53ef\u72ec\u7acb\u8fd0\u884c<\/p>\n

## \u5b89\u88c5\u6b65\u9aa4<\/p>\n

### \u670d\u52a1\u5668\u7aef\u5b89\u88c5<\/p>\n

1. \u5c06 `sakuraupdater-[version].jar` \u653e\u5165\u670d\u52a1\u5668\u7684 `mods` \u6587\u4ef6\u5939
\n2. \u542f\u52a8\u670d\u52a1\u5668\uff0c\u9996\u6b21\u8fd0\u884c\u4f1a\u751f\u6210\u914d\u7f6e\u6587\u4ef6
\n3. \u7f16\u8f91 `config\/sakuraupdater-server.toml` \u914d\u7f6e\u6587\u4ef6<\/p>\n

### \u5ba2\u6237\u7aef\u5b89\u88c5<\/p>\n

1. \u5c06 `sakuraupdater-[version].jar` \u653e\u5165\u5ba2\u6237\u7aef\u7684 `mods` \u6587\u4ef6\u5939
\n2. \u542f\u52a8\u6e38\u620f\uff0c\u9996\u6b21\u8fd0\u884c\u4f1a\u751f\u6210\u914d\u7f6e\u6587\u4ef6
\n3. \u7f16\u8f91 `config\/sakuraupdater-client.toml` \u914d\u7f6e\u6587\u4ef6<\/p>\n

### \u670d\u52a1\u7aef\u72ec\u7acb\u8fd0\u884c
\n1. \u5c06 `sakuraupdater-[version]-standalone.jar` \u653e\u5165\u5355\u72ec\u6587\u4ef6\u5939
\n2. \u76f4\u63a5 `java -jar sakuraupdater-[version]-standalone.jar` \u5373\u53ef\u8fd0\u884c\u670d\u52a1\u7aef
\n3. \u7f16\u8f91 `sakuraupdater-client.toml` \u914d\u7f6e\u6587\u4ef6<\/p>\n

## \u914d\u7f6e\u8bf4\u660e<\/p>\n

### \u670d\u52a1\u5668\u914d\u7f6e (sakuraupdater-server.toml)<\/p>\n

“`toml
\n# \u6587\u4ef6\u670d\u52a1\u5668\u7aef\u53e3
\nport = 25564<\/p>\n

# \u540c\u6b65\u76ee\u5f55\u914d\u7f6e\uff0c\u683c\u5f0f\uff1a[“\u76ee\u6807\u76ee\u5f55:\u6a21\u5f0f:\u6e90\u76ee\u5f55:\u989d\u5916\u7684\u6e90\u76ee\u5f55:…”]
\n# \u6a21\u5f0f\u8bf4\u660e\uff1a
\n# – mirror: \u955c\u50cf\u6a21\u5f0f\uff0c\u5b8c\u5168\u540c\u6b65\u6e90\u76ee\u5f55\u5230\u76ee\u6807\u76ee\u5f55
\n# – push: \u63a8\u9001\u6a21\u5f0f\uff0c\u5c06\u670d\u52a1\u5668\u6587\u4ef6\u63a8\u9001\u5230\u5ba2\u6237\u7aef
\n# – pull: \u62c9\u53d6\u6a21\u5f0f\uff0c\u4ece\u5ba2\u6237\u7aef\u62c9\u53d6\u6587\u4ef6\u5230\u670d\u52a1\u5668
\nSYNC_DIR = [
\n “mods:mirror”, # \u540c\u6b65 mods \u6587\u4ef6\u5939
\n “config:push:clientconfig:config”, # \u5c06 config\u548cclientconfig \u63a8\u9001\u5230\u5ba2\u6237\u7aef\u7684 clientc
\n “resourcepacks:mirror” # \u540c\u6b65\u8d44\u6e90\u5305\u6587\u4ef6\u5939
\n]
\n“`
\n### \u5ba2\u6237\u7aef\u914d\u7f6e (sakuraupdater-client.toml)
\n“`toml
\n# \u670d\u52a1\u5668\u4e3b\u673a\u5730\u5740
\nhost = “localhost”<\/p>\n

# \u670d\u52a1\u5668\u7aef\u53e3\uff08\u9700\u4e0e\u670d\u52a1\u5668\u914d\u7f6e\u4e00\u81f4\uff09
\nport = 25564<\/p>\n

# \u5f53\u524d\u5ba2\u6237\u7aef\u7248\u672c\uff08\u81ea\u52a8\u7ba1\u7406\uff0c\u8bf7\u52ff\u624b\u52a8\u4fee\u6539\uff09
\nnow_version = “”
\n“`
\n## \u4f7f\u7528\u65b9\u6cd5<\/p>\n

### 1. \u670d\u52a1\u5668\u7ba1\u7406\u5458\u64cd\u4f5c
\n> ### \u5728\u4f7f\u7528\u72ec\u7acb\u670d\u52a1\u7aef\u65f6\uff0c\u9700\u53bb\u9664\/sakuraupdater\u547d\u4ee4\u524d\u7f00\uff0c\u76f4\u63a5\u4f7f\u7528commit\u3001data\u547d\u4ee4
\n#### \u521b\u5efa\u66f4\u65b0\u7248\u672c
\n`\/sakuraupdater commit <\u7248\u672c\u53f7> <\u63cf\u8ff0\u4fe1\u606f\/\u63cf\u8ff0\u6587\u4ef6\u8def\u5f84>`
\n\u4f8b\u5982:
\n`\/sakuraupdater commit v1.0.1 \u4fee\u590d\u4e86\u7269\u54c1\u590d\u5236bugn\u6dfb\u52a0\u4e86\u65b0\u7684\u9644\u9b54`
\n\u6216\u6587\u672c\u6587\u4ef6(\u6781\u5c11\u7684md\u683c\u5f0f\u652f\u6301)
\n`\/sakuraupdater commit v1.0.1 description.md`
\n#### \u7ba1\u7406\u6570\u636e\u7248\u672c
\n“`
\n# \u67e5\u770b\u6240\u6709\u7248\u672c
\n\/sakuraupdater data list<\/p>\n

# \u67e5\u770b\u7279\u5b9a\u7248\u672c\u8be6\u60c5
\n\/sakuraupdater data show v1.0.1<\/p>\n

# \u7f16\u8f91\u7248\u672c\u63cf\u8ff0
\n\/sakuraupdater data edit v1.0.1 “\u66f4\u65b0\u4e86\u7248\u672c\u63cf\u8ff0”<\/p>\n

# \u5220\u9664\u7248\u672c
\n\/sakuraupdater data delete v1.0.1<\/p>\n

# \u6e05\u7a7a\u6240\u6709\u7248\u672c\u6570\u636e
\n\/sakuraupdater data clear
\n“`
\n### 2. \u5ba2\u6237\u7aef\u73a9\u5bb6\u64cd\u4f5c<\/p>\n

#### \u81ea\u52a8\u68c0\u67e5\u66f4\u65b0<\/p>\n

\u5f53\u73a9\u5bb6\u8fdb\u5165\u6e38\u620f\u65f6\uff0c\u5982\u679c\u68c0\u6d4b\u5230\u670d\u52a1\u5668\u6709\u65b0\u7248\u672c\uff0c\u4f1a\u81ea\u52a8\u5f39\u51fa\u66f4\u65b0\u754c\u9762\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"

SakuraUpdater \u2014 a lightweight auto-sync mod with one-click updates, mirror\/push sync, and a visual update UI.
\nSakuraUpdater \u2014 \u662f\u4e00\u4e2a\u8f7b\u91cf\u7ea7\u7684\u81ea\u52a8\u540c\u6b65mod\uff0c\u5177\u6709\u4e00\u952e\u66f4\u65b0\uff0c\u955c\u50cf\/\u63a8\u9001\u540c\u6b65\u548c\u89c6\u89c9\u66f4\u65b0UI<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"sakuraupdater","_minecraft_project_id":"1dzlx6Br","_minecraft_author":"XiaoJiang0208","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":1484,"_minecraft_follows":10,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"sakuraupdater.zip","_minecraft_size_bytes":168241307,"_minecraft_version_count":16,"_minecraft_updated_at":"2026-05-16T18:37:31.235233Z","_minecraft_date_created":"2025-11-05T09:35:23.369632Z","_minecraft_date_modified":"2026-05-12T12:20:54.468941Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sakuraupdater","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T23:46:59+00:00","_minecraft_import_hash":"a2f639ee13a6bfce658e322c2c861eb7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,158],"mod_loader":[106,160],"minecraft_version":[36,60,93,94,101,102,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-135353","mod","type-mod","status-publish","hentry","mod_category-forge","mod_category-neoforge","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nSakuraUpdater - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"SakuraUpdater - Minecraft\" \/>\n<meta property=\"og:description\" content=\"SakuraUpdater \u2014 a lightweight auto-sync mod with one-click updates, mirror\/push sync, and a visual update UI. SakuraUpdater \u2014 \u662f\u4e00\u4e2a\u8f7b\u91cf\u7ea7\u7684\u81ea\u52a8\u540c\u6b65mod\uff0c\u5177\u6709\u4e00\u952e\u66f4\u65b0\uff0c\u955c\u50cf\/\u63a8\u9001\u540c\u6b65\u548c\u89c6\u89c9\u66f4\u65b0UI\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sakuraupdater\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sakuraupdater\\\/\",\"name\":\"SakuraUpdater - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"datePublished\":\"2026-06-07T23:46:58+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sakuraupdater\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sakuraupdater\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/sakuraupdater\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"SakuraUpdater\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"SakuraUpdater - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/","og_locale":"en_US","og_type":"article","og_title":"SakuraUpdater - Minecraft","og_description":"SakuraUpdater \u2014 a lightweight auto-sync mod with one-click updates, mirror\/push sync, and a visual update UI. SakuraUpdater \u2014 \u662f\u4e00\u4e2a\u8f7b\u91cf\u7ea7\u7684\u81ea\u52a8\u540c\u6b65mod\uff0c\u5177\u6709\u4e00\u952e\u66f4\u65b0\uff0c\u955c\u50cf\/\u63a8\u9001\u540c\u6b65\u548c\u89c6\u89c9\u66f4\u65b0UI","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/","name":"SakuraUpdater - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"datePublished":"2026-06-07T23:46:58+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/sakuraupdater\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"SakuraUpdater"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/135353","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=135353"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=135353"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=135353"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=135353"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}