Configuration

Main Configuration (config.yml)

General Settings

license-key: "CODE"
date-format: "dd.MM.yyyy HH:mm:ss"
maximum-name-length: 20
blocked-plot-names:
  - "admin"
  - "moderator"
from-spawn-distance: 100
minimum-distance-between-plots: 122
flying-on-plots: false
flying-only-on-own-or-member-plots: true
member-invite-time-out: 5
teleport-time: 5
debug-mode: false
guest-protection: true
plots-overlapping-with-same-owner: false

Option	Type	Default	Description
`license-key`	String	`"CODE"`	Plugin license key
`date-format`	String	`"dd.MM.yyyy HH:mm:ss"`	Date format used throughout the plugin
`maximum-name-length`	Integer	`20`	Maximum allowed plot name length
`blocked-plot-names`	List	`["admin", "moderator"]`	Names that cannot be used for plots
`from-spawn-distance`	Integer	`100`	Minimum distance from world spawn to create a plot
`minimum-distance-between-plots`	Integer	`122`	Minimum distance between plot centers
`flying-on-plots`	Boolean	`false`	Allow flight on plot territories
`flying-only-on-own-or-member-plots`	Boolean	`true`	Restrict flying to own or member plots only
`member-invite-time-out`	Integer	`5`	Invitation expiration time in minutes
`teleport-time`	Integer	`5`	Teleport warmup time in seconds
`debug-mode`	Boolean	`false`	Enable debug logging
`guest-protection`	Boolean	`true`	Protect guests from damage on plots
`plots-overlapping-with-same-owner`	Boolean	`false`	Allow the same player’s plots to overlap

World Settings

ignore-spawn-location-worlds:
  - "world_nether"
disable-worlds:
  - "world_nether"
  - "world_the_end"
invert-disabled-worlds: false
ignore-world-guard-regions:
  - "plots_region"

Option	Type	Default	Description
`ignore-spawn-location-worlds`	List	`["world_nether"]`	Worlds where spawn distance check is skipped
`disable-worlds`	List	`["world_nether", "world_the_end"]`	Worlds where plots cannot be created
`invert-disabled-worlds`	Boolean	`false`	If `true`, only allow plots in listed worlds instead of blocking them
`ignore-world-guard-regions`	List	`["plots_region"]`	WorldGuard regions where plots cannot be created

Plot Defaults

defaults:
  default-plot-name: "Plot"
  default-size: 10
  default-slots: 5
  plot-home-icon: CAMPFIRE

Option	Type	Default	Description
`default-plot-name`	String	`"Plot"`	Default name for newly created plots
`default-size`	Integer	`10`	Initial plot radius (center to edge). Actual size = `2 * size + 1`
`default-slots`	Integer	`5`	Initial member slot limit
`plot-home-icon`	Material	`CAMPFIRE`	Default material icon for plot home

Tip: A default-size of 10 creates a 21x21 block plot (10 blocks in each direction from center, plus the center block).

Warps

plots-warps: true
plot-warp-price: 300.0

Option	Type	Default	Description
`plots-warps`	Boolean	`true`	Enable the plot warp system
`plot-warp-price`	Double	`300.0`	Cost to create a plot warp

Rating

broadcast-plots-ratings: true

Option	Type	Default	Description
`broadcast-plots-ratings`	Boolean	`true`	Broadcast plot rating changes to players

Economy

economy:
  enable: true
  economy-type: ITEMS
  cost-for-one-expiration-day: 100.0
  upgrading-members-slots: 1
  cost-for-one-members-slot-upgrade: 20.0
  upgrading-plot-size-blocks: 5
  cost-for-one-plot-size-upgrade: 50.0
  upgrade-multiple: 2

Option	Type	Default	Description
`enable`	Boolean	`true`	Enable the economy system
`economy-type`	Enum	`ITEMS`	Economy mode: `VAULT` or `ITEMS`
`cost-for-one-expiration-day`	Double	`100.0`	Cost to extend expiration by one day
`upgrading-members-slots`	Integer	`1`	Number of member slots added per upgrade
`cost-for-one-members-slot-upgrade`	Double	`20.0`	Base cost per member slot upgrade
`upgrading-plot-size-blocks`	Integer	`5`	Number of blocks added per size upgrade
`cost-for-one-plot-size-upgrade`	Double	`50.0`	Base cost per size upgrade
`upgrade-multiple`	Integer	`2`	Cost multiplier applied to each successive upgrade

Economy Types

Type	Description
`VAULT`	Uses any Vault-compatible economy plugin (EssentialsX, CMI, etc.)
`ITEMS`	Uses a configurable physical item as currency

Economy Item

When using ITEMS economy type, the currency item is configurable:

economy-item:
  material: EMERALD
  display-name: "&aCustom emerald"
  lore:
    - "&7This &eis &6custom &2emerald"

Tip: Economy items support custom model data for integration with Oraxen or Nexo.

Cost Multiplier

The upgrade-multiple option increases the cost for each successive upgrade. The formula is:

cost = baseCost * (multiplier ^ upgradeCount)

For example, with upgrade-multiple: 2 and cost-for-one-plot-size-upgrade: 50:

1st upgrade: 50
2nd upgrade: 100
3rd upgrade: 200
4th upgrade: 400

Expiration

expiration:
  enable: true
  default-expiration-hours: 48
  maximum-expiration-hours: 256
  broadcast-when-team-are-expired: true
  unit-type: DAYS

Option	Type	Default	Description
`enable`	Boolean	`true`	Enable the plot expiration system
`default-expiration-hours`	Integer	`48`	Default plot lifespan in hours
`maximum-expiration-hours`	Integer	`256`	Maximum plot lifespan in hours
`broadcast-when-team-are-expired`	Boolean	`true`	Broadcast a message when a plot expires
`unit-type`	Enum	`DAYS`	Display unit for expiration time

Unit Types

Unit	Description
`HOURS`	Display expiration in hours
`DAYS`	Display expiration in days
`WEEKS`	Display expiration in weeks
`MONTHS`	Display expiration in months

Limits

Plot, size, and member slot limits are assigned via permissions. Each entry maps a permission suffix to a limit value.

limits:
  plots-limit:
    default: 1
    vip: 4
    svip: 10
  size-limit:
    default: 20
    vip: 40
    svip: 60
  slots-limit:
    default: 5
    vip: 10
    svip: 15

The resulting permissions are:

Permission	Plots	Max Size	Member Slots
`plots.limit.default` / `plots.size.default` / `plots.slots.default`	1	20	5
`plots.limit.vip` / `plots.size.vip` / `plots.slots.vip`	4	40	10
`plots.limit.svip` / `plots.size.svip` / `plots.slots.svip`	10	60	15

Tip: The default permission entries are granted to all players by default. Add custom entries (e.g., mvp: 20) to create additional tiers — the corresponding permission would be plots.limit.mvp.

Hologram

Requires: A supported hologram plugin must be installed. minePlots integrates with DecentHolograms, FancyHolograms, and HolographicDisplays. Without one of these plugins, holograms will not appear even if enable: true.

hologram:
  enable: true
  added-y-block-from-center: 2.0
  line-height: 0.25
  lines:
    - "&a&lminePlots"
    - ""
    - "&7Plot name: &e{name}"
    - "&7Owner: &e{owner}"
    - ""
    - "&e&lCLICK TO OPEN PANEL"

Option	Type	Default	Description
`enable`	Boolean	`true`	Show an information hologram above each plot
`added-y-block-from-center`	Double	`2.0`	Height above the plot center where the hologram appears
`line-height`	Double	`0.25`	Vertical spacing between hologram lines
`lines`	List	see above	Hologram lines. Supports `{name}` and `{owner}` placeholders

Visualize

visualize:
  visualize-material: RED_CONCRETE
  visualize-particles:
    particle: FLAME
    dust-particles:
      red: 255
      green: 178
      blue: 45
      size: 1.0
  visualize-time: 60
  visualize-type: BLOCKS

Option	Type	Default	Description
`visualize-material`	Material	`RED_CONCRETE`	Block used to mark plot borders when `BLOCKS` mode is active
`visualize-particles.particle`	Particle	`FLAME`	Particle type used when `PARTICLES` mode is active
`visualize-particles.dust-particles`	Object	see above	Color and size for `DUST` particle type
`visualize-time`	Integer	`60`	How long (in seconds) the visualization is shown
`visualize-type`	Enum	`BLOCKS`	How to display plot borders: `BLOCKS` or `PARTICLES`

Plot Boss Bar

plot-boss-bar:
  enable: true
  own-plot-boss-bar:
    name: "&aYou are on your own plot of land! &8(&e{distance}m&8)"
    color: GREEN
    overlay: NOTCHED_20
  friendly-plot-boss-bar:
    name: "&6You are in a friendly plot of land! &8(&e{distance}m&8)"
    color: YELLOW
    overlay: NOTCHED_20
  enemy-plot-boss-bar:
    name: "&cYou are in a enemy plot! &8(&e{distance}m&8)"
    color: RED
    overlay: NOTCHED_20

Option	Type	Default	Description
`enable`	Boolean	`true`	Show a boss bar when a player enters a plot
`*.name`	String	see above	Boss bar message. Supports `{distance}` and `{plot}` placeholders
`*.color`	Enum	varies	Bar color: `GREEN`, `YELLOW`, `RED`, `BLUE`, `PURPLE`, `PINK`, `WHITE`
`*.overlay`	Enum	`NOTCHED_20`	Bar style: `PROGRESS`, `NOTCHED_6`, `NOTCHED_10`, `NOTCHED_12`, `NOTCHED_20`

Expiration Task

Controls renewal reminders sent to plot owners/members before their plot expires.

expiration-task:
  enabled: true
  min-plot-expire-time: 1
  min-plot-expire-time-unit: DAYS
  reminder-interval: 1
  reminder-interval-unit: HOURS
  remind-on-join: true
  notification-scope: MEMBERS_WITH_PERMISSION

Option	Type	Default	Description
`enabled`	Boolean	`true`	Enable expiration reminder notifications
`min-plot-expire-time`	Long	`1`	Start sending reminders when expiry is within this amount of time
`min-plot-expire-time-unit`	TimeUnit	`DAYS`	Unit for `min-plot-expire-time` (`DAYS`, `HOURS`, `MINUTES`, `SECONDS`)
`reminder-interval`	Integer	`1`	How often to repeat the reminder
`reminder-interval-unit`	TimeUnit	`HOURS`	Unit for `reminder-interval`
`remind-on-join`	Boolean	`true`	Send a reminder when the player joins the server
`notification-scope`	Enum	`MEMBERS_WITH_PERMISSION`	Who receives the reminder: `ALL_MEMBERS`, `ONLY_OWNER`, `MEMBERS_WITH_PERMISSION`

Crafting

Controls the crafting recipe for the plot creation block.

crafting-preset: false
default-crafting-recipe:
  shape:
    - "OOO"
    - "ODO"
    - "OOO"
  ingredients:
    O: OAK_LOG
    D: DIAMOND
vehicle-move-flag-enable: false
commands-invoked-when-plot-created:
  - "plot"

Option	Type	Default	Description
`crafting-preset`	Boolean	`false`	Enable preset-size crafting recipes (`preset-recipe-configurations`)
`default-crafting-recipe.shape`	List	see above	Crafting grid layout using ingredient characters
`default-crafting-recipe.ingredients`	Map	`O: OAK_LOG, D: DIAMOND`	Character-to-material mapping for the recipe
`vehicle-move-flag-enable`	Boolean	`false`	Enable tracking of vehicle movement through the `VEHICLE` flag
`commands-invoked-when-plot-created`	List	`["plot"]`	Commands auto-dispatched as the player when they create a plot

Squaremap Integration

If squaremap is installed, minePlots will render plot markers on the live map.

layer:
  marker-click-text: "Owner: {username}"
  marker-hover-text: "{name}"
  fill-settings:
    whether-is-visible: true
    color: "#326da8"
    weight: 1
    opacity: 0.5
  stroke-settings:
    whether-is-visible: true
    color: "#326da8"
    weight: 1
    opacity: 0.5
  marker-update-interval: 30

Option	Type	Default	Description
`marker-click-text`	String	`"Owner: {username}"`	Text shown in the popup when a marker is clicked. Supports `{username}`, `{name}`
`marker-hover-text`	String	`"{name}"`	Tooltip text on hover
`fill-settings.whether-is-visible`	Boolean	`true`	Show plot fill color
`fill-settings.color`	String	`"#326da8"`	Fill color (hex)
`fill-settings.weight`	Integer	`1`	Fill border weight
`fill-settings.opacity`	Double	`0.5`	Fill opacity (0.0–1.0)
`stroke-settings`	Object	same as fill	Border stroke settings (same fields as fill)
`marker-update-interval`	Integer	`30`	How often (in seconds) markers are refreshed on the map