PSGLogin

📄 Install PSGLogin on Paper

1. Download PSGLogin-paper.jar from the releases page.
2. Place it inside your server's /plugins/ folder.
3. Start the server once — it will generate all config files.
4. Stop the server before editing configs.

⚙️ Paper — config.yml

# ── PROXY MODE ── set false for standalone Paper
proxy:
  enabled: false

# ── AUTH TIME ── seconds player has to login before kick
# Set 0 to disable the time limit entirely
main:
  auth-time: 60
  min-password-length: 6
  max-password-length: 32
  register-confirm-password: true  # /register <p> <p> or /register <p>
  ip-limit-registrations: 3       # max accounts per IP

# ── AUTO LOGIN ── same IP reconnect skips login
auto-login:
  enabled: true
  expiry-seconds: 86400  # 86400=24h  43200=12h  0=unlimited

# ── PREMIUM ── Mojang accounts skip login (online-mode only)
premium:
  enabled: false  # set true only if server is in online-mode

# ── BEDROCK ── Floodgate/Geyser players skip login
bedrock:
  auto-login: true

# ── SECURITY ──
security:
  brute-force:
    max-attempts: 5       # failed logins before account lock
    lock-duration: 300    # seconds account stays locked
    ip-max-attempts: 10   # failed logins before IP ban
    ip-ban-duration: 600  # seconds IP stays banned
  anti-bot:
    enabled: true
    max-joins-per-ip: 3   # max joins from one IP per window
    time-window: 10       # seconds for the window

🎨 Paper — messages.yml

# Change the plugin prefix shown in chat
prefix: "&8[&cPSGLogin&8]&r "

# Title shown after successful login (%player% = player name)
titles:
  success:
    title: "&a&lHi %player%"
    subtitle: "&aLogged in"
    fadeIn: 30   # ticks (20 ticks = 1 second)
    stay: 100
    fadeOut: 30

# Multiline chat message after login
messages:
  login-success: |
    &f
    &8[&a&l»&8] &7Welcome back, &a%player%&7!
    &f
  register-success: |
    &f
    &8[&a&l»&8] &7Welcome, &a%player%&7! Here are your commands:
    &f  &a&l» &7/changepassword &f  &a&l» &7/logout
    &f

📍 Set the Spawn Location

/psglogin setspawn       # sets spawn where you're standing
/psglogin setloginarea   # sets a separate login area (optional)

⚡ Velocity + Paper — How It Works

🌑 Set Up NanoLimbo

1. Download NanoLimbo.jar from its GitHub releases page.
2. Create a new folder called nanolimbo and place the jar inside.
3. Start it once: java -jar NanoLimbo.jar — it generates a config.
4. Default port is 65535. Change it in config if needed.
5. No other configuration is needed — it is just a void world.

📋 Configure velocity.toml

[servers]
# Name on the left must match limbo-server in velocity-config.yml
limbo  = "127.0.0.1:65535"  # NanoLimbo port
lobby  = "127.0.0.1:25577"  # Paper lobby port
pvp    = "127.0.0.1:25578"  # other Paper servers (optional)

# Players are sent here first when they connect
try = [
  "limbo"
]

# Must be false for offline-mode authentication to work
online-mode = false

⚡ Install PSGLogin on Velocity

1. Download PSGLogin-velocity.jar from the releases page.
2. Place it in Velocity's /plugins/ folder.
3. Start Velocity once to generate config files, then stop it.
4. Config files are created at plugins/psglogin/

⚙️ Velocity — velocity-config.yml

# ── SERVERS ── must match names in velocity.toml [servers]
limbo-server: limbo
main-server:  lobby

# ── AUTH TIME ── seconds before unauthenticated player is kicked
# Set 0 to disable
auth-time: 60

# ── DELAY ── ms to wait before sending AUTH to Paper after login
# Increase if players arrive on Paper before receiving the AUTH message
post-auth-message-delay: 1000

# ── PREMIUM ── Mojang accounts auto-login (Velocity online-mode)
premium:
  enabled: true

# ── BEDROCK ── Floodgate players auto-login
bedrock:
  auto-login: true

# ── AUTO LOGIN ── reconnect from same IP skips login
auto-login:
  enabled: true
  expiry-seconds: 86400  # 0 = never expires

# ── ACCESS TOKEN ── must match every Paper server's config.yml
# Generate any random 64-character string and paste it here
access-token: "CHANGE_ME_TO_A_RANDOM_64_CHAR_STRING"

# ── DATABASE ── SQLite for single server, MySQL for networks
database:
  type: MYSQL
  mysql:
    host: localhost
    port: 3306
    database: psglogin
    username: root
    password: yourpassword

🎨 Velocity — velocity-messages.yml

# Prefix shown in all chat messages
prefix: "&8[&#FF4500&lPSGLogin&8]&r "

# Title shown while player needs to register
titles:
  register:
    title: "&#FF4500&lREGISTER"
    subtitle: "&#FFD700Use /register <password> <password>"
    interval: 4   # repeat every 4 seconds
  login:
    title: "&#FF4500&lLOGIN REQUIRED"
    subtitle: "&#FFD700Use /login <password>"
    interval: 4
  success:
    title: "&#00E676&lHi %player%"
    subtitle: "&#69F0AE&oLogged in"

# Chat message shown after login (multiline supported)
messages:
  login-success: |
    &f
    &8[&a&l»&8] &7Welcome back, &a%player%&7!
    &f
  register-success: |
    &f
    &8[&a&l»&8] &7Welcome, &a%player%&7!
    &f  &a&l» &7/changepassword  &a&l» &7/logout
    &f

📄 Install PSGLogin on Paper Backends

1. Download PSGLogin-paper.jar and drop it into each Paper server's /plugins/ folder.
2. Start each Paper server once to generate config files, then stop.
3. Edit plugins/PSGLogin/config.yml on each server — see next step.
4. Repeat for every backend: lobby, survival, pvp, creative, etc.

⚙️ Paper Backend — config.yml

# ── PROXY MODE ── MUST be true for Velocity setup
proxy:
  enabled: true
  # Must match access-token in velocity-config.yml EXACTLY
  access-token: "CHANGE_ME_TO_A_RANDOM_64_CHAR_STRING"

# ── DATABASE ── use same MySQL DB as Velocity for shared data
database:
  type: MYSQL
  mysql:
    host: localhost
    port: 3306
    database: psglogin   # same database name as Velocity
    username: root
    password: yourpassword

🚀 Start Order

🗄️ Database — SQLite

database:
  type: SQLITE

🗄️ Database — MySQL

database:
  type: MYSQL
  mysql:
    host: localhost       # your database server IP
    port: 3306           # default MySQL port
    database: psglogin  # database name (create it first)
    username: root
    password: yourpassword
    pool-size: 10