Configuration

The main configuration file is plugins/Plot/config.yml, generated automatically on first startup. Below is every section explained in detail.

General settings

config-version: 9

# Available languages: de_DE, en_US, fr_FR, it_IT, ru_RU, es_ES, pl_PL
language: en_US

# The world where plots are located (useful if you use Multiverse)
plot_world: world

# Used for premium backups (identifies your server on remote storage)
server_name: eclipseMc

# Prefix added to all plugin messages (supports hex colors &#rrggbb)
prefix: "[&#a000ffS&#9100ffc&#8300ffa&#7500ffl&#6700ffa&#5800ffP&#4a00ffl&#3c00ffo&#2e00fft] | &#ffffff"

language: default message language. See Languages & translations.
server_name: used by the premium backup system to identify which server a backup came from, so you can find it even when loading it on a different server.
prefix: supports both classic color codes (&a) and hex colors (&#a000ff).

World dimensions

plot_size: 100
road_size: 2
road_material: SMOOTH_STONE_SLAB

Economy (Vault)

claim_cost: 0
currency: €
succesfull_report_reward: 100

claim_cost: cost to claim a plot. If set to 0, Vault is not required. Any other value makes Vault necessary.
⚠️ Decimal numbers with a comma or dot (e.g. 15.98 / 15,98) are not supported and may cause an error: use whole numbers only.
succesfull_report_reward: reward (in server currency) given to a player when one of their plot reports is confirmed valid (a Premium LIB feature).

Web map rendering (Premium)

render:
  auto_start: false
  interval_minutes: 30

Controls automatic periodic rendering of the integrated web map (Premium feature, see Web map & rendering).

Inactive plot cache

unused_plot_cache:
  enabled: false
  days_inactivity: 30
  check_interval_minutes: 60

If enabled, automatically removes the owner from a plot after a period of inactivity, freeing it up for other players.

Premium license

premium_key:
download_premium_lib: true

premium_key: your license key. If left empty, premium features (e.g. web map) won’t be available.
download_premium_lib: if true, the plugin automatically downloads the premium library when needed.

Web server (map)

webserver:
  enabled: true
  host: 0.0.0.0
  port: 8080

Configures the internal HTTP server (based on NanoHTTPD) that serves the premium web map.

Debug and updates

debug: false
enable_auto_update: true
send_statistic: true

debug: enables verbose logging. Only enable it for support or troubleshooting.
enable_auto_update: if true, the plugin automatically downloads and installs the latest available update, replacing the existing .jar.
send_statistic: sends anonymous statistics to bStats and FastStats. It helps the developer spot errors and improve the plugin: it’s recommended to leave it enabled.

Plot limits per player

max_ownable_plots: 5

max_ownable_plot_by_perm:
  enable: false
  default: 2
  vip: 5

max_ownable_plots: maximum number of plots a single player can own.
If max_ownable_plots is set below 2, the merge feature of the premium addon is automatically disabled.
max_ownable_plot_by_perm: lets you differentiate the limit based on the plot.vip permission. The higher value cannot exceed max_ownable_plots.

Backups

backup:
  auto_backup: true
  interval_minutes: 60
  max_backups_per_plot: 5
  storage_path: "backups"
  backup_on_deletion: true

See the dedicated page: Backups.

Exploit prevention

unwanted_interactions:
  trapdoor: true
  itemframe: true
  liquid_flow: true
  dispenser: true
  piston: true
  explosion: true

Each entry corresponds to a known exploit that lets someone interact with another player’s plot without permission (e.g. opening a trapdoor across the plot boundary). It’s recommended to leave all protections enabled.

Discord webhooks

webhooks:
  claim_webhook_url: https://discord.com/api/webhooks/......
  report_webhook_url: https://discord.com/api/webhooks/......
  star_webhook_url: https://discord.com/api/webhooks/......

See Discord webhooks.

Automatic plot generation

auto_generation:
  enabled: false
  max_plots: 1000
  interval_minutes: 60
  plots_per_run: 10
  last_generated_index: 0
  fast_mode: false

See Plot world setup.

Full configuration file

config-version: 9
language: en_US
plot_world: world
server_name: eclipseMc
prefix: "[&#a000ffS&#9100ffc&#8300ffa&#7500ffl&#6700ffa&#5800ffP&#4a00ffl&#3c00ffo&#2e00fft] | &#ffffff"

plot_size: 100
road_size: 2
road_material: SMOOTH_STONE_SLAB

claim_cost: 0
currency: €
succesfull_report_reward: 100

render:
  auto_start: false
  interval_minutes: 30

unused_plot_cache:
  enabled: false
  days_inactivity: 30
  check_interval_minutes: 60

premium_key:
download_premium_lib: true

webserver:
  enabled: true
  host: 0.0.0.0
  port: 8080

debug: false
enable_auto_update: true

max_ownable_plots: 5
max_ownable_plot_by_perm:
  enable: false
  default: 2
  vip: 5

backup:
  auto_backup: true
  interval_minutes: 60
  max_backups_per_plot: 5
  storage_path: "backups"
  backup_on_deletion: true

unwanted_interactions:
  trapdoor: true
  itemframe: true
  liquid_flow: true
  dispenser: true
  piston: true
  explosion: true

send_statistic: true

webhooks:
  claim_webhook_url: https://discord.com/api/webhooks/......
  report_webhook_url: https://discord.com/api/webhooks/......
  star_webhook_url: https://discord.com/api/webhooks/......

auto_generation:
  enabled: false
  max_plots: 1000
  interval_minutes: 60
  plots_per_run: 10
  last_generated_index: 0
  fast_mode: false