更新日志
本项目遵循 Keep a Changelog 规范,重要变更会记录在此。
新增
- 名字注册表:记录“已成功通过正版校验”的名字及其正版 UUID(name -> premiumUUID)。
- 策略:knownPremiumDenyOffline — 一旦某名字曾验证为正版,后续鉴权失败时禁止离线兜底。
- 策略:allowOfflineForUnknownOnly — 仅“从未验证为正版”的名字允许离线兜底。
- 近期同 IP 容错窗口(可配置 TTL):若同名同 IP 近期成功,本次失败可临时按正版处理。
- 管理命令:
/trueuuid link <name>
,支持 dry-run 与备份,将离线 UUID 的数据迁移/合并到正版 UUID。 - 标题短副标题可配:
auth.offlineShortSubtitle
、auth.onlineShortSubtitle
。
变更
- 配置扩展并完善默认值:
auth.knownPremiumDenyOffline = true
auth.allowOfflineForUnknownOnly = true
auth.recentIpGrace.enabled = true
auth.recentIpGrace.ttlSeconds = 300
- 离线兜底的聊天提示文案更清晰。
修复
- Forge 1.20.1 登录阶段客户端有时仅显示“连接中断”而无详细原因:
- 服务器端在断开前显式发送登录与游戏断开包,确保客户端能显示自定义原因。
说明
- “同 IP 容错”偏向可用性,并非强安全。建议缩短 TTL,公共/共享网络慎用。