Data Storage

🧭 Overview

ArenaLegends supports two main storage methods for player and game data:

1. Local (JSON Files) — Default. Easy to access and edit manually.

2. MySQL Database — Recommended for larger servers or multi-server networks.

All player data, statistics, and settings are stored in structured JSON files by default.

---

📁 File Structure

All data is located in the /ArenaLegends/data/ directory.

Path	Description
/data/settings.yml	Contains various local plugin settings.
/data/metrics.yml	Used for tracking plugin metrics and analytics.
/data/players/	Stores individual player data files in JSON format.

Example structure:

/ArenaLegends/
 └── data/
     ├── settings.yml
     ├── metrics.yml
     └── players/
         ├── Notch.json
         ├── Steve.json
         └── Alex.json

---

🗄️ MySQL Integration

Switching to MySQL is recommended for centralized data management, especially on networks (BungeeCord/Velocity).

How to Enable

1. Open /ArenaLegends/config.yml.

2. Locate the mysql section.

3. Set enabled to true.

4. Fill in your database credentials.

⚙️ Configuration

mysql:
  connection:
    enabled: false
    url: "jdbc:mysql://{HOST}:{PORT}/{NAME}"
    maximum-pool-size: 10
    minimum-idle: 5
    max-lifetime: 1800000
    idle-timeout: 600000
    connection-timeout: 30000
    leak-detection-threshold: 60000
    auto-commit: true
  credentials:
    host: "value"
    port: "3306"
    name: "value"
    user: "value"
    pass: "value"

• Switching: You can switch between local and MySQL at any time. Restart the server to apply changes.

• Performance: MySQL handles large datasets more efficiently than flat files.