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

1. Drop the jar into plugins/ and start the server once so the default config is written.
2. 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
   

3. 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

Links

• Source: https://github.com/Melocet/PlotMe
• Issues: https://github.com/Melocet/PlotMe/issues
• Releases: https://github.com/Melocet/PlotMe/releases