Universal Settings
一款客户端 Minecraft 模组(Fabric + NeoForge),可将你的设置同步到你游玩过的每一台电脑、每个实例和游戏版本。
无需为每个新实例或 PC 重复进行相同的设置。首次启动时,全新安装会自动拉取你的设置,此后所做的任何更改都会自动同步到其他安装中。
同步内容: options.txt 中的所有设置以及你的多人游戏服务器列表。
配置文件(Profiles): 可保留多个命名配置文件(例如 default、laptop),并选择一个设为默认。如果某个安装已存在自定义设置,你会获得一次性选择:将其保存为新配置文件,或切换为你同步的设置。
身份验证: 无需登录。模组通过加入多人游戏服务器所使用的相同 Mojang 会话握手来证明你的身份,因此只有你能读取或写入自己的设置。在离线模式下,会话期间的同步会暂停,且本地设置不受影响。
隐私
此模组会将你的设置上传至同步服务器,以便在你的各个安装之间共享。默认情况下,该服务器是模组作者运营的中心实例 (universalsettings.whitemcwizard.nl)。
- 存储内容: 你的 Minecraft 用户名和 UUID、
options.txt的内容、servers.dat(多人游戏服务器列表)以及排除列表。 - 包含你的服务器列表。
servers.dat保存了你添加的所有多人游戏服务器的地址。如果你不想上传该文件,可以在游戏内 Ignored Settings 界面关闭 Sync servers。 - 你可以删除它。 在游戏内删除配置文件会从服务器上移除它。
- 不存储任何秘密信息。 Mojang 握手过程绝不会向同步服务器暴露你的密码或启动器令牌。
不愿使用中心服务器?本仓库包含了完整的服务器代码 (server/)。可自行托管并将模组的 serverUrl 指向你自己的实例(位于 config/universalsettings.json 中)。
目录结构
common/:所有模组逻辑(同步管理器、选项编解码器、HTTP 客户端、身份验证、首次运行 UI、Mixin)fabric/、neoforge/:轻量级加载器入口点server/:中心同步服务器(Node.js + Fastify + SQLite)versions/{mc}/gradle.properties:按 Minecraft 版本划分的属性文件,所有分支共享
多版本构建由 Stonecutter 管理:
每个支持的 Minecraft 版本都是每个分支的 Gradle 子项目(“节点”),
例如 :fabric:26.1.2。活动版本的源代码直接位于 {branch}/src/ 中;
在切换版本后提交前,请使用 Reset active project 任务。
要添加一个 Minecraft 版本:在 settings.gradle 中注册它(versions '26.1.2', '...'),
创建包含该版本属性的 versions/{mc}/gradle.properties,并使用 Stonecutter 注释移植特定版本的代码(//? if <1.21 {)。
开发
模组(建议使用 JDK 21+ 运行 Gradle;每个 Minecraft 版本针对不同的 Java 发行版,Gradle 会根据版本自动配置相应的工具链):
./gradlew buildAll # 构建所有分支的所有版本
./gradlew :fabric:26.1.2:build # 构建单个加载器 JAR
./gradlew :fabric:26.1.2:runClient # 开发客户端
服务器(Node 22+):
cd server
npm install
AUTH_DISABLED=true npm run dev # 在 :8080 上启动开发服务器,跳过 Mojang 验证
npm test # vitest API 测试
要进行端到端的开发循环,请将运行目录下的 config/universalsettings.json 中的 serverUrl 指向 http://localhost:8080,并使用 AUTH_DISABLED=true 启动开发服务器。由于开发客户端没有真实的 Mojang 令牌,模组会在开发环境中跳过客户端加入流程以保持一致性。当 NODE_ENV=production 时,服务器拒绝以 AUTH_DISABLED 模式启动。
API
| 方法/路径 | 认证 |
|---|---|
POST /auth/challenge, POST /auth/verify |
(速率限制) |
GET /players/:uuid/profiles[/default|/:name] |
JWT |
PUT /players/:uuid/profiles/:name |
JWT |
POST /players/:uuid/default |
JWT |
POST /players/:uuid/profiles/:name/rename |
JWT |
DELETE /players/:uuid/profiles/:name |
JWT |
GET|PUT /players/:uuid/exclusions |
JWT |
PUT /players/:uuid/profiles/:name/exclusions |
JWT |
GET /health |
部署中心服务器
cd server
cp .env.example .env # 设置 JWT_SECRET (openssl rand -hex 32) 和 DOMAIN
docker compose up -d --build
捆绑的 Compose 堆栈在 Caddy 后面运行 API,Caddy 会为 DOMAIN 自动获取 HTTPS。SQLite 数据库位于 server/data/;通过复制文件进行备份。
许可证
MIT。基于 MultiLoader Template。
Universal Settings
A client-side Minecraft mod (Fabric + NeoForge) that syncs your settings across every computer, instance, and game version you play on.
No more redoing the same setup for every new instance or PC. A fresh install pulls your settings on first launch, and every change you make afterwards syncs to your other installs automatically.
What syncs: everything in options.txt and your multiplayer server list.
Profiles: keep multiple named profiles (e.g. default, laptop) and pick one as the default. If an install already has customized settings, you get a one-time choice to keep them as a new profile or switch to your synced ones.
Authentication: no login, ever. The mod proves who you are through the same Mojang session handshake used to join multiplayer servers, so only you can read or write your settings. In offline mode syncing pauses for the session and your local settings are untouched.
Privacy
This mod uploads your settings to a sync server so they can be shared across your installs. By default that server is the central instance operated by the mod author (universalsettings.whitemcwizard.nl).
- What is stored: your Minecraft username and UUID, the contents of your
options.txt, yourservers.dat(multiplayer server list), and your exclusion lists. - Your server list is included.
servers.datholds the addresses of every multiplayer server you've saved. If you'd rather not upload that, turn off Sync servers in the in-game Ignored Settings screen. - You can delete it. Deleting a profile in-game removes it from the server.
- No secrets are stored. The Mojang handshake never exposes your password or launcher token to the sync server.
Prefer not to use the central server? This repository includes the full server (server/). Self-host it and point the mod at your own instance with serverUrl in config/universalsettings.json.
Layout
common/: all mod logic (sync manager, options codec, HTTP client, auth, first-run UI, mixins)fabric/,neoforge/: thin loader entry pointsserver/: the central sync server (Node.js + Fastify + SQLite)versions/{mc}/gradle.properties: per-Minecraft-version properties, shared by all branches
Multi-version builds are managed by Stonecutter:
every supported Minecraft version is a Gradle subproject ("node") of each branch,
e.g. :fabric:26.1.2. The active version's sources live directly in {branch}/src/;
use the Reset active project task before committing after a version switch.
To add a Minecraft version: register it in settings.gradle (versions '26.1.2', '...'),
create versions/{mc}/gradle.properties with that version's properties, and port
version-specific code with Stonecutter comments (//? if <1.21 {).
Development
Mod (JDK 21+ recommended to run Gradle; each Minecraft version targets a different Java release, and Gradle auto-provisions the right toolchain per version):
./gradlew buildAll # build every version of every branch
./gradlew :fabric:26.1.2:build # build one loader jar
./gradlew :fabric:26.1.2:runClient # dev client
Server (Node 22+):
cd server
npm install
AUTH_DISABLED=true npm run dev # dev server on :8080, skips Mojang verification
npm test # vitest API tests
For an end-to-end dev loop, point the run dir's config/universalsettings.json serverUrl at http://localhost:8080 and start the dev server with AUTH_DISABLED=true. Dev clients have no real Mojang token, so the mod skips the client-side join in dev environments to match. The server refuses to start with AUTH_DISABLED when NODE_ENV=production.
API
| Method/Path | Auth |
|---|---|
POST /auth/challenge, POST /auth/verify |
(rate limited) |
GET /players/:uuid/profiles[/default|/:name] |
JWT |
PUT /players/:uuid/profiles/:name |
JWT |
POST /players/:uuid/default |
JWT |
POST /players/:uuid/profiles/:name/rename |
JWT |
DELETE /players/:uuid/profiles/:name |
JWT |
GET|PUT /players/:uuid/exclusions |
JWT |
PUT /players/:uuid/profiles/:name/exclusions |
JWT |
GET /health |
Deploying the central server
cd server
cp .env.example .env # set JWT_SECRET (openssl rand -hex 32) and DOMAIN
docker compose up -d --build
The bundled Compose stack runs the API behind Caddy, which obtains HTTPS automatically for DOMAIN. The SQLite database lives in server/data/; back it up by copying the file.
License
MIT. Based on the MultiLoader Template.
下载 Universal Settings
下载 Universal Settings
下载 Universal Settings
下载 Universal Settings
下载 Universal Settings
下载 Universal Settings
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Universal Settings
下载 Universal Settings
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Universal Settings
下载 Universal Settings
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
AE2:一款流行的自动化与存储模组
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧