PlotMe(现代化分支)
这是 WorldCretornica/PlotMe-Core 的一个维护性分支,已移植至 Paper 1.21+ 和 Java 21。原版项目已于 2020 年 3 月由所有者归档。
功能特性
- 完整保留了上游的
/plotme 命令集(claim、auto、home、info、biome、trust、like、clear、list、buy、sell、dispose、done、deny、reset、middle、admin tools),全部可用。
- 通过
/plotme menu 提供基于 Chest-GUI 的菜单,并内置了生物群系页面。
- 支持手动合并地块,可配置集群上限(
merge-max,默认值为 4)以及权限层级(plotme.merge.limit.4 / 6 / 9 / 16 / *)。
/plotme dispose 会逐块重建道路网格,包括交叉口的金条装饰,与原始区块生成器完全一致。
- 单个地块的标志系统(
/plotme flag <name> [value])。
- 为 BlueMap 和 squaremap 提供 Web 地图标记。采用外观模式(Facade pattern),使得未安装这些地图插件的服务端在启动时不再出现
NoClassDefFoundError。
- 带有
[PlotMe] 前缀的彩色聊天。可通过设置 use-legacy-texts: true 启用纯文本模式。
- 已认领和合并的地块使用彩色的冒险风格告示牌(金色粗体标题、青色拥有者名称、黄色地块 ID)。
- 权限树(
plotme.use.*、plotme.admin.*、plotme.limit.*、plotme.merge.limit.*)在与上游重叠的部分保持不变。
- 内置地块世界生成器:可配置地块大小、路径宽度、道路方块、墙壁方块、地块地板和填充方块。
- 在地块边界处对拥有者/出售中/受保护墙壁进行重新着色。
- bStats 指标统计(已重定位,无命名空间冲突)。
安装设置
- 将 jar 文件放入
plugins/ 目录,然后启动一次服务器以写入默认配置文件。
- 创建地块世界。如果使用 Multiverse-Core:
/mv create plots normal -g PlotMe
如果不使用 Multiverse,请在 bukkit.yml 的 worlds: 下添加以下内容:
worlds:
plots:
generator: PlotMe
- 传送进去并执行
/plotme claim。
worlds.<world> 中的方块键值接受现代 Material 名称(如 OAK_PLANKS、QUARTZ_SLAB)或旧版 <id>[:<data>] 格式(如 5、44:7),因此旧的 PlotMe 配置文件无需修改即可迁移。
关键配置项
use-legacy-texts: false。设置为 true 以启用纯 ASCII 文本聊天。
merge-enabled: true。/plotme merge 的主开关。
merge-max: 4。集群上限。各层级的权限可为每个玩家覆盖此限制。
mergeCost: 100.0。当启用经济系统时,每次合并所需的 Vault 价格。
webmap.bluemap / webmap.squaremap。独立切换标记显示。marker-color 为十六进制 RGB 填充色。
兼容性
- 服务端:Paper 1.21.4+(需使用现代化的 ChunkGenerator API。旧版服务端无法加载它。)
- Java:21
- 可选集成(软依赖):
- Vault:用于认领/清除/生物群系/家园/出售定价
- WorldEdit 7:用于 WE-anywhere 权限和单地块编辑保护
- BlueMap:用于在 BlueMap 前端显示 Web 地图标记
- squaremap:用于在 squaremap 前端显示 Web 地图标记
- Multiverse-Core:用于便捷创建地块世界
与上游版本的变更
- Java 版本从 1.7 升级至 21,Bukkit 1.8 升级至 Paper 1.21.4 API,WorldEdit 从 6 升级至 7
- McStats 升级至 bStats 3.0.2(已阴影处理 + 重定位)
- 移除了 Sponge 平台、LWC 集成以及 1.13 之前的蓝图引擎(约 2,500 行废弃代码)
- 合并了 PlotMe-DefaultGenerator。无需额外的配套插件。
- 基于 Paper 1.21 的
generateNoise(WorldInfo, Random, int, int, ChunkData) API 重写了 ChunkGenerator
- 地块清理不再依赖
World#regenerateChunk(该接口在 Paper 1.21 中被存根化并抛出异常)。改为直接重置地块内部。
- 命令在正确的线程上运行。解决了异步传送、Player.remove 等问题。
- 修复了东部/南部地块边缘的地块 ID 偏移一位的问题。旧公式在
X = plotSize - 1 时会返回下一个图块的 ID。
- 禁用认领时的自动链接。现在合并是一个手动决策。
- 将 BlueMap 和 squaremap 的钩子拆分为 Facade 和 Impl 类,以便 JVM 在启动时不链接软依赖类。
致谢
原作者:ZachBora、MattBDev 以及 WorldCretornica PlotMe 团队的其他成员。本分支仅对其工作进行移植更新。设计理念和命令界面均属于他们。
许可证
GPL-3.0-only
链接
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
Links
- Source:
- Issues:
- Releases:
评论 0
登录后参与评分
还没有评论,来抢沙发吧