Configuration

Configuration & Setup Guide

This page explains how to install peyajAuth and customize its various security, database, and gameplay settings.

Installation

1. Download the latest compiled peyajAuth.jar from the Releases section.
2. Put the .jar file into your server's plugins/ directory.
3. Start the server to generate default configuration files under /plugins/peyajAuth/.
4. Open the configuration files in a text editor, edit your settings, and reload using /auth reload.

---

Database Configuration (database.yml)

peyajAuth supports local SQLite (default) or external MySQL/MariaDB database engines. To configure database settings, edit the /plugins/peyajAuth/database.yml file:

type: SQLITE # Options: SQLITE, MYSQL, MARIADB

sqlite:
  file-name: auth.db

mysql:
  host: localhost
  port: 3306
  database: minecraft
  username: root
  password: ""
  pool-settings:
    maximum-pool-size: 10
    minimum-idle: 2
    connection-timeout: 30000
    idle-timeout: 600000
    max-lifetime: 1800000

---

Captcha Gates (config.yml)

Stop bots from filling your server using captchas on connection:

captcha:
  enabled: true          # Enable or disable captcha gates on join
  mode: gui             # Verification modes: 'gui' (item click challenge) or 'chat' (verification code)

---

Account Security Tweak (config.yml)

security:
  # Limit registrations per IP address
  max-accounts-per-ip: 2
  
  # Lock accounts after repeated password failures
  brute-force:
    max-attempts: 5
    lockout-duration-minutes: 15