WorldSlim

插件

· 作者 babyxxi

一个轻量级的区块保存优化插件,适用于 Paper 服务器。WorldSlim 通过自动清理玩家几乎未访问过的区块来减少你的世界文件大小。

0 本站下载 0 关注 更新于 6 个月前

最新 2.0.1 · 1.21.11 · Folia / Paper

一键开服(送7天)

WorldSlim

通过自动清理玩家极少访问的区块,减小 Minecraft 世界文件大小。三层防御机制拦截了原本会被原版自动保存写入磁盘的数据。


功能介绍

现代 Minecraft(1.18+)会在比玩家视距更长的时间内保持区块加载状态,并且无论玩家是否活动,自动保存都会将它们全部写入磁盘。WorldSlim 钩入了该流程的每一层:

  1. ChunkUnloadListener — 当区块卸载时,如果 InhabitedTime( inhabitation time,生存时间/占用时间)较低,则拦截保存操作。
  2. AutosaveShield (2.0 新增) — 每 2 秒一次,预先清除已加载的低 InhabitedTime 区块的脏标记(dirty flag),以便自动保存跳过它们。
  3. ChunkCleaner — 定期重写区域文件(region files),移除漏过前两层处理的区块。

玩家活动(放置方块、攻击生物、打开容器、拾取/丢弃物品)会将区块标记为“强制保存”,使其免受清理影响。


亮点

  • 三层架构 — 卸载 + 自动保存 + 区域重写。激进但安全。
  • 基于文件的 ChunkRegistry — 管理/强制保存状态存储在 plugins/WorldSlim/data/ 中,可存活于服务器重启以及 Leaf/Moonrise 对区块 PDC 的剥离。崩溃安全(丢失标记会降级为“勿动”)。
  • 激进模式 (cleanup.aggressive: true) — 恢复 1.0.6 之前的清理逻辑,在新生服务器上可实现 90% 以上的清理率。默认关闭以保护已有世界的建筑。
  • 诊断工具 — /worldslim diagnose 查看运行时计数器,/worldslim scan 检查任意区域文件的原始 NBT,/worldslim chunk 查看你当前所在区块的完整决策树。
  • 每日轮换的文件日志记录器,位于 plugins/WorldSlim/logs/,级别可配置。
  • 配置迁移 (2.0.1 新增) — 升级时自动注入新字段,保留你的编辑和注释。
  • 异步且有限制 — 所有磁盘操作均在主线程之外运行,并设有 5 秒超时,当服务器繁忙时安全跳过。

兼容性

Server PDC Persistence Registry AutosaveShield
Paper 1.21.x Yes Yes Yes
Purpur 1.21.x Yes Yes Yes
Folia 1.21.x Yes Yes Partial
Leaves 1.21.x Yes Yes Yes
Leaf 1.21.x Stripped Load-bearing Limited

需要 Minecraft 1.21.x 和 Java 21。


命令

Command Description
/worldslim status 显示插件状态和当前配置
/worldslim stats 扫描/清理的区块总数及节省的空间
/worldslim chunk 你当前所在区块的完整决策树
/worldslim cleanup 立即执行一次清理
/worldslim diagnose [here] 运行时诊断快照。附加 here 可查看当前区块详情
/worldslim scan 解析当前区域文件的原始 NBT 并报告存活的标签
/worldslim reload 重载 config.yml(同时运行配置迁移)
/worldslim reset 重置清理统计数据

支持别名 /ws。权限:修改类命令需 worldslim.admin;只读命令需 worldslim.use。


快速开始

  1. 将 jar 放入 plugins/ 目录,重启服务器。
  2. 默认配置较为保守(会保留任何看起来是预存在的区块)。大多数服务器无需额外配置即可正常运行。
  3. 在新生服务器上 — 设置 cleanup.aggressive: true 以获得最佳清理率。
  4. 在已有建筑和内容的服务器上 — 保持 aggressive: false(默认值),让注册表追踪后续新增的区块。

配置亮点

# 区块生命周期阈值。低于此值的区块可能会被清理。
# 默认 1200 ticks = 60 秒。
min-inhabited-time: 1200

cleanup:
  interval-minutes: 30
  run-on-startup: false
  # 1.0.6 之前的清理行为。强烈建议新生服务器使用。
  aggressive: false

autosave-shield:
  enabled: true
  interval-ticks: 40   # 2s

logging:
  file-enabled: true
  level: INFO          # DEBUG / INFO / WARN / ERROR

worlds:
  enabled: []          # 若非空,则仅管理这些世界
  disabled: []         # 始终跳过的世界

首次运行时生成包含所有注释的完整默认配置。


报告问题

请包含以下内容:

  • /worldslim diagnose 的截图
  • plugins/WorldSlim/logs/ 中的最新日志
  • 服务器类型和版本

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源