Skip to main content

​
Configuration Reference

Complete guide to every NexAuth configuration setting in config.conf. NexAuth uses HOCON format (Human-Optimized Config Object Notation) for configuration.
Configuration Location:
  • Velocity: plugins/nexauth/config.conf
  • Paper/Purpur: plugins/NexAuth/config.conf
The file is automatically generated on first startup with default values.

​
Quick Start

1

Generate Config

Start your server once to generate the default config.conf file.
2

Edit Configuration

Edit config.conf with your preferred settings.
3

Restart

Restart the server to apply your changes.

​
Configuration Categories

​
Database Type

database {
    type=nexauth-sqlite
    transient-retries=0
    transient-retry-delay-ms=250
}
Database Recommendations:
  • Small servers (< 100 players): SQLite (default)
  • Medium servers (100-500 players): MySQL/MariaDB
  • Large networks (500+ players): PostgreSQL
max-login-attempts=-1
milliseconds-to-refresh-login-attempts=10000
seconds-to-authorize=-1

default-crypto-provider=BCrypt-2A
profile-conflict-resolution-strategy=BLOCK
new-uuid-creator=CRACKED
ip-limit=-1

session-timeout=0
remember-last-server=false

auto-register=false
profile-conflict-resolution-strategy=BLOCK

totp {
    enabled=true
    label="NexAuth Network"
    delay=1000
}

limbo-port-range="30000-40000"
ping-servers=false
fallback=false

use-titles=true
use-action-bar=false
milliseconds-to-refresh-notification=10000

mail {
    enabled=false
    host="smtp.gmail.com"
    port=587
}

debug=false
failure-policy {
    mode=HARD_FAIL
}
revision=8

​
Next Steps

Premium Authentication

Configure premium account auto-login and profile conflict resolution.

Security Features

Learn about brute force protection, password hashing, and security best practices.