Skip to content

Releases: YuWan-030/TrueUUID

v1.0.2-TrueUUID

09 Sep 16:57
@YuWan-030 YuWan-030
v1.0.2
7f4fe36

Choose a tag to compare

View all tags
v1.0.2-TrueUUID Latest
Latest

修复重大BUG
开放公共查询账号状态API

Assets 3
Loading

v1.0.1-TrueUUID

08 Sep 14:00
@YuWan-030 YuWan-030
v1.0.1
0b71edd

Choose a tag to compare

View all tags
v1.0.1-TrueUUID

Changelog

All notable changes to this project will be documented in this file.
This project adheres to Keep a Changelog and Semantic Versioning (when applicable).

Added

  • Name Registry to record names that have successfully verified as premium (name -> premium UUID).
  • Policy: knownPremiumDenyOffline — once a name verifies as premium, deny offline fallback for that name on future failures.
  • Policy: allowOfflineForUnknownOnly — allow offline fallback only for names that have never verified as premium.
  • Recent IP Grace window (configurable TTL) to temporarily allow premium session if same name+IP recently verified.
  • Admin command: /trueuuid link <name> with dry-run and backups to migrate/merge offline data to the premium UUID.
  • Short Title subtitles configuration: auth.offlineShortSubtitle, auth.onlineShortSubtitle.

Changed

  • Configuration documented and expanded:
    • auth.knownPremiumDenyOffline = true
    • auth.allowOfflineForUnknownOnly = true
    • auth.recentIpGrace.enabled = true
    • auth.recentIpGrace.ttlSeconds = 300 (defaults)
  • Improved user messaging: clearer offline fallback chat message.

Fixed

  • Client sometimes only showed “Disconnected” without reason on Forge 1.20.1 login stage:
    • Server now explicitly sends Login and Game disconnect packets before closing to ensure the client displays the reason.

Notes

  • Recent IP Grace is for usability, not strong security. Use a small TTL and avoid shared networks if possible.

更新日志

本项目遵循 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，公共/共享网络慎用。
Loading