promotional bannermobile promotional banner

SideGate

SideGate is a Minecraft server plugin that enables a hybrid login system, allowing Premium players to join normally while selectively permitting Offline (Cracked) players via a whitelist, maintaining online-mode security and configurability.

File Details

SideGate 1.0.1 1.20.x

  • R
  • Dec 25, 2025
  • 11.79 KB
  • 100
  • 1.21.11+21

File Name

SideGate-1.0.1.jar

Supported Versions

  • 1.21.5-Snapshot
  • 1.21.11
  • 1.21.10
  • 1.21.9
  • 1.21.8
  • 1.21.7
  • 1.21.6
  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.2
  • 1.21.1
  • 1.21
  • 1.20.3-Snapshot
  • 1.20.5-Snapshot
  • 1.20.6
  • 1.20.5
  • 1.20.4
  • 1.20.3
  • 1.20.2
  • 1.20.1
  • 1.20

SideGate v1.0.1 Changelog

New Features & Enhancements

  • Hybrid Auto-Detection System
    • Implemented intelligent Mojang API integration. The plugin now automatically verifies if a connecting username belongs to a paid Minecraft account.
    • Premium Players: Automatically routed through the standard secure login process (preserving skins and UUIDs).
    • Guest/Cracked Players: Automatically redirected to the guest injection protocol without manual intervention.
    • Config Option: auto-detect-premium: true (Enabled by default).
  • Premium Override List
    • Added a premium-usernames configuration list.
    • Allows administrators to manually force specific usernames to be treated as Premium, bypassing the API check. This is useful for staff security or in cases of API downtime.
  • Performance Optimization
    • Introduced ConcurrentHashMap caching for API results. This minimizes external HTTP requests and prevents login lag during peak traffic.
    • Added a cache cleanup mechanism to prevent memory overflow.

Bug Fixes & Stability

  • UUID Handling: Refined the logic for detecting Offline UUIDs (Version 3) to ensure guest restrictions are applied correctly only to non-premium players.
  • Packet Injection: Improved the stability of the Login.Client.START packet listener to reduce potential conflicts with other protocol-based plugins.

Configuration Changes

  • Added auto-detect-premium (boolean) to toggle the hybrid detection system.
  • Added premium-usernames (list) for manual premium overrides.
  • Updated default messages to clearer, more professional wording.

Upgrade Instructions: To utilize the new features, please regenerate your config.yml or manually add the new auto-detect-premium and premium-usernames keys to your existing configuration.