Configuration

Main Configuration (configuration.yml)

License

license-key: "CODE"

Option	Type	Default	Description
license-key	String	"CODE"	Plugin license key

Servers

servers:
  login-servers:
    - "auth-1"
    - "auth-2"
  fallback-server: true
  change-server-after-login: false
  after-login-servers:
    - "lobby-1"
    - "lobby-2"

Option	Type	Default	Description
login-servers	List	["auth-1", "auth-2"]	Servers designated for authentication
fallback-server	Boolean	true	Move kicked players to a fallback server
change-server-after-login	Boolean	false	Move players to a lobby server after login
after-login-servers	List	["lobby-1", "lobby-2"]	Lobby servers for post-login redirection

Premium API

apis:
  api-type: MOJANG

Option	Type	Default	Description
api-type	Enum	MOJANG	API used to verify premium accounts

Available API types:

Type	Description
MOJANG	Official Mojang API
ASHCON	Ashcon API (community)
MINETOOLS	MineTools API (community)
CLOUDPROTECTED	CloudProtected API
RANDOM	Randomly selects from available APIs

Premium Player Strategy

other-settings:
  paid-players-strategy: PROTECT_PAID_USERNAME

Strategy	Description
PROTECT_PAID_USERNAME	Premium usernames are always protected. Original owners auto-login
ALLOW_TO_CLAIM_PAID_USERNAME	Anyone can claim a premium username. Auto-login activates after /premium
ALLOW_TO_CLAIM_PAID_USERNAME_AUTO	Anyone can claim a premium username. Original owners auto-login

Sounds

sounds:
  login-sound: "entity.experience_orb.pickup"
  wrong-password-sound: "entity.bat.hurt"
  register-sound: "block.end_portal_frame.fill"

Option	Type	Description
login-sound	String	Sound played on successful login
wrong-password-sound	String	Sound played on wrong password
register-sound	String	Sound played on registration

Title Notifications

notifications-title:
  enabled: true
  fade-in: 1
  fade-out: 1
  stay: 3
  notification-title: "&lm i n e L o g i n"
  need-registered: "You need to register."
  need-logged: "You need to log in."
  success-cracked-login: "Success cracked log in!"
  success-premium-login: "Success premium log in!"
  success-session-login: "Success session log in!"
  success-register: "Success account registration."
  required-verification: "Confirm verification!"

Option	Type	Default	Description
enabled	Boolean	true	Enable title notifications
fade-in	Integer	1	Fade in duration (seconds)
fade-out	Integer	1	Fade out duration (seconds)
stay	Integer	3	Stay duration (seconds)

Boss Bar

boss-bar-commands:
  enabled: true
  color: YELLOW
  overlay: PROGRESS
  login-command: "Use login command: /login <password>"
  register-command: "Use register command: /register <password> <password>"
  require-2-fa-command: "Use verification command: /verification verify <code>"
  require-create-2-fa-command: "Create verification by command: /verification enable"

Option	Type	Default	Description
enabled	Boolean	true	Enable command boss bars (1.9+)
color	Enum	YELLOW	Boss bar color (YELLOW, PURPLE, RED, BLUE, GREEN, WHITE, PINK)
overlay	Enum	PROGRESS	Boss bar style (PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20)

Welcome Picture Head

welcome-picture-head:
  enabled: true
  display-type: ALL_PLAYERS
  only-lobby-servers: true

Option	Type	Default	Description
enabled	Boolean	true	Show player head art in welcome message
display-type	Enum	ALL_PLAYERS	Who sees the head (ALL_PLAYERS, PAID_ONLY)
only-lobby-servers	Boolean	true	Only show on lobby servers

Default Skin

default-skin:
  enabled: true
  value: "<base64 texture data>"
  signature: "<base64 signature>"

Option	Type	Default	Description
enabled	Boolean	true	Enable default skin for cracked players
value	String	Base64	Skin texture data
signature	String	Base64	Skin texture signature

Server Ping / MOTD

server-ping:
  message-of-the-day:
    enabled: true
    messages:
      - "&6ᴍɪɴᴇʟᴏɢɪɴ &8- &7authentication server"
  players-info:
    enabled: true
    messages:
      - "Welcome to the server!"
  version-protocol:
    enabled: true
    protocol: -1
    message: "&e{online} &7players"

Option	Type	Description
message-of-the-day.enabled	Boolean	Enable custom MOTD
message-of-the-day.messages	List	MOTD lines
players-info.enabled	Boolean	Enable custom hover text on player count
players-info.messages	List	Hover text lines
version-protocol.enabled	Boolean	Enable custom version text
version-protocol.protocol	Integer	Protocol version (-1 for custom display)
version-protocol.message	String	Version text ({online} placeholder available)

Proxy Settings

proxy:
  between-connections: "30ms"

Option	Type	Default	Description
between-connections	Duration	30ms	Delay between consecutive player connections

Cache

cache:
  expire-after-leave: 5

Option	Type	Default	Description
expire-after-leave	Integer	5	Minutes to keep player data cached after disconnect

Geyser / Bedrock

geyser:
  enable-bedrock-support: true

Option	Type	Default	Description
enable-bedrock-support	Boolean	true	Enable special handling for Bedrock (Geyser/Floodgate) players

Other Settings

other-settings:
  captcha: true
  captcha-type: CHAT
  enable-welcome-message: true
  delete-old-account-with-same-unique-id: true
  enabled-lobby-command: true
  login-timeout: "30s"
  session-active-time: "3d"
  auto-enable-session: false
  commands-repeat: 5
  nickname-allowed-regex: "[a-zA-Z0-9_]+"
  multi-accounts-notification: true
  unique-id-system-type: USER_STATE
  user-updater: ALWAYS_SAME_UUID

Option	Type	Default	Description
captcha	Boolean	true	Require captcha during registration
captcha-type	Enum	CHAT	Captcha display mode (CHAT or MAP)
enable-welcome-message	Boolean	true	Show welcome message after login
delete-old-account-with-same-unique-id	Boolean	true	Auto-delete old accounts with duplicate UUIDs
enabled-lobby-command	Boolean	true	Enable the /lobby command
login-timeout	Duration	30s	Time to authenticate before being kicked
session-active-time	Duration	3d	Duration of trusted login sessions
auto-enable-session	Boolean	false	Automatically enable session on login
commands-repeat	Integer	5	Seconds between login/register command reminders
nickname-allowed-regex	String	[a-zA-Z0-9_]+	Allowed characters in player names
multi-accounts-notification	Boolean	true	Warn admins about multi-accounts on the same IP

Debug

debugs:
  users-update: false
  paid-check: true
  development: false

Option	Type	Default	Description
users-update	Boolean	false	Log database update operations
paid-check	Boolean	true	Log which API is used for premium checks
development	Boolean	false	Enable developer debug output

---

Messages (messages.yml)

All messages support legacy color codes (e.g. &6 for gold, &c for red).

Available Placeholders

Placeholder	Context	Description
{player}	Admin commands	Target player name
{time}	Timeout / session	Remaining time
{address}	Multi-account	IP address
{accounts}	Multi-account	Number of accounts on IP
{email}	Email commands	Email address

---

Commands Configuration (commands.yml)

Each player command can be individually customized:

login:
  original-name: "login"
  enabled: true
  name: "login"
  description: "Log in to your account"
  permission: ""
  aliases:
    - "l"
  custom-usage: ""

Option	Type	Description
original-name	String	Internal identifier (do not change)
enabled	Boolean	Enable or disable the command
name	String	Command name
description	String	Command description
permission	String	Permission required to use the command (empty = no permission)
aliases	List	Command aliases
custom-usage	String	Custom usage text (requires custom-commands-usages: true in config)

---

Blocked Passwords (blocked-passwords.yml)

A list of forbidden passwords that players cannot use during registration or password change:

blocked-passwords:
  - "password"
  - "password123"
  - "123456"
  - "qwerty"