Universal Settings

模组

· 作者 WhiteMCWizard

一个跨不同实例、版本和电脑同步你设置的模组。

0 本站下载 0 关注 更新于 1 个月前

最新 0.1.1 · 26.3 · NeoForge

一键开服(送7天)

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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源