Compatibility
Minecraft: Java Edition
1.21.1
1.20.1–1.20.6
Platforms
Supported environments
Links
Creators
Details
Licensed LGPL-3.0-only
Published 4 months ago
Updated 2 months ago
Changelog
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 = trueauth.allowOfflineForUnknownOnly = trueauth.recentIpGrace.enabled = trueauth.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.
Files
Metadata
Release channel
ReleaseVersion number
1.0.1Loaders
Game versions
1.20.1–1.20.6Environment
Client and server, required on both
Downloads
30Publication date
September 8, 2025 at 2:02 PMPublisher

YuWan030
Member


