PlotMe (modernized fork)

A maintenance fork of WorldCretornica/PlotMe-Core, brought forward to Paper 1.21+ and Java 21. The original project was archived by its owner in March 2020.

Features

Full /plotme command set from upstream (claim, auto, home, info, biome, trust, like, clear, list, buy, sell, dispose, done, deny, reset, middle, admin tools), all preserved.
Chest-GUI menu via /plotme menu with a built-in Biome page.
Manual plot merging with a configurable cluster cap (merge-max, default 4) and permission tiers (plotme.merge.limit.4 / 6 / 9 / 16 / *).
/plotme dispose rebuilds the road grid block-for-block, exact chunk-generator parity including gold inlays at intersections.
Per-plot flag system (/plotme flag <name> [value]).
Web-map markers for BlueMap and squaremap. Facade pattern means servers without either map plugin no longer hit a NoClassDefFoundError on startup.
Colorized chat with a [PlotMe] prefix. Plain-text mode via use-legacy-texts: true.
Colored Adventure signs for claimed and merged plots (gold bold header, aqua owner, yellow plot id).
Permission tree (plotme.use.*, plotme.admin.*, plotme.limit.*, plotme.merge.limit.*) unchanged from upstream where it overlaps.
Built-in plot-world generator: configurable plot size, path width, road blocks, wall blocks, plot floor, fill block.
Owner / for-sale / protected wall recoloring on the plot border.
bStats metrics (relocated, no namespace clashes).

Setup

Drop the jar into plugins/ and start the server once so the default config is written.
Create a plot world. With Multiverse-Core:
```
/mv create plots normal -g PlotMe
```
Without Multiverse, add it under worlds: in bukkit.yml:
```
worlds:
  plots:
    generator: PlotMe
```
Teleport in and /plotme claim.

Block keys in worlds.<world> accept either modern Material names (OAK_PLANKS, QUARTZ_SLAB) or the legacy <id>[:<data>] form (5, 44:7), so old PlotMe configs migrate without edits.

Key config flags

use-legacy-texts: false. Set to true for plain ascii chat.
merge-enabled: true. Master switch for /plotme merge.
merge-max: 4. Cluster cap. Tier permissions override per player.
mergeCost: 100.0. Vault price per merge when economy is enabled.
webmap.bluemap / webmap.squaremap. Toggle markers independently. marker-color is the hex RGB fill.

Compatibility

Server: Paper 1.21.4+ (the modern ChunkGenerator API. Older servers won't load it.)
Java: 21
Optional integrations (soft-deps):
- Vault for claim/clear/biome/home/sell pricing
- WorldEdit 7 for WE-anywhere permission and per-plot edit guard
- BlueMap for web-map markers on the BlueMap frontend
- squaremap for web-map markers on the squaremap frontend
- Multiverse-Core for easy plot-world creation

What changed vs upstream

Java 1.7 to 21, Bukkit 1.8 to Paper 1.21.4 API, WorldEdit 6 to 7
McStats to bStats 3.0.2 (shaded + relocated)
Sponge platform, LWC integration, and the pre-1.13 schematic engine removed (~2,500 lines of dead code)
PlotMe-DefaultGenerator merged in. No separate companion plugin needed.
ChunkGenerator rewritten on Paper 1.21's generateNoise(WorldInfo, Random, int, int, ChunkData) API
Plot clear no longer relies on World#regenerateChunk (which Paper 1.21 stubbed to throw). It resets the plot interior directly.
Commands run on the right threads. Async teleport, Player.remove, etc. all addressed.
Plot id off-by-one at eastern/southern plot edges fixed. The old formula returned the next tile's id at X = plotSize - 1.
Auto-link on claim disabled. Merging is a manual decision now.
BlueMap and squaremap hooks split into facade + Impl classes so the JVM doesn't link softdep classes at startup.

Credits

Original authors: ZachBora, MattBDev, and the rest of the WorldCretornica PlotMe team. This fork only ports their work forward. The design and command surface are theirs.

License

GPL-3.0-only

PlotMe

📖About PlotMe