Configuration

The configuration file is located at plugins/LandRealms/config.yml. After editing, apply changes in-game with /realm reload — a full server restart is not required.

Tip

Run /realm reload to apply configuration changes without restarting the server.

Full Example


database:
  type: "SQLite"
  mysql:
    host: "localhost"
    port: 3306
    database: "landrealms"
    username: "root"
    password: ""
 
realm:
  max-players: 10
  generator: "VOID"
  allow-fly: false
  pvp: false

Database Settings

database.typestringdefault: SQLite

The storage backend. Use SQLite for single-server setups. Use MySQL for networks running BungeeCord or Velocity where data must be shared across nodes.

Accepted values: SQLite, MySQL

database.mysql.hoststringdefault: localhost

Hostname or IP address of the MySQL server. Only used when database.type is MySQL.

database.mysql.portintegerdefault: 3306

Port of the MySQL server.

database.mysql.databasestringdefault: landrealms

The MySQL database name where LandRealms will store its tables.

database.mysql.usernamestringrequired

MySQL username. Required when using MySQL.

database.mysql.passwordstringdefault: ""

MySQL password. Leave blank only if your MySQL instance allows passwordless connections.

Realm Settings

realm.max-playersintegerdefault: 10

Maximum number of players allowed in a single realm at the same time. Players with the landrealms.bypass.maxplayers permission bypass this limit.

realm.generatorstringdefault: VOID

World generator used when creating a new realm.

Value	Description
`VOID`	Empty void world (recommended)
`NORMAL`	Standard terrain generation
`FLAT`	Flat superflat world

realm.allow-flybooleandefault: false

Whether players can fly inside realms. Useful for building-focused servers.

realm.pvpbooleandefault: false

Whether PvP is enabled inside realms. Realm owners cannot change this setting independently of this config key.