Configuration Reference

This page provides an exhaustive guide to all settings available in plugins/MapArtLandRental/config.yml.

---

Full Default Configuration

database:
  type: sqlite
  sqlite:
    file: mapart.db
  mysql:
    host: localhost
    port: 3306
    database: mapart
    username: mapart
    password: ""
    worker-threads: 2
    maximum-pool-size: 4

economy:
  enabled: true
  provider: vault

rental:
  initial-days: 7
  extension-days: 7
  maximum-total-days: 60
  grace-period-hours: 24
  expiration-check-seconds: 60

gui:
  # Prefer Native Dialog on Java Edition
  dialog: true
  # Bedrock Edition UI. 'rich' prefers Rich UI, 'default' prefers standard form
  bedrock: rich

# 0 means unlimited
limits:
  projects-per-owner: 0
  leases-per-project: 0
  active-leases-per-player: 0

world:
  name: mapart_world
  create-if-missing: true
  void-generator: true
  base-y: 64
  base-material: SMOOTH_STONE
  suppress-mob-spawn: true
  fixed-weather: true
  fixed-time: 6000
  suppress-fire: true
  suppress-explosion-damage: true

protection:
  # Work buffer width added around the map art canvas
  lease-buffer: 16

reset:
  chunks-per-tick: 1
  blocks-per-region-task: 4096

plot-types:
  "128":
    enabled: true
    size: 128
    initial-price: 5000
    extension-price: 3000
    origin-x: -64
    origin-z: -64
    stride-x: 256
    stride-z: 0
  "256":
    enabled: true
    size: 256
    initial-price: 10000
    extension-price: 6000
    origin-x: -64
    origin-z: 100032
    stride-x: 512
    stride-z: 0
  "512":
    enabled: true
    size: 512
    initial-price: 20000
    extension-price: 12000
    origin-x: -64
    origin-z: 300480
    stride-x: 1024
    stride-z: 0
  "1024":
    enabled: true
    size: 1024
    initial-price: 40000
    extension-price: 24000
    origin-x: -64
    origin-z: 700352
    stride-x: 2048
    stride-z: 0
  "2048":
    enabled: true
    size: 2048
    initial-price: 80000
    extension-price: 48000
    origin-x: -64
    origin-z: 1501120
    stride-x: 4096
    stride-z: 0

---

Detailed Section Breakdown

database

Specifies persistent storage settings. Database migrations run automatically during startup.

Field	Default	Description
type	sqlite	Database engine to use: sqlite or mysql.
sqlite.file	mapart.db	File name for the SQLite database.
mysql.host	localhost	MySQL server host name.
mysql.port	3306	MySQL server port number.
mysql.database	mapart	Database schema name.
mysql.username	mapart	Connection username.
mysql.password	""	Connection password.
mysql.worker-threads	2	Number of asynchronous worker threads for database queries.
mysql.maximum-pool-size	4	Maximum HikariCP connection pool size.

economy

Field	Default	Description
enabled	true	Whether to charge players for plot rentals and extensions. If false, rentals are free.
provider	vault	Economy adapter. Currently supports vault.

rental

Field	Default	Description
initial-days	7	Duration (in days) granted on initial lease creation.
extension-days	7	Additional duration (in days) granted per extension.
maximum-total-days	60	Maximum cumulative lease lifetime from initial start date. Extensions beyond this cap are rejected.
grace-period-hours	24	Grace period duration (in hours) after expiration before reset begins.
expiration-check-seconds	60	Interval (in seconds) between automated lease expiration checks.

gui

Controls UI presentation preferences via NegiLib.

Field	Default	Description
dialog	true	Prefers Native Dialog on Java Edition with automatic fallback to Inventory GUI. If false, always uses Inventory GUI.
bedrock	rich	Form style for Bedrock Edition players via Geyser. rich prefers Rich Form with fallback to standard, while default always uses standard form.

limits

Operational caps per owner, project, or player. Setting any limit to 0 disables it (unlimited).

Field	Default	Description
projects-per-owner	0	Maximum projects a player can own concurrently.
leases-per-project	0	Maximum concurrent leases allowed under a single project.
active-leases-per-player	0	Maximum concurrent active leases a player can hold across all projects.

world

Configures the dedicated map art production world.

Field	Default	Description
name	mapart_world	Name of the dedicated map art world.
create-if-missing	true	Whether to automatically create the world if it does not exist.
void-generator	true	Uses an empty void chunk generator.
base-y	64	Y coordinate of the surface floor. Bedrock is generated at base-y - 1.
base-material	SMOOTH_STONE	Material for the surface floor. Case-insensitive and supports the minecraft: namespace.
suppress-mob-spawn	true	Prevents hostile and passive mob spawning.
fixed-weather	true	Locks weather to clear skies.
fixed-time	6000	Locks in-game time (6000 corresponds to noon).
suppress-fire	true	Disables fire spread and burn out.
suppress-explosion-damage	true	Disables explosion block destruction.

protection

Field	Default	Description
lease-buffer	16	Width (in blocks) of the buildable work buffer added equally around the central Map Bounds.

reset

Controls rate limits for chunk section resets to avoid server lag spikes.

Field	Default	Description
chunks-per-tick	1	Maximum number of chunks scanned or processed per tick.
blocks-per-region-task	4096	Maximum blocks updated per region reset task.

plot-types

Defines available plot dimensions, pricing, and grid layout coordinates.

Key	Description
enabled	Whether this plot size is available for rental (true / false).
size	Canvas dimension in blocks (128, 256, 512, etc.).
initial-price	Initial lease cost when economy is enabled.
extension-price	Cost per lease extension when economy is enabled.
origin-x, origin-z	Northwest corner coordinates of plot index 0. Must align with vanilla map boundaries.
stride-x, stride-z	Step offset to adjacent plots. Must be larger than size + 2 * lease-buffer.