RankForge Database Configuration – JSON, SQLite, MySQL, MariaDB, PostgreSQL, MongoDB

RankForge supports 6 storage backends, configured via database.type in config.yml.

Type	Nature	Best For
JSON	Local flat-file (players.json)	Single servers, plug-and-play zero configuration (default)
SQLITE	Local relational file (rankforge.db)	Single servers desiring a single relational file
MYSQL	Remote SQL	Multi-server networks with shared rankings
MARIADB	Remote SQL	MariaDB-based server networks
POSTGRESQL	Remote SQL	Enterprise or clustered cloud infrastructures
MONGODB	NoSQL document-based	Cloud setups or document architectures

Database changes require a server restart

The database section is read exclusively during server startup. /rankforge reload does not reload database pools.

Configuration Examples

JSON

No additional settings required. Data is stored atomically in plugins/RankForge/players.json.

database:
  type: "JSON"

SQLite

Data is stored in plugins/RankForge/rankforge.db.

database:
  type: "SQLITE"

Uses the native SQLite driver bundled with modern Paper runtimes.

MySQL

database:
  type: "MYSQL"
  host: "127.0.0.1"
  port: 3306
  name: "rankforge"
  username: "root"
  password: "your_password"
  table-prefix: "rf_"
  pool:
    maximum-pool-size: 10
    minimum-idle: 5
    connection-timeout: 30000
    max-lifetime: 1800000

MariaDB

database:
  type: "MARIADB"
  host: "127.0.0.1"
  port: 3306
  name: "rankforge"
  username: "root"
  password: "your_password"
  table-prefix: "rf_"

PostgreSQL

database:
  type: "POSTGRESQL"
  host: "127.0.0.1"
  port: 5432
  name: "rankforge"
  username: "postgres"
  password: "your_password"
  table-prefix: "rf_"

MongoDB

database:
  type: "MONGODB"
  uri: "mongodb://username:password@127.0.0.1:27017/rankforge?authSource=admin"
  database: "rankforge"
  collection: "players"

Fail-Safe Automatic Fallback

If a remote database loses connection or encounters an initialization error, RankForge logs a warning and automatically falls back to local JSON storage. This guarantees player stats are never lost and your Minecraft server will never crash due to database outages.