How to Configure PlotSquared on a Minecraft Server
Run creative or plot worlds with claiming, plot limits, trust rules, flags, setup commands, and WorldEdit-safe boundaries. This guide covers install order, first startup, LuckPerms permissions, config files, use-case presets, integrations, performance checks, common failures, and admin FAQ.
Audience
Creative server owners, build event admins, and networks with dedicated plot worlds.
Install Jar
PlotSquared jar for your supported platform and Minecraft version.
Tested Stack
Paper or Purpur 1.20.6 to 1.21.x, Java 21, LuckPerms for permissions, and a staging server before production changes.
What PlotSquared Does
PlotSquared should be treated as part of your server architecture, not as a random jar dropped into production. The safe workflow is to define the job the plugin owns, decide which groups can touch it, test the generated files on staging, then move only the reviewed configuration to the live server.
For PlotSquared, the main job is: Run creative or plot worlds with claiming, plot limits, trust rules, flags, setup commands, and WorldEdit-safe boundaries. That means every setting should support a concrete player workflow or staff workflow. If a setting does not have an owner, a test, and a rollback path, leave it at the generated default until you have a reason to change it.
The most common failure pattern is configuring the plugin as OP, seeing it work, and assuming players are ready. Operators bypass too much. For every section below, create a temporary non-OP account in the target LuckPerms group and test the exact command or interaction that normal players will use.
Keep a small audit note beside the config. Record the plugin version, the file paths changed, the exact permissions granted, the test account used, the commands verified, and the rollback file or database backup to restore. When another plugin depends on PlotSquared, repeat the same test after updates because the failing part may be the bridge, provider, world context, or display plugin rather than PlotSquared itself. Keep the note in your operations runbook.
Installation and First Startup
Back up the server before installing PlotSquared. At minimum, keep a copy of the existing plugins folder, the world data if the plugin touches worlds or claims, and any database used by related plugins. Upload PlotSquared jar for your supported platform and Minecraft version. into the plugins folder, then perform a full restart so Bukkit, Paper, or Purpur loads the plugin cleanly.
On first startup, do not edit every generated file immediately. Let the plugin create its folder, read the startup log, then run a small command or player action to prove the plugin is alive. The first goal is a known-good baseline. After that, make one config change at a time.
First startup checklist
- Run /plot plugin to verify the plugin loads.
- Create a test plot world with /plot setup on staging.
- Claim a plot as a non-OP player.
- Test trust, visit, delete, and home workflows.
LuckPerms Permission Setup
Configure PlotSquared permissions through groups. A clean setup usually has default, trusted, helper, moderator, admin, and owner groups. Default players get only the commands required for normal gameplay. Staff groups get narrow operational permissions. Owner keeps destructive, economy-changing, rollback, purge, import, or wildcard permissions.
Use this pattern for every permission below. Replace the group and permission with the row you are granting. Run the command from console or as an owner, then test with a non-OP player in that group.
/lp group <group> permission set <permission> true
/lp group <group> permission check <permission>
/lp user <player> parent add <group>plots.useGrant to default: Allows basic plot command help and use.
plots.claimGrant to default: Allows players to claim plots.
plots.plot.1Grant to default: Limits default players to one plot.
plots.autoGrant to default: Allows automatic plot claiming.
plots.adminGrant to owner: Administrative override.
Command Workflows
Commands are not just a reference list. They are the operational workflows your staff will use under pressure. Write the exact command patterns into your runbook and include which group may run each one. For sensitive commands, test with a preview, a limited radius, a staging world, or a throwaway account before using them live.
/plot setupStart the setup wizard for a plot world.
/plot autoAutomatically claim an available plot.
/plot claimClaim the current plot.
/plot homeReturn to your plot.
/plot trust <player>Allow a trusted builder broader plot access.
/plot set <flag> <value>Set supported plot options.
/plot mergeMerge adjacent plots where allowed.
Config File Deep Dive
The config files below are the parts of PlotSquared most likely to matter on a real server. Do not copy a random full config from another network. Generated files change between plugin versions, and old examples can silently disable modern safeguards. Keep the generated comments, change only the setting you understand, then reload or restart using the plugin-specific path.
For every setting, write down the old value, the new value, why it changed, and how to back out. This is slower than editing blindly, but it prevents mystery behavior three weeks later when another admin tries to debug the server.
worlds.yml
plugins/PlotSquared/config/worlds.yml
Stores plot world settings, economy options, plot sizes, roads, and flags depending on version.
Recommendation: Generate through setup, then edit with backups.
settings.yml
plugins/PlotSquared/config/settings.yml
Global PlotSquared behavior.
Recommendation: Keep global changes minimal until the first world works.
plots.plot.<amount>
LuckPerms
Dynamic permission that limits plot count.
Recommendation: Set clear plot limits by rank.
Economy options
worlds.yml
Can require money for claim, merge, buy, or sell depending on setup.
Recommendation: Enable only after Vault economy is working.
WorldEdit safety
PlotSquared and WorldEdit integration
PlotSquared can help keep edits inside owned plots when correctly configured.
Recommendation: Test WorldEdit permissions with non-OP builders before launch.
Use-Case Configs
A good PlotSquared setup depends on the type of server. Survival wants stability and player trust. Creative wants build speed and plot safety. Skyblock and economy modes care about item generation and abuse loops. Use these presets as decision checklists, then convert them into exact config changes for your own server.
Creative plot world
Players claim one or more plots and build independently.
- Create plot world.
- Grant use, auto, claim, and plot limit.
- Set creative gamemode.
- Test plot home.
- Protect road and spawn.
Build competition
Use plots for entries and judging.
- Create event world.
- Set equal plot limits.
- Disable merge if needed.
- Add judge permissions.
- Archive winners.
Ranked plot limits
Higher ranks can own more plots.
- Grant plots.plot.1 to default.
- Grant higher limits to donors or builders.
- Document merge rules.
- Audit abandoned plots.
Plugin Integrations
Most Minecraft plugin problems happen at the boundary between plugins. PlotSquared may load correctly while the full workflow still fails because a dependency, bridge, economy provider, permission group, display plugin, or world manager is missing. Check integrations during startup and after every plugin update.
WorldEdit
Common creative world dependency for builders.
LuckPerms
Controls plot limits, claim access, and admin overrides.
Vault
Required if you enable economy features.
Multiverse-Core
Useful for managing dedicated plot worlds alongside survival worlds.
Performance and Maintenance
Performance tuning starts with scope. Do not enable every module, world, render, placeholder, command, or log type just because the plugin supports it. Enable the parts that support your server design, measure the impact, and keep a short maintenance checklist for future updates.
- Pregenerate or pre-create plot worlds before public launch.
- Limit WorldEdit brush and large operation permissions.
- Keep plot limits aligned with disk and render budgets.
- Archive or prune abandoned plots by a published policy.
Common Errors and Fixes
When PlotSquared misbehaves, separate facts from guesses. Capture the command used, player group, world, plugin version, and console output. Then work through the smallest reproducible test instead of changing five settings at once.
Players cannot claim plots
- plots.claim permission.
- plots.plot.<amount> limit.
- World is a plot world.
- Plot is not already owned.
Fix: Grant claim and plot limit permissions, then test /plot auto.
Players can build outside plots
- They are OP.
- Admin bypass permissions.
- WorldEdit bypass.
- World setup is correct.
Fix: Remove bypasses from default groups and test as non-OP.
Plot world setup fails
- Generator dependencies.
- World name conflict.
- Disk space.
- Console setup errors.
Fix: Run setup on staging and remove failed test worlds only after backup and approval.
PlotSquared FAQ
Should I configure PlotSquared on a live production server?
Use a staging copy for the first setup, then move the finished configuration to production during a quiet period. PlotSquared may read files, register commands, or touch player data during startup, so testing on a copy prevents avoidable downtime.
Can I use /reload after changing PlotSquared?
Avoid the global /reload command. Use /plot reload if supported, otherwise a restart when the plugin supports it, or schedule a normal restart when the change affects dependencies, database settings, worlds, generated regions, or plugin jars.
Where should I keep backups before changing PlotSquared?
Back up the plugin data folder, the jar you are replacing, and any database tables used by the plugin. Keep the backup outside the live plugins folder so a later cleanup or plugin scan cannot accidentally load it.
How should I grant permissions for PlotSquared?
Grant permissions to LuckPerms groups, not individual players. Use a small default group, a trusted staff group, and an owner group. Temporary exceptions should use LuckPerms temporary permissions with a clear expiration.
Why does PlotSquared work for operators but not normal players?
Operators bypass many checks, so OP testing is not enough. Test with a non-OP account in the default group and watch the console for missing permission messages or plugin-specific deny output.
How do I know whether PlotSquared loaded correctly?
Check the startup log for the plugin name, run the main info command, confirm the data folder was created, and test one normal player workflow. Do not assume the plugin is ready just because it appears in /plugins.
Should I edit generated config files by hand?
Yes, but keep comments, indentation, and encoding intact. YAML and HOCON are strict enough that one bad indent or missing quote can stop a plugin from loading its configuration.
How often should I review PlotSquared settings?
Review the config after major Minecraft updates, plugin major releases, and changes to your server mode. Survival, skyblock, creative, and proxy networks usually need different defaults.
What is the safest way to update PlotSquared?
Read the changelog, back up the existing jar and data folder, test the new version on staging, then replace the jar during a normal restart. Do not hot swap core plugins that hold data or hook deeply into server internals.
How do I document the final PlotSquared setup?
Write down the plugin version, config files changed, permissions granted, commands staff use, and rollback steps. Store that note beside your server runbook so another admin can recover the setup later.
Official References
Check the upstream documentation before changing version-specific settings. This tutorial avoids full copied configs because plugin defaults and generated comments can change between releases.