Skip to content

Configuration

Jump to bottom
realpeyaj edited this page Jul 6, 2026 · 2 revisions

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

Interactive PIN Pad GUI (config.yml)

The GUI PIN Pad allows users to click concrete blocks in a custom chest interface to register or log in instead of typing passwords in chat.

To configure the PIN pad:

pin-pad:
  enabled: true          # Toggle PIN pad GUI globally
  required-length: 4     # Number of digits required (default: 4)

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

Clone this wiki locally