Configuration

Database Configuration

XCore manages database connections for all addons using HikariCP connection pooling:

# Database Configuration
database:
  # Type: mysql, postgresql, or sqlite
  type: sqlite

  # MySQL / PostgreSQL settings
  mysql:
    host: localhost
    port: 3306
    database: xcore
    username: root
    password: ""

    # Connection pool settings (HikariCP)
    pool:
      maximum-pool-size: 10
      minimum-idle: 2
      max-lifetime: 1800000
      connection-timeout: 5000

  # SQLite settings
  sqlite:
    file: data.db

Caching System

XCore uses a three-layer caching architecture:

  • L1 — Caffeine: Local in-memory cache for fastest access
  • L2 — Redis: Shared cache across servers (optional)
  • L3 — Database: Persistent storage fallback
# Redis Configuration (optional, for multi-server)
redis:
  enabled: false
  host: localhost
  port: 6379
  password: ""

Economy & Multi-Currency

Multi-currency economy system with Vault integration, supporting transactions, exchange, and interest management.

# Economy
economy:
  enabled: true
  provider: vault
  currencies:
    - name: "Coins"
      symbol: "$"
      default: true

Web Dashboard

Built-in web dashboard with REST API and metrics:

# Web Dashboard
web:
  enabled: false
  port: 8080
  auth-token: "your-secret-token"

API endpoints are secured via Bearer token authentication. Addons can register custom routes under /api/<addon-name>/.