# 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:

```yaml
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:

```yaml
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`)

```yaml
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
```