Simplex Trimmer
安全、聚焦的 Paper 服务器世界修剪 —— 支持 Java 菜单、可选 Bedrock 表单及仅启动时维护
Simplex Trimmer 12.1.2 是一款独立的 Paper 服务器世界维护插件。它允许管理员选择单个维度,设定 InhabitedTime(居住时间)阈值,安排维护倒计时,在下次完整服务器启动时运行 MCA Selector,并在事后查看回收了多少磁盘空间。
无需 SimplexAdminSuite 依赖。无内置遥测数据。包含 Java 库存菜单。通过 Floodgate 提供可选的原生 Bedrock 表单。
⚠️ 此插件会永久删除选定的区块数据。修剪前请务必创建完整且可用的备份。
?️ 仅启动时修剪
SimplexTrimmer 12 用更安全的启动工作流程取代了旧有的实时世界维护方法:
- 打开
/trimworld 并选择要处理的维度。
- 选择活动阈值和维护倒计时。
- 确认已拥有完整备份。
- SimplexTrimmer 存储一次性维护任务。
- 插件请求正常停止/重启服务器。
- 在下一次完整启动时,排队的修剪将在 正常世界加载继续之前 运行。
- MCA Selector 本地处理选定的目标。
- 维护完成后,正常启动流程继续,结果写入历史记录。
默认的 STOP 模式旨在用于托管面板。您的面板必须在关闭后重新启动服务器。可选的 RESTART 模式将委托给 Spigot 配置的重启机制。
如果 Bukkit 未在配置的超时时间内开始正常关闭,SimplexTrimmer 会打印清晰的 SERVER STOP REQUIRED 消息,以便您知道需要手动停止服务器。排队任务仍会保存以供下次完整启动使用。
? 实时 MCA Selector 控制台进度
在启动时修剪期间,SimplexTrimmer 捕获 MCA Selector 的终端进度,并将其转换为清晰英文格式的控制台消息。
进度行可能包括:
- 当前世界或维度
- 完成百分比
- 当前/最大区域计数器(如有)
- 当前
.mca 区域文件(如有)
- 目标完成后回收的磁盘空间
- 已用时间
示例:
[MCA Selector 1/3] world | 12% | 24/200 regions | r.-3.2.mca
[MCA Selector 1/3] world | 42% | 84/200 regions | r.-2.5.mca
[MCA Selector 1/3] world | 100% | 200/200 regions | r.4.3.mca
[Trim 1/3] Completed | world | Reclaimed: 6.81 GiB | Elapsed: 2m 14s
重复的终端重绘会被抑制,以保持控制台的可读性。完整的原始 MCA Selector 输出 仍存储在 plugins/SimplexTrimmer/data-v12/logs/ 中,以便故障排除。
✨ 功能特性
- 独立插件: 专注于世界修剪和维护。
- 英文界面: Java 菜单、Bedrock 表单、命令反馈、控制台消息、默认维护消息和文档均为英文。
- Java 库存 GUI: 无需手动编辑文件,即可配置目标、阈值、倒计时、确认和历史记录。
- 可选 Bedrock GUI: 为 Bedrock 玩家提供原生 Floodgate/Cumulus 表单;纯 Java 服务器无需安装 Floodgate。
- 按维度定位: Overworld、Nether、End 以及发现的自定义维度可单独选择。
- 经典与现代世界发现: 支持经典的
region、DIM-1、DIM1、分离的 Bukkit 世界以及命名空间的 dimensions/<namespace>/<dimension> 布局。
- 显式 MCA Selector 路径: 当可用时,地形、POI 和实体目录分别提供。
- 更安全的路径处理: 自动发现拒绝不安全的符号链接目标,并跳过常见的备份/存档位置。
- 附加世界根目录: 使用
world-trimmer.additional-world-roots 显式添加离线/自定义根目录。
- 持久的管理员会话: 选定的维度和设置在日常使用中得以保留。
- 持久的维护任务: 排队和归档的任务存储在
data-v12/ 下。
- 恢复模式: 失败/中断的任务需要管理员审查,而不是被视为成功。
- 历史记录: 保留前后大小、回收空间、状态和每个目标的信息。
- 世界锁定: 防止对真正被其他进程锁定的世界进行破坏性处理。
- 进程监控: 外部守卫监控 MCA Selector 子进程,并防止重复的修剪器守卫。
- 预检验证: 在维护开始前检查目标、MCA Selector 状态、Java 兼容性和可用磁盘空间。
- 经过验证的 MCA Selector 更新器: 从官方
Querz/mcaselector GitHub 发布版下载,并在安装前验证发布的 SHA-256 摘要。
- 可配置的性能: 专用的 MCA Selector 堆内存、进程线程上限和超时时间。
- 倒计时控制: 立即、1分钟、3分钟和5分钟启动,带有公开警告、标题、声音和取消功能。
- 无内置遥测数据: 无 bStats 模块、Discord 集成或世界上传服务。
? Java + Bedrock 管理
Java 玩家自动使用库存界面。
当安装了 Floodgate 且 Floodgate 玩家打开 SimplexTrimmer 时,插件可以使用原生的 Bedrock 表单来进行以下操作:
- 维度选择
- 阈值/设置控制
- 备份确认
- 维护开始确认
- 历史记录
- 倒计时取消
- 恢复操作
Geyser/Floodgate 必须单独安装和配置。SimplexTrimmer 不捆绑这两个项目中的任何一个。
⏱️ 活动阈值
SimplexTrimmer 基于 Minecraft 累积的 InhabitedTime 值来移除区块。
| 预设 |
刻 (Ticks) |
备注 |
| 30 秒 |
600 |
最低预设,但仍具有潜在破坏性 |
| 1 分钟 |
1,200 |
更多区块符合条件 |
| 3 分钟 |
3,600 |
激进 |
| 5 分钟 |
6,000 |
非常激进 |
| 10 分钟 |
12,000 |
极度激进 |
可使用以下方式自定义数值:
/trimworld ticks <20-1728000>
过滤条件为严格模式:
InhabitedTime < 阈值
InhabitedTime 恰好等于配置阈值的区块将被保留。
InhabitedTime 并非建筑或领地检测器。很少访问的基地、粘贴的结构、领地、出生点区域或新建的位置仍可能具有较低的值。
? 命令
| 命令 |
用途 |
/trimworld |
打开自动 Java/Bedrock 菜单 |
/trimworld java |
强制使用 Java 库存菜单 |
/trimworld scan |
刷新已发现的维度及大小 |
/trimworld update |
下载并验证最新支持的官方 MCA Selector 版本 |
/trimworld ticks <20-1728000> |
设置自定义活跃度阈值 |
/trimworld clear |
清除已选中的维度 |
/trimworld history |
打开保存的修剪历史记录 |
/trimworld status |
显示当前维护状态;支持控制台输出 |
/trimworld cancel |
取消正在进行的维护倒计时 |
/trimworld recovery CONFIRM |
经人工检查后解除恢复模式 |
/trimworld reload |
在空闲时重新加载配置 |
权限: trimmer.admin — 默认为 OP(管理员)。
别名: /simplextrimmer, /strimmer
? 安全与恢复
SimplexTrimmer 在启动维护期间会使用世界/会话锁。Paper 可能在早期启动阶段于同一 JVM 内持有世界的 session.lock;当前版本能正确识别这种受保护的同进程状态,同时仍会拒绝由其他进程拥有的锁。
如果修剪在破坏性工作可能已开始之后被中断或失败,SimplexTrimmer 将进入恢复模式。普通玩家将被阻止操作,直到管理员审查任务。
没有自动回滚。始终检查原始日志,并在必要时在解除恢复模式之前还原备份。
唯一的自动重试例外是 SimplexTrimmer 12.1.0 产生的特定预检仅 session.lock 失败,且前提是没有任何修剪目标已开始处理。
⚠️ 修剪前必读
- 每次修剪前请进行完整备份。
- SimplexTrimmer 确认你声明存在备份;它不会创建或验证该备份。
- 在破坏性处理活动期间,请勿强制停止服务器或 MCA Selector。
- 如果运行失败,之前的维度可能已被修改。
- 被删除的区块在玩家再次访问时可能会重新生成。
- 在 Minecraft 更新、数据包更改或生成器更改后,重新生成的地形可能会有所不同。
- 没有自动的 Lands、WorldGuard、GriefPrevention、领地、出生点或建筑保护机制。
- 磁盘空间的节省完全取决于你的世界和所选阈值。不保证任何百分比。
✅ 要求与兼容性
- 服务器: Paper 或带有所需 Bukkit/Paper API 的兼容 Paper 衍生服务器。
- MCA Selector: 当前工作流需要 2.9 或更高版本。
- MCA Selector 2.9 所需的 Java: Java 21 或更高版本。
- 插件字节码: 目标 Java 17;你的 Minecraft/Paper 服务器可能需要更新的 Java 版本,以其为准。
- Floodgate: 可选;仅用于原生 Bedrock 表单时需要。
- Geyser: 可选,当 Bedrock 玩家连接到 Java 服务器时需单独安装。
不支持作为修剪目标的平台:
- Folia
- Fabric
- Forge
- 仅代理环境
- 原生 Bedrock LevelDB 世界
通过 Geyser/Floodgate 使用 Java Paper 服务器 支持 Bedrock 玩家;SimplexTrimmer 不会编辑原生 Bedrock 世界数据库。
? 快速开始
- 停止服务器并创建完整备份。
- 移除旧版 SimplexTrimmer JAR 文件。
- 安装
SimplexTrimmer-12.1.2.jar。
- 正常启动服务器。
- 以 OP 身份或使用
trimmer.admin 权限运行 /trimworld。
- 使用 Update MCA Selector 安装/验证官方工具。
- 选择要处理的维度。
- 选择
InhabitedTime 阈值和倒计时。
- 确认你的备份存在。
- 开始维护。
- 允许服务器正常停止。
- 让托管面板/重启脚本重新启动它,或在需要时手动启动。
- 在启动期间观察服务器控制台中实时的修剪进度。
- 在 SimplexTrimmer 历史记录中查看最终结果。
不要使用 /reload 来替代完整的维护重启。
? 配置与数据
版本 12 的操作数据存储于:
plugins/SimplexTrimmer/data-v12/
其中包括 MCA Selector 工具状态、排队/归档的任务、日志、历史记录、会话和运行时状态。
现有的 v11 状态不会自动迁移到 data-v12/ 中。Bukkit 在更新插件时会保留现有的 config.yml,因此新引入的选项在未添加到配置文件之前将使用其内置默认值。
有用的配置选项包括:
world-trimmer:
restart-mode: STOP
shutdown-warning-seconds: 30
default-threshold-ticks: 600
minimum-threshold-ticks: 20
history-limit: 100
additional-world-roots: []
performance:
heap: 2G
process-threads: 2
timeout-minutes: 120
preflight:
minimum-free-space-gib: 2
? 从 SimplexTrimmer 11.x 升级
提供的遗留 11.0-ULTIMATE 构建使用了不同的工作流程:它在服务器仍在运行时进入维护状态,踢出玩家,禁用自动保存,保存/卸载区块,执行 MCA Selector,然后尝试重启服务器。
版本 12.1.2 有意用以下设计取代了该方案:排队、仅启动时处理、持久化任务状态、更强的路径/锁验证、恢复处理以及监督式外部 MCA Selector 进程。
升级时:
- 移除旧 JAR 文件。
- 保留你的备份。
- 不要将旧的运行时/状态文件复制到
data-v12/ 中。
- 通过新界面重新安装/更新 MCA Selector。
- 如果你还使用包含自身修剪模块的 SimplexAdminSuite 构建,请禁用其中的重复修剪模块。
致谢与外部工具
世界编辑由 MCA Selector 在本地完成,该项目由 Querz 及其贡献者开发:
MCA Selector 需从其官方 GitHub 发布页面单独下载,并未打包进 SimplexTrimmer。
你的 Minecraft 世界数据会在你的服务器上进行本地处理,SimplexTrimmer 不会将其上传至任何外部修剪服务。
Simplex Trimmer
Safe, focused world trimming for Paper — with Java menus, optional Bedrock forms and startup-only maintenance
Simplex Trimmer 12.1.2 is a standalone world-maintenance plugin for Paper servers. It lets administrators select individual dimensions, choose an InhabitedTime threshold, schedule a maintenance countdown, run MCA Selector during the next full server startup, and review how much disk space was reclaimed afterward.
No SimplexAdminSuite dependency. No built-in telemetry. Java inventory menus included. Optional native Bedrock forms through Floodgate.
⚠️ This plugin permanently deletes selected chunk data. Always create a complete, usable backup before trimming.
?️ Startup-only trimming
SimplexTrimmer 12 replaces the old live-world maintenance approach with a safer startup workflow:
- Open
/trimworld and select the dimensions you want to process.
- Choose an activity threshold and maintenance countdown.
- Confirm that you already have a complete backup.
- SimplexTrimmer stores a one-shot maintenance job.
- The plugin requests a normal server stop/restart.
- On the next full startup, the queued trim runs before normal world loading continues.
- MCA Selector processes the selected targets locally.
- When maintenance finishes, normal startup continues and the result is written to history.
The default STOP mode is intended for hosting panels. Your panel must start the server again after shutdown. Optional RESTART mode delegates to Spigot's configured restart mechanism.
If Bukkit does not begin a normal shutdown within the configured timeout, SimplexTrimmer prints a clear SERVER STOP REQUIRED message so you know to stop the server manually. The queued job remains saved for the next full startup.
? Live MCA Selector console progress
During startup trimming, SimplexTrimmer captures MCA Selector's terminal progress and converts it into clean English server-console messages.
Progress lines can include:
- Active world or dimension
- Percentage complete
- Current/maximum region counter when available
- Current
.mca region file when available
- Reclaimed disk space after a target finishes
- Elapsed time
Example:
[MCA Selector 1/3] world | 12% | 24/200 regions | r.-3.2.mca
[MCA Selector 1/3] world | 42% | 84/200 regions | r.-2.5.mca
[MCA Selector 1/3] world | 100% | 200/200 regions | r.4.3.mca
[Trim 1/3] Completed | world | Reclaimed: 6.81 GiB | Elapsed: 2m 14s
Repeated terminal redraws are suppressed so your console stays readable. The full raw MCA Selector output is still stored in plugins/SimplexTrimmer/data-v12/logs/ for troubleshooting.
✨ Features
- Standalone plugin: focused only on world trimming and maintenance.
- English interface: Java menus, Bedrock forms, command feedback, console messages, default maintenance messages and documentation are all English.
- Java inventory GUI: configure targets, thresholds, countdowns, confirmations and history without editing files manually.
- Optional Bedrock GUI: native Floodgate/Cumulus forms for Bedrock players; Floodgate is not required for Java-only servers.
- Per-dimension targeting: Overworld, Nether, End and discovered custom dimensions can be selected separately.
- Legacy + modern world discovery: supports classic
region, DIM-1, DIM1, split Bukkit worlds and namespaced dimensions/<namespace>/<dimension> layouts.
- Explicit MCA Selector paths: terrain, POI and entity directories are supplied separately when available.
- Safer path handling: automatic discovery rejects unsafe symbolic-link targets and skips common backup/archive locations.
- Additional world roots: explicitly add offline/custom roots with
world-trimmer.additional-world-roots.
- Persistent administrator sessions: selected dimensions and settings survive normal usage.
- Persistent maintenance jobs: queued and archived jobs are stored under
data-v12/.
- Recovery mode: failed/interrupted jobs require administrator review instead of being treated as successful.
- History: keeps before/after sizes, reclaimed space, status and per-target information.
- World locking: prevents destructive processing of worlds that are genuinely locked by another process.
- Process supervision: an external guard supervises the MCA Selector child process and prevents duplicate trimmer guards.
- Preflight validation: checks targets, MCA Selector state, Java compatibility and available disk space before maintenance begins.
- Verified MCA Selector updater: downloads from the official
Querz/mcaselector GitHub release and verifies the published SHA-256 digest before installation.
- Configurable performance: dedicated MCA Selector heap, process-thread cap and timeout.
- Countdown controls: immediate, 1-minute, 3-minute and 5-minute starts with public warnings, titles, sounds and cancellation.
- No built-in telemetry: no bStats module, Discord integration or world upload service.
? Java + Bedrock administration
Java players use the inventory interface automatically.
When Floodgate is installed and a Floodgate player opens SimplexTrimmer, the plugin can use native Bedrock forms for:
- Dimension selection
- Threshold/settings controls
- Backup confirmation
- Maintenance start confirmation
- History
- Countdown cancellation
- Recovery actions
Geyser/Floodgate must be installed and configured separately. SimplexTrimmer does not bundle either project.
⏱️ Activity thresholds
SimplexTrimmer removes chunks based on Minecraft's accumulated InhabitedTime value.
| Preset |
Ticks |
Notes |
| 30 seconds |
600 |
Lowest preset, still potentially destructive |
| 1 minute |
1,200 |
More chunks become eligible |
| 3 minutes |
3,600 |
Aggressive |
| 5 minutes |
6,000 |
Very aggressive |
| 10 minutes |
12,000 |
Extremely aggressive |
Custom values are available with:
/trimworld ticks <20-1728000>
The filter is strictly:
InhabitedTime < threshold
Chunks with InhabitedTime exactly equal to the configured threshold are retained.
InhabitedTime is not a building or claim detector. A rarely visited base, pasted structure, claim, spawn area or newly built location can still have a low value.
? Commands
| Command |
Purpose |
/trimworld |
Open the automatic Java/Bedrock menu |
/trimworld java |
Force the Java inventory menu |
/trimworld scan |
Refresh discovered dimensions and sizes |
/trimworld update |
Download and verify the latest supported official MCA Selector release |
/trimworld ticks <20-1728000> |
Set a custom activity threshold |
/trimworld clear |
Clear your selected dimensions |
/trimworld history |
Open saved trim history |
/trimworld status |
Show current maintenance state; console supported |
/trimworld cancel |
Cancel an active maintenance countdown |
/trimworld recovery CONFIRM |
Release recovery after manual inspection |
/trimworld reload |
Reload configuration while idle |
Permission: trimmer.admin — defaults to OP.
Aliases: /simplextrimmer, /strimmer
? Safety & recovery
SimplexTrimmer uses world/session locks during startup maintenance. Paper may already hold a world's session.lock inside the same JVM during early startup; current releases recognize that protected same-process state correctly while still rejecting a lock owned by another process.
If a trim is interrupted or fails after destructive work may have started, SimplexTrimmer enters recovery mode. Normal players are blocked until an administrator reviews the job.
There is no automatic rollback. Always inspect the raw logs and restore your backup if necessary before releasing recovery.
The only automatic retry exception is the specifically recognized preflight-only session.lock failure produced by SimplexTrimmer 12.1.0, and only when no trim target had started.
⚠️ Read before trimming
- Make a complete backup before every trim.
- SimplexTrimmer confirms that you say a backup exists; it does not create or validate that backup.
- Do not force-stop the server or MCA Selector while destructive processing is active.
- If a run fails, earlier dimensions may already have been modified.
- Deleted chunks can regenerate later when players revisit them.
- Regenerated terrain can differ after Minecraft updates, datapack changes or generator changes.
- There is no automatic Lands, WorldGuard, GriefPrevention, claim, spawn or building protection.
- Disk-space savings depend entirely on your world and selected threshold. No percentage is guaranteed.
✅ Requirements & compatibility
- Server: Paper or a compatible Paper-derived server with the required Bukkit/Paper APIs.
- MCA Selector: version 2.9 or newer for the current workflow.
- Java for MCA Selector 2.9: Java 21 or newer.
- Plugin bytecode: Java 17 target; your Minecraft/Paper server may require a newer Java version, which takes precedence.
- Floodgate: optional; only required for native Bedrock forms.
- Geyser: optional and installed separately when Bedrock players connect to the Java server.
Not supported as trimming targets:
- Folia
- Fabric
- Forge
- Proxy-only environments
- Native Bedrock LevelDB worlds
Bedrock players are supported through a Java Paper server using Geyser/Floodgate; SimplexTrimmer does not edit native Bedrock world databases.
? Quick start
- Stop the server and create a complete backup.
- Remove older SimplexTrimmer JARs.
- Install
SimplexTrimmer-12.1.2.jar.
- Start the server normally.
- Run
/trimworld as OP or with trimmer.admin.
- Use Update MCA Selector to install/verify the official tool.
- Select the dimensions you want to process.
- Choose the
InhabitedTime threshold and countdown.
- Confirm that your backup exists.
- Start maintenance.
- Allow the server to stop normally.
- Let your hosting panel/restart script start it again, or start it manually if required.
- Watch the live trim progress in the server console during startup.
- Review the final result in SimplexTrimmer history.
Do not use /reload as a substitute for a full maintenance restart.
? Configuration & data
Version 12 operational data is stored under:
plugins/SimplexTrimmer/data-v12/
This includes the MCA Selector tool state, queued/archived jobs, logs, history, sessions and runtime state.
Existing v11 state is not automatically migrated into data-v12/. Bukkit also keeps an existing config.yml when you update the plugin, so newly introduced options use their built-in defaults until you add them to your configuration.
Useful configuration options include:
world-trimmer:
restart-mode: STOP
shutdown-warning-seconds: 30
default-threshold-ticks: 600
minimum-threshold-ticks: 20
history-limit: 100
additional-world-roots: []
performance:
heap: 2G
process-threads: 2
timeout-minutes: 120
preflight:
minimum-free-space-gib: 2
? Upgrading from SimplexTrimmer 11.x
The supplied legacy 11.0-ULTIMATE build used a different workflow: it entered maintenance while the server was already running, kicked players, disabled autosave, saved/unloaded chunks, executed MCA Selector and then attempted a server restart.
Version 12.1.2 intentionally replaces that design with queued, startup-only processing, persistent job state, stronger path/lock validation, recovery handling and a supervised external MCA Selector process.
When upgrading:
- Remove the old JAR.
- Keep your backup.
- Do not copy old runtime/state files into
data-v12/.
- Reinstall/update MCA Selector through the new interface.
- If you also use a SimplexAdminSuite build containing its own trimmer module, disable the duplicate trimmer there.
Credits & external tool
World editing is performed locally by MCA Selector, created by Querz and contributors:
MCA Selector is downloaded separately from its official GitHub release and is not bundled in SimplexTrimmer.
Your Minecraft world data is processed locally on your server and is not uploaded by SimplexTrimmer to an external trimming service.
评论 0
登录后参与评分
还没有评论,来抢沙发吧