Getting Started

Overview

XLogin is a complete authentication system for Minecraft servers running XCore. It provides login/register functionality, premium auto-login, two-factor authentication, cross-server sessions, email recovery, and proxy support.

XLogin supports two distinct modes for premium authentication:

  • Standalone mode — Directly injects into the server's Netty pipeline to perform per-player online-mode verification (same technique as JPremium).
  • Proxy mode — The same XLogin.jar on Velocity/BungeeCord handles premium verification, session checking, and smart routing. Backend servers handle login/register and restrictions.

Requirements

  • Paper 1.21.1+ (or Folia)
  • Java 21+
  • XCore 1.0.0+ installed as a plugin
  • For proxy mode: Velocity 3.3+ or BungeeCord (same JAR on proxy + backends)

Installation

  1. Install XCore in your server's plugins/ folder.
  2. Place XLogin.jar in plugins/XCore/addons/.
  3. Start the server. XLogin generates its config in plugins/XCore/addons/XLogin/.
  4. Edit config.yml and lang.yml to match your setup.
  5. Restart or use /xlogin reload.

For proxy networks, see the Proxy Setup guide.

Authentication