# ClientModSync<\/p>\n
Server provides mod files from `clientmod`, and clients synchronize based on configuration.<\/p>\n
\u670d\u52a1\u7aef\u63d0\u4f9b `clientmod` \u5185\u7684\u6a21\u7ec4\u6587\u4ef6\uff0c\u5ba2\u6237\u7aef\u6309\u914d\u7f6e\u6267\u884c\u540c\u6b65\u3002<\/p>\n
## Features<\/p>\n
– Server: ## \u529f\u80fd\u8bf4\u660e<\/p>\n – \u670d\u52a1\u7aef\uff1a ## Sync Modes<\/p>\n – `ADD_ONLY`: Download missing mods only; do not delete extra local mods ## \u540c\u6b65\u6a21\u5f0f<\/p>\n – `ADD_ONLY`\uff1a\u7f3a\u5c11\u5219\u8865\uff0c\u591a\u4f59\u4e0d\u5904\u7406 ## Configuration<\/p>\n Config file: `config\/clientmodsync-common.toml`<\/p>\n – Server:<\/p>\n – `server.httpPort=58235` – `client.enabled=true` Client auto preference file:<\/p>\n – `config\/clientmodsync-client.properties`<\/p>\n ## \u914d\u7f6e<\/p>\n \u914d\u7f6e\u6587\u4ef6\uff1a`config\/clientmodsync-common.toml`<\/p>\n – \u670d\u52a1\u7aef\uff1a<\/p>\n – `server.httpPort=58235` – `client.enabled=true` \u5ba2\u6237\u7aef\u81ea\u52a8\u504f\u597d\u914d\u7f6e\u6587\u4ef6\uff1a<\/p>\n – `config\/clientmodsync-client.properties`<\/p>\n ## Build<\/p>\n – Requires JDK 17 ## \u6784\u5efa<\/p>\n – \u9700\u8981 JDK 17 ## Deployment<\/p>\n 1. Put `clientmodsync-1.0.0.jar` into both server and client `mods` ## \u90e8\u7f72<\/p>\n 1. \u5c06 `clientmodsync-1.0.0.jar` \u653e\u5165\u670d\u52a1\u7aef\u548c\u5ba2\u6237\u7aef\u7684 `mods` Server provides mod files from clientmod, and clients synchronize based on configuration.<\/p>\n","protected":false},"featured_media":41420,"template":"","meta":{"_minecraft_slug":"clientmodsync","_minecraft_project_id":"1MBEwuul","_minecraft_author":"clockclock1","_minecraft_license":"Apache-2.0","_minecraft_downloads":11,"_minecraft_follows":0,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"clientmodsync.zip","_minecraft_size_bytes":85472,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T13:54:36.148038Z","_minecraft_date_created":"2026-05-03T02:54:14.095059Z","_minecraft_date_modified":"2026-05-04T05:58:07.775205Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/clientmodsync","_minecraft_icon_attachment_id":41420,"_minecraft_imported_at":"2026-06-01T22:49:51+00:00","_minecraft_import_hash":"fab6f3d9ec6efa58070d05f8d59e0c9f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,126],"mod_loader":[106],"minecraft_version":[36,60,93,94,101,102],"class_list":["post-41419","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-management","mod_loader-forge","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"],"yoast_head":"\n
\n – Reads `server_root\/clientmod`
\n – Starts an HTTP sync service
\n – Exposes:
\n – `GET \/manifest.json`
\n – `GET \/mods\/
\n– Client:
\n – Checks whether synchronization is needed after mod load (at title screen)
\n – If no sync is needed, no sync UI is shown
\n – If sync is needed, shows sync UI
\n – Supports manual click (`Sync Now`)
\n – Supports auto mode (`Auto Next Time`) with 5-second countdown
\n – Shows progress bar (by mod count), current mod, and realtime speed during sync
\n – Automatically restarts client after sync completes to apply mod changes<\/p>\n
\n – \u8bfb\u53d6 `server_root\/clientmod`
\n – \u542f\u52a8 HTTP \u540c\u6b65\u670d\u52a1
\n – \u63d0\u4f9b\u63a5\u53e3\uff1a
\n – `GET \/manifest.json`
\n – `GET \/mods\/
\n– \u5ba2\u6237\u7aef\uff1a
\n – \u6a21\u7ec4\u52a0\u8f7d\u540e\uff08\u4e3b\u83dc\u5355\uff09\u5148\u68c0\u67e5\u662f\u5426\u9700\u8981\u540c\u6b65
\n – \u82e5\u68c0\u6d4b\u4e3a\u201c\u4e0d\u9700\u8981\u540c\u6b65\u201d\uff0c\u4e0d\u4f1a\u5f39\u51fa\u540c\u6b65\u754c\u9762
\n – \u82e5\u68c0\u6d4b\u4e3a\u201c\u9700\u8981\u540c\u6b65\u201d\uff0c\u5f39\u51fa\u540c\u6b65\u754c\u9762
\n – \u652f\u6301\u624b\u52a8\u70b9\u51fb\uff08`\u7acb\u5373\u540c\u6b65`\uff09
\n – \u652f\u6301\u81ea\u52a8\u6a21\u5f0f\uff08`\u4e0b\u6b21\u53ca\u4ee5\u540e\u81ea\u52a8\u540c\u6b65`\uff0c\u5c55\u793a 5 \u79d2\u540e\u81ea\u52a8\u6267\u884c\uff09
\n – \u540c\u6b65\u8fc7\u7a0b\u4e2d\u663e\u793a\u8fdb\u5ea6\u6761\uff08\u6309\u6a21\u7ec4\u6570\u91cf\uff09\u3001\u5f53\u524d\u540c\u6b65\u6a21\u7ec4\u3001\u5b9e\u65f6\u901f\u5ea6
\n – \u540c\u6b65\u5b8c\u6210\u540e\u81ea\u52a8\u91cd\u542f\u5ba2\u6237\u7aef\u4ee5\u5e94\u7528\u53d8\u66f4<\/p>\n
\n– `STRICT`: Strictly match server `clientmod` (download\/update missing or mismatched mods, delete extra local mods)<\/p>\n
\n– `STRICT`\uff1a\u4e25\u683c\u540c\u6b65\uff08\u7f3a\u5c11\u8865\u9f50\u3001\u54c8\u5e0c\u4e0d\u4e00\u81f4\u66f4\u65b0\u3001\u591a\u4f59\u5220\u9664\uff09<\/p>\n
\n– Client:<\/p>\n
\n – `client.serverIp=””` (empty = use current connected server address)
\n – `client.serverPort=58235`
\n – `client.downloadThreads=4` (parallel download threads; higher is usually faster)
\n – `client.syncMode=”ADD_ONLY”` (`ADD_ONLY` or `STRICT`)<\/p>\n
\n– \u5ba2\u6237\u7aef\uff1a<\/p>\n
\n – `client.serverIp=””`\uff08\u7559\u7a7a\u5219\u4f7f\u7528\u5f53\u524d\u8fde\u63a5\u670d\u52a1\u5668\u5730\u5740\uff09
\n – `client.serverPort=58235`
\n – `client.downloadThreads=4`\uff08\u5e76\u884c\u4e0b\u8f7d\u7ebf\u7a0b\u6570\uff0c\u8d8a\u9ad8\u901a\u5e38\u8d8a\u5feb\uff09
\n – `client.syncMode=”ADD_ONLY”`\uff08`ADD_ONLY` \u6216 `STRICT`\uff09<\/p>\n
\n– Windows: `gradlew build`
\n– Output: `build\/libs\/clientmodsync-1.0.0.jar`<\/p>\n
\n– Windows\uff1a`gradlew build`
\n– \u4ea7\u7269\uff1a`build\/libs\/clientmodsync-1.0.0.jar`<\/p>\n
\n2. Put required client mods into server `clientmod`
\n3. Start server and launch client
\n4. Run sync in UI and wait for automatic restart<\/p>\n
\n2. \u5c06\u9700\u8981\u540c\u6b65\u7684\u6a21\u7ec4\u653e\u5165\u670d\u52a1\u7aef `clientmod`
\n3. \u542f\u52a8\u670d\u52a1\u7aef\u5e76\u6253\u5f00\u5ba2\u6237\u7aef
\n4. \u5728\u5f39\u7a97\u6267\u884c\u540c\u6b65\uff0c\u968f\u540e\u5ba2\u6237\u7aef\u4f1a\u81ea\u52a8\u91cd\u542f<\/p>\n","protected":false},"excerpt":{"rendered":"