跳到主要内容

外置登录与游戏接口

SkinLoom 内置了游戏客户端需要的全部接口,不用装插件:

接口地址玩家怎么用
authlib-injector 外置登录(Yggdrasil)/api/yggdrasil外置登录
CustomSkinLoader/ 或 /csl/皮肤 Mod
UniSkinMod/usm/同上
固定图片地址/skin/<角色名>.png、/cape/<角色名>.png同上

协议与 Blessing Skin(含 yggdrasil-api 插件)相同,原来连 BS 的启动器、服务器和 Mod 把地址换成新站即可。

上线前检查​

  • 设置 site.url:外置登录的元数据和材质地址都由它生成。
  • 材质文件放在 CDN 上(storage.public_url)时,它的域名会自动加入允许加载皮肤的列表;CDN 还有别的域名,写进 yggdrasil.skin_domains。
  • 反向代理要正确转发 Host 和 X-Forwarded-Proto,见反向代理与 HTTPS。

相关设置​

键默认说明
yggdrasil.uuid_algorithmv3新角色的 UUID。v3 与离线服相同,改名后 UUID 跟着变;v4 随机,改名不变。服务器按 UUID 存玩家数据,所以开站前定好
yggdrasil.token_valid_seconds259200启动器登录 3 天有效
yggdrasil.token_refresh_seconds6048007 天内可以自动续期,超过后要重新输入密码
yggdrasil.tokens_per_user10每个账号最多同时登录几个启动器
yggdrasil.enable_alitrue启动器只填站点地址就能找到接口
delivery.profile_cache_seconds60客户端和 CDN 缓存角色数据多少秒;改小换皮肤生效更快,改大服务器压力更小
delivery.missing_player_status404角色不存在时 CustomSkinLoader 接口返回 404 还是 204;204 让客户端继续试下一个皮肤站

你需要知道的​

  • 签名密钥在第一次启动时自动生成,存在数据库里,多个副本共用;备份数据库就备份了它。
  • 启动器登录同样受登录保护:输错太多次需要等待。被封禁的账号在启动器里会看到提示。
  • 用户改密码、"退出所有启动器"后,启动器需要重新登录。
  • 接口的完整列表见开放平台与接口。