Getting Started

Overview

minePlots is a comprehensive plot management plugin for Paper 1.17+ servers. It allows players to create, manage, and customize personal territories with full member management, economy integration, biome customization, and an intuitive GUI-based interface. Supports Folia.

Features

• Plot System — create and manage personal territories using craftable plot blocks
• Member Management — invite players, assign granular permissions, ban/unban members
• Economy Integration — Vault or item-based economy with upgrade costs and multipliers
• Biome Customization — change plot biomes with configurable pricing
• Plot Warps — create named teleport points within plots
• Expiration System — configurable plot lifespan with renewal options
• Ranking System — block-based ranking points with leaderboards
• Rating System — players can rate plots (1-5 stars)
• GUI Dashboard — full inventory-based management interface
• Border Visualization — particle or block-based plot border display
• Holograms — display plot information above the center block
• Boss Bars — show plot info when entering territories
• PlaceholderAPI — extensive placeholder support
• Multiple Databases — YAML, H2, MySQL, or MongoDB backends

Requirements

• Java 17+
• Paper 1.17+

Optional

• PlaceholderAPI
• Vault (for Vault economy mode)
• WorldGuard (region integration)
• DecentHolograms / FancyHolograms / HolographicDisplays (hologram support)
• Oraxen / Nexo (custom economy items)

Installation

1. Download the latest minePlots-*-spigot.jar file
2. Place it in your server’s plugins/ folder
3. Start or restart the server
4. Edit the generated configuration files in plugins/minePlots/
5. Run /plotsadmin reload to apply changes

Configuration Files

After first startup, the following files are generated in plugins/minePlots/:

File	Description
config.yml	Main plugin configuration (economy, database, expiration, limits, flags, biomes)
commands.yml	Command aliases and settings
messages.yml	All plugin messages with MiniMessage formatting
biomes.yml	Available biomes and pricing
flags.yml	Plot flag definitions and settings
views/*.yml	GUI layout configurations for all interfaces

Quick Setup

Single Server (YAML)

No additional configuration is required. The plugin uses local YAML file storage by default.

Production (MySQL)

database:
  database-type: MYSQL
  hostname: "localhost"
  base: "mineplots"
  port: 3306
  username: "root"
  password: "securepass"