ChunkCleaners
一款专注于性能、高度优化的区块清理插件,适用于 Paper 1.21+。它允许玩家清除指定区块内的所有方块和实体。这是 Factions(阵营)和 Survival(生存)服务器中备受青睐的功能。
支持 FactionsUUID、MassiveCore Factions、WorldGuard、GriefPrevention 和 CoreProtect!
主要功能
可放置的区块清理道具(可配置类型:小型、中型、大型)。
自上而下的清理方式(先处理地表),以避免在作业过程中形成地下空洞。
支持多区块清理(1x1、2x2、4x4 等),并根据大小自动调整吞吐量。
TPS 自适应限流——当服务器 TPS 下降时自动减少工作量。
全息图与动作栏(ActionBars)!
集成支持:
WorldGuard(检查区域建造标志)
GriefPrevention(检查领地主张)
Factions
CoreProtect(按区块汇总记录、限制入队频率 + 定期刷新)
持久化存储,支持自动保存及每个任务的进度保存(减少重启后的进度丢失)。
命令
主命令:/chunkcleaners(别名 /cc)
玩家命令
/chunkcleaners give <player> <type> [amount] — 向玩家发放清理道具(权限:chunkcleaners.give)。
/chunkcleaners list — 显示当前活跃的清理道具数量或简要列表。
/chunkcleaners reload — 重新加载插件配置(需要管理员权限)。
管理员子命令(权限:chunkcleaners.admin)
/chunkcleaners admin save — 强制将所有活跃任务保存到磁盘。
/chunkcleaners admin savetask <uuid> — 立即保存单个任务的进度。
/chunkcleaners admin list — 列出所有活跃任务及其百分比进度。
/chunkcleaners admin status <uuid> — 显示详细状态(预计剩余时间、区块指针、进度)。
全息图与视觉效果
可在 hologram.* 下进行配置:
hologram.lines — 多行全息图的行列表(推荐,支持占位符)。
hologram.text — 单行文本回退方案,支持 \n 换行。
hologram.offset — 放置在方块上方的垂直偏移量。可用占位符:{remaining}、{progress}、{coords}、{type}、{amount}、{player}。
性能调优与选项
所有调优选项均位于 config.yml 的 performance.* 下。
重要参数
performance.max_chunks_per_interval — 每次调度运行准备的基准区块数量。
performance.y_batch_size — 每个区块任务处理的基准垂直层数。
performance.ticks_per_chunk_interval — 调度间隔(刻/ticks)。
performance.size_scale_enabled — 是否让较大的清理道具自动执行更多工作。
performance.size_scale_multiplier — 用于结合清理道具大小计算缩放因子的乘数。
performance.size_scale_cap — 缩放因子的上限(安全默认值为 8)。
performance.aggressive_interval_divisor — (高级)允许为大型清理道具使用更小的调度间隔。
performance.tps_threshold & performance.tps_smoothing — 用于检测低 TPS 并平滑地减少工作量。
performance.eta_window_seconds — 移动平均 ETA 估计器的窗口大小(秒)。
CoreProtect 安全性
coreprotect.log_chunk_summary(推荐)— 每个完成的区块仅记录一条汇总条目,而非每个方块。
coreprotect.flush_interval_ticks & coreprotect.max_entries_per_flush — 控制 CoreProtect 的日志写入吞吐量。
coreprotect.queue_max_size — 通过限制队列条目数量防止内存溢出。
持久化
persistence-file — 保存活跃任务的文件路径(默认 data/active-cleaners.yml)。
persistence.autosave_enabled & persistence.autosave_interval_seconds — 定期自动保存设置。
插件还会在每个区块清理完成时保存单个任务的进度。
推荐的生成环境调优
从 config.yml 中的默认值开始。
在新世界中测试多种类型的清理道具。
监控服务器 TPS 和 tick 时间。如果 TPS 保持稳定(≥ ~19),则逐步:
增加 size_scale_multiplier 或 size_scale_cap,或者
增加 max_chunks_per_interval 和 y_batch_size。
保持 CoreProtect 批量日志记录启用,并监控 CoreProtect 的性能/IO。
使用 persistence.autosave_interval_seconds(默认 60s)来平衡韧性与磁盘写入次数。
安全与集成行为
如果启用了保护集成,插件将拒绝代表离线玩家编辑区块(保守的默认设置)。
WorldGuard/GriefPrevention/Factions 的检查通过反射实现,因为最新版本中缺少相关 API。
开发与测试
试用该插件!
/chunkcleaners give <player> small 1
玩家放置道具后——应出现全息图和动作栏。
使用 /chunkcleaners admin list 和 /chunkcleaners admin status <uuid> 进行调试。
配置
# ChunkCleaners
# Version 1.0.0 by d15c07d
#
# Supported placeholders (used in messages/holograms/actionbar):
# {remaining} - seconds remaining (ETA)
# {progress} - percent complete 0-100
# {coords} - world:chunkX,chunkZ (or world:x,z)
# {type} - cleaner type key
# {amount} - numeric amount
# {player} - player name
# {id} - task UUID
# {count} - number of active cleaners
# ----------------------------------------------------------------
types:
small:
display-name: "<green>Small Cleaner</green>"
description: "Clears a 1x1 chunk area quickly.\nTip: place on flat ground."
size: 1
block: END_PORTAL_FRAME
duration: 10
medium:
display-name: "<yellow>Medium Cleaner</yellow>"
description: "Clears a 2x2 chunk area over time."
size: 2
block: END_PORTAL_FRAME
duration: 30
large:
display-name: "<red>Large Cleaner</red>"
description: "Clears a 4x4 chunk area. Use with caution."
size: 4
block: END_PORTAL_FRAME
duration: 90
# ----------------------------------------------------------------
# 全息显示与视觉效果
# - 你可以配置单个字符串(hologram.text)或多行文本(hologram.lines)——对于多行全息图,推荐使用 lines。
# - hologram.offset 用于将全息图在已放置方块上方垂直移动。
# - 行间距和其他高级行为可以稍后添加。
# ----------------------------------------------------------------
hologram:
enabled: true
# 在已放置方块上方的垂直偏移量(以方块为单位)
offset: 0.6
lines:
- "<gold>Cleaning: <yellow>{remaining}s</yellow>"
- "<gray>{progress}% complete</gray>"
# 如果未定义或 'lines' 为空时的单行文本备用方案。
text: "<gold>Cleaning: <yellow>{remaining}s</yellow>"
# ----------------------------------------------------------------
# 在 Cleaner 运行时定期向玩家显示的 Actionbar 内容。
# 使用 {remaining} 和 {progress} 占位符。
# ----------------------------------------------------------------
actionbar:
enabled: true
message: "&aChunk Cleaner &7- &e{remaining}s &8[&e{progress}%&8]"
# ----------------------------------------------------------------
# 消息(通用、管理员和普通消息)。所有消息均可编辑以进行本地化。
# 支持 MiniMessage 或传统的 '&' 代码。支持多个占位符。
# ----------------------------------------------------------------
messages:
# 通用(非管理员)消息
no_permission: "<red>You don't have permission to do that."
invalid_type: "<red>That chunk cleaner type doesn't exist."
gave_cleaner: "<green>Gave {amount}x {type} to {player}."
placed_denied_same_chunk: "<red>There is already an active chunk cleaner in this chunk."
placed_denied_protected: "<red>You cannot place a chunk cleaner in a protected region."
start_cleaning: "<green>Started cleaning chunk area {coords} (type {type})."
cancel_no_nearby: "<red>You are not near an active chunk cleaner you own."
cancel_success: "<green>Cancelled the chunk cleaner at {coords}."
reload_success: "<green>Reloaded config and plugin data."
list_header: "<gold>Active Chunk Cleaners (page {page}/{max})"
list_entry: "<yellow>{index}. <white>{owner} <gray>({coords}) <gold>{type} <gray>age={age}s"
cannot_place_in_same_chunk: "<red>A chunk cleaner is already active in this chunk."
cannot_place_in_protected: "<red>Cannot place chunk cleaners in protected regions."
# 管理员命令消息(由 /chunkcleaners admin ... 使用)
admin:
help_header: "<gold>ChunkCleaners 管理员命令"
help_lines:
- "<yellow>/chunkcleaners admin save <white>- 将所有活跃清理器保存到磁盘"
- "<yellow>/chunkcleaners admin savetask <uuid> <white>- 保存特定任务的进度"
- "<yellow>/chunkcleaners admin list <white>- 列出活跃任务"
- "<yellow>/chunkcleaners admin status <uuid> <white>- 显示任务的详细状态"
save_success: "<green>已将所有活跃清理器保存到磁盘。"
save_fail: "<red>保存失败:{error}"
savetask_success: "<green>已保存任务 {id} 的进度"
savetask_no_task: "<red>没有该 UUID 的活跃任务。"
savetask_invalid_uuid: "<red>无效的 UUID:{id}"
help_no_permission: "<red>您没有权限使用管理员命令。"
list_header: "<gold>活跃的区块清理器:<gray>({count})"
list_empty: "<yellow>没有活跃的区块清理器。"
status_not_found: "<red>没有该 UUID 的活跃任务。"
status_world_unloaded: "<red>世界未加载:{world}"
status_progress_line: "<gold>进度:<white>{percent}% ({processed}/{total} 层级)"
status_eta_line: "<gold>预计剩余时间:<white>{seconds}s"
status_pointers: "<gold>区块索引:<white>{idx} <gold>Y 轴指针:<white>{y}"
# 主命令消息与用法(适用于 /chunkcleaners 及其别名 /cc)
main:
usage_header: "<yellow>ChunkCleaners 命令:"
usage_lines:
- "<yellow>/chunkcleaners give <玩家> <类型> [数量] <white>- 向玩家发放一个清理器"
- "<yellow>/chunkcleaners list <white>- 列出当前活跃的清理器"
- "<yellow>/chunkcleaners reload <white>- 重新加载插件配置"
- "<yellow>/chunkcleaners admin <sub> <white>- 管理员工具(需要权限)"
reload_success: "<green>配置已重新加载。"
reload_fail: "<red>重新加载失败:{error}"
give_no_permission: "<red>你没有权限给予清洁工。"
give_success: "<green>已向 {player} 发放了 {amount}x {type}。"
# ----------------------------------------------------------------
# 行为开关与持久化
# ----------------------------------------------------------------
prevent_same_chunk: true # 如果为 true,插件将阻止在同一区块中运行两个清理器
save_on_shutdown: true # 在关闭时将活动的清理器保存到持久化文件
persistence-file: data/active-cleaners.yml
persistence:
autosave_enabled: true
autosave_interval_seconds: 60 # 每 N 秒保存一次,以减少进度丢失
# 热重载(监听 config.yml 并自动重新加载)
hot_reload:
enabled: true
file: config.yml
poll_interval_ms: 1000
# ----------------------------------------------------------------
# 集成:仅启用你在服务器上运行的插件
# - WorldGuard:区域/建造标志检查
# - GriefPrevention:领地检查
# - Factions:FactionsUUID 或 MassiveCore Factions 检测
# - CoreProtect:按区块批量日志记录
# ----------------------------------------------------------------
integrations:
worldguard: true
griefprevention: true
factions: true
coreprotect: true
# ----------------------------------------------------------------
# 性能调优与自适应限流
#
# 注意事项:
# - 从保守设置开始。在监控 TPS(每秒刻数)的同时缓慢增加数值。
# - 基于大小的缩放机制会让更大的清理器在每个刻中执行更多工作。
# ----------------------------------------------------------------
performance:
# 基础参数
max_chunks_per_interval: 1 # 每个调度器间隔内尝试处理的区块基线数量
y_batch_size: 1 # 每个区块任务中垂直层数的基线数量
ticks_per_chunk_interval: 2 # 调度器重复间隔(以刻为单位)
# 自适应限流
tps_threshold: 18.0
tps_min_chunks_per_interval: 1
tps_min_y_batch_size: 1
tps_smoothing: 0.75
tps_check_interval_ticks: 1
# 用于计算平滑处理速率的 ETA 平滑窗口(秒)
eta_window_seconds: 8
# 基于大小的缩放(让更大的清理器按比例处理更多工作)
size_scale_enabled: true
# scaleFactor = min(size_scale_cap, size * size_scale_multiplier)
size_scale_multiplier: 1
size_scale_cap: 8
# 如果 >1,调度器间隔可以被分割以用于更大的清理器(谨慎使用)
aggressive_interval_divisor: 1
# ----------------------------------------------------------------
# CoreProtect 日志记录(按区块批量)—— 避免使 CoreProtect 过载
# - log_chunk_summary:为每个已完成的区块发送单个摘要(推荐)
# - flush_interval_ticks / max_entries_per_flush 控制吞吐量
# ----------------------------------------------------------------
coreprotect:
enabled: true
log_chunk_summary: true
flush_interval_ticks: 20
max_entries_per_flush: 50
queue_max_size: 5000
queue_trim_to: 4000
# 旧版回退方案(当 log_chunk_summary=true 时不使用)
log_every_n: 10
# ----------------------------------------------------------------
# 安全与操作说明
# ----------------------------------------------------------------
# - 如果您启用了集成插件,本插件将拒绝代表离线所有者编辑受保护的区块。
# 这可以防止意外修改其他玩家的领地/区域。
# - 运行大型清理器时请监控服务器 TPS。本插件会根据 TPS 自动调整其吞吐量。
# - 如果在高规模环境下使用 CoreProtect 日志记录,请确保 CoreProtect 和磁盘 I/O 能够承受负载。
# - 为了快速恢复,默认 persistence.autosave_interval_seconds = 60s。您可以将其调低以实现更频繁的保存,
# 但这会增加磁盘写入量。
支持
需要此插件的支持,或希望添加对其他插件的支持?请在 Discord 上联系 @d15co7d!
ChunkCleaners
A performance focused, highly optimized, chunk cleaner plugin for Paper 1.21+ that allows players to remove all blocks and entities within a chunk. This is a well sought after feature for Factions and Survival servers.
Support for FactionsUUID, MassiveCore Factions, WorldGuard, GriefPrevention and CoreProtect!
Key features
Placeable chunk-cleaner items (configurable types: small, medium, large).
Top-down cleaning (surface first) to avoid underground holes while working.
Multi-chunk support (1x1, 2x2, 4x4, etc.) with size-aware throughput scaling.
TPS-adaptive throttling — reduces workload automatically when server TPS drops.
Holograms and ActionBars!
Integrations:
WorldGuard (region build flag checks)
GriefPrevention (claim checks)
Factions
CoreProtect (batch-per-chunk summaries, throttled enqueue + periodic flush)
Persistence with autosave and per-task progress saving (reduces lost progress after a restart).
Commands
Primary command: /chunkcleaners (alias /cc)
Player commands
/chunkcleaners give <player> <type> [amount] — give a cleaner item to a player (permission: chunkcleaners.give).
/chunkcleaners list — show active cleaner count or a brief list.
/chunkcleaners reload — reload plugin config (admin permission required).
Admin subcommands (permission: chunkcleaners.admin)
/chunkcleaners admin save — force-save all active tasks to disk.
/chunkcleaners admin savetask <uuid> — save progress for a single task immediately.
/chunkcleaners admin list — list all active tasks with percent progress.
/chunkcleaners admin status <uuid> — show detailed status (ETA, chunk pointer, progress).
Holograms and Visuals
Configurable under hologram.*:
hologram.lines — a list of lines (preferred) for multi-line holograms (supports placeholders).
hologram.text — fallback single-line text with \n support.
hologram.offset — vertical offset above the placed block. Placeholders available: {remaining}, {progress}, {coords}, {type}, {amount}, {player}.
Performance tuning & options
All tuning options live under performance.* in config.yml.
Important knobs
performance.max_chunks_per_interval — baseline number of chunks prepared per scheduler run.
performance.y_batch_size — baseline vertical layers processed per chunk job.
performance.ticks_per_chunk_interval — scheduling interval (ticks).
performance.size_scale_enabled — whether larger cleaners automatically do more work.
performance.size_scale_multiplier — multiplier used with cleaner size to compute scale factor.
performance.size_scale_cap — upper cap for scale factor (safe default = 8).
performance.aggressive_interval_divisor — (advanced) allow smaller schedule interval for large cleaners.
performance.tps_threshold & performance.tps_smoothing — used to detect low TPS and smoothly reduce workload.
performance.eta_window_seconds — window for the moving-average ETA estimator.
CoreProtect safety
coreprotect.log_chunk_summary (recommended) — log one summary entry per finished chunk instead of each block.
coreprotect.flush_interval_ticks & coreprotect.max_entries_per_flush — control the CoreProtect logging throughput.
coreprotect.queue_max_size — prevents memory blowup by bounding queued entries.
Persistence
persistence-file — path to saved active tasks (default data/active-cleaners.yml).
persistence.autosave_enabled & persistence.autosave_interval_seconds — periodic autosave settings.
The plugin also saves per-task progress when a chunk completes.
Recommended production tuning
Start with defaults in config.yml.
Test on a new world with multiple cleaner types.
Monitor server TPS and tick times. If TPS remains stable (≥ ~19), gradually:
increase size_scale_multiplier or size_scale_cap, or
increase max_chunks_per_interval and y_batch_size.
Keep CoreProtect batch logging enabled and monitor CoreProtect performance/IO.
Use persistence.autosave_interval_seconds (default 60s) to balance resilience vs disk writes.
Safety and integration behavior
If protection integrations are enabled, the plugin will refuse to edit a chunk on behalf of an offline player (conservative default).
WorldGuard/GriefPrevention/Factions checks are performed via reflection due to missing API's in recent versions.
Development & testing
Test the plugin out!
/chunkcleaners give <player> small 1
Player places the item — hologram and actionbar should appear.
Use /chunkcleaners admin list and /chunkcleaners admin status <uuid> for debugging.
Configuration
# ChunkCleaners
# Version 1.0.0 by d15c07d
#
# Supported placeholders (used in messages/holograms/actionbar):
# {remaining} - seconds remaining (ETA)
# {progress} - percent complete 0-100
# {coords} - world:chunkX,chunkZ (or world:x,z)
# {type} - cleaner type key
# {amount} - numeric amount
# {player} - player name
# {id} - task UUID
# {count} - number of active cleaners
# ----------------------------------------------------------------
types:
small:
display-name: "<green>Small Cleaner</green>"
description: "Clears a 1x1 chunk area quickly.\nTip: place on flat ground."
size: 1
block: END_PORTAL_FRAME
duration: 10
medium:
display-name: "<yellow>Medium Cleaner</yellow>"
description: "Clears a 2x2 chunk area over time."
size: 2
block: END_PORTAL_FRAME
duration: 30
large:
display-name: "<red>Large Cleaner</red>"
description: "Clears a 4x4 chunk area. Use with caution."
size: 4
block: END_PORTAL_FRAME
duration: 90
# ----------------------------------------------------------------
# Hologram and visuals
# - You can configure either a single string (hologram.text) or multiple
# lines (hologram.lines) — lines are preferred for multi-line holograms.
# - hologram.offset moves the hologram vertically above the placed block.
# - line spacing and other advanced behavior can be added later.
# ----------------------------------------------------------------
hologram:
enabled: true
# Vertical offset above the placed block (in blocks)
offset: 0.6
lines:
- "<gold>Cleaning: <yellow>{remaining}s</yellow>"
- "<gray>{progress}% complete</gray>"
# Fallback single-line text if 'lines' is not defined or empty.
text: "<gold>Cleaning: <yellow>{remaining}s</yellow>"
# ----------------------------------------------------------------
# Actionbar display shown periodically to the player while cleaner runs.
# Use {remaining} and {progress} placeholders.
# ----------------------------------------------------------------
actionbar:
enabled: true
message: "&aChunk Cleaner &7- &e{remaining}s &8[&e{progress}%&8]"
# ----------------------------------------------------------------
# Messages (general, admin and main). All are editable for localization.
# Use MiniMessage or legacy '&' codes. Several placeholders supported.
# ----------------------------------------------------------------
messages:
# General (non-admin) messages
no_permission: "<red>You don't have permission to do that."
invalid_type: "<red>That chunk cleaner type doesn't exist."
gave_cleaner: "<green>Gave {amount}x {type} to {player}."
placed_denied_same_chunk: "<red>There is already an active chunk cleaner in this chunk."
placed_denied_protected: "<red>You cannot place a chunk cleaner in a protected region."
start_cleaning: "<green>Started cleaning chunk area {coords} (type {type})."
cancel_no_nearby: "<red>You are not near an active chunk cleaner you own."
cancel_success: "<green>Cancelled the chunk cleaner at {coords}."
reload_success: "<green>Reloaded config and plugin data."
list_header: "<gold>Active Chunk Cleaners (page {page}/{max})"
list_entry: "<yellow>{index}. <white>{owner} <gray>({coords}) <gold>{type} <gray>age={age}s"
cannot_place_in_same_chunk: "<red>A chunk cleaner is already active in this chunk."
cannot_place_in_protected: "<red>Cannot place chunk cleaners in protected regions."
# Admin command messages (used by /chunkcleaners admin ...)
admin:
help_header: "<gold>ChunkCleaners Admin Commands"
help_lines:
- "<yellow>/chunkcleaners admin save <white>- Save all active cleaners to disk"
- "<yellow>/chunkcleaners admin savetask <uuid> <white>- Save progress for a specific task"
- "<yellow>/chunkcleaners admin list <white>- List active tasks"
- "<yellow>/chunkcleaners admin status <uuid> <white>- Show detailed status for a task"
save_success: "<green>Saved all active cleaners to disk."
save_fail: "<red>Failed to save: {error}"
savetask_success: "<green>Saved progress for task {id}"
savetask_no_task: "<red>No active task with that UUID."
savetask_invalid_uuid: "<red>Invalid UUID: {id}"
help_no_permission: "<red>You don't have permission to use admin commands."
list_header: "<gold>Active Chunk Cleaners: <gray>({count})"
list_empty: "<yellow>No active chunk cleaners."
status_not_found: "<red>No active task with that UUID."
status_world_unloaded: "<red>World not loaded: {world}"
status_progress_line: "<gold>Progress: <white>{percent}% ({processed}/{total} levels)"
status_eta_line: "<gold>ETA (est): <white>{seconds}s"
status_pointers: "<gold>Chunk index: <white>{idx} <gold>Y pointer: <white>{y}"
# Main command messages and usage (used by /chunkcleaners and alias /cc)
main:
usage_header: "<yellow>ChunkCleaners commands:"
usage_lines:
- "<yellow>/chunkcleaners give <player> <type> [amount] <white>- Give a cleaner to a player"
- "<yellow>/chunkcleaners list <white>- List active cleaners"
- "<yellow>/chunkcleaners reload <white>- Reload plugin config"
- "<yellow>/chunkcleaners admin <sub> <white>- Admin utilities (requires permission)"
reload_success: "<green>Configuration reloaded."
reload_fail: "<red>Failed to reload: {error}"
give_no_permission: "<red>You don't have permission to give cleaners."
give_success: "<green>Gave {amount}x {type} to {player}."
# ----------------------------------------------------------------
# Behaviour toggles & persistence
# ----------------------------------------------------------------
prevent_same_chunk: true # if true, plugin prevents two cleaners in same chunk
save_on_shutdown: true # save active cleaners to persistence-file on shutdown
persistence-file: data/active-cleaners.yml
persistence:
autosave_enabled: true
autosave_interval_seconds: 60 # save every N seconds to reduce lost progress
# Hot reload (watch config.yml and reload automatically)
hot_reload:
enabled: true
file: config.yml
poll_interval_ms: 1000
# ----------------------------------------------------------------
# Integrations: enable only the plugins you run on the server
# - WorldGuard: region/build flag checks
# - GriefPrevention: claim checks
# - Factions: FactionsUUID or MassiveCore Factions detection
# - CoreProtect: batch-per-chunk logging
# ----------------------------------------------------------------
integrations:
worldguard: true
griefprevention: true
factions: true
coreprotect: true
# ----------------------------------------------------------------
# Performance tuning and adaptive throttling
#
# Notes:
# - Start conservative. Increase slowly while monitoring TPS.
# - size-aware scaling makes larger cleaners do more work per tick.
# ----------------------------------------------------------------
performance:
# Baseline knobs
max_chunks_per_interval: 1 # baseline number of chunks to attempt per scheduler interval
y_batch_size: 1 # baseline number of vertical layers per chunk job
ticks_per_chunk_interval: 2 # scheduler repeat interval (ticks)
# Adaptive throttling
tps_threshold: 18.0
tps_min_chunks_per_interval: 1
tps_min_y_batch_size: 1
tps_smoothing: 0.75
tps_check_interval_ticks: 1
# ETA smoothing window in seconds used to compute a smoothed processing rate
eta_window_seconds: 8
# Size-aware scaling (make larger cleaners process proportionally more work)
size_scale_enabled: true
# scaleFactor = min(size_scale_cap, size * size_scale_multiplier)
size_scale_multiplier: 1
size_scale_cap: 8
# If >1, scheduler interval can be divided for larger cleaners (use with caution)
aggressive_interval_divisor: 1
# ----------------------------------------------------------------
# CoreProtect logging (batch-per-chunk) — avoids overwhelming CoreProtect
# - log_chunk_summary: send single summary per completed chunk (recommended)
# - flush_interval_ticks / max_entries_per_flush control throughput
# ----------------------------------------------------------------
coreprotect:
enabled: true
log_chunk_summary: true
flush_interval_ticks: 20
max_entries_per_flush: 50
queue_max_size: 5000
queue_trim_to: 4000
# legacy fallback (not used when log_chunk_summary=true)
log_every_n: 10
# ----------------------------------------------------------------
# Safety & operational notes
# ----------------------------------------------------------------
# - If you enable integrations, the plugin will refuse to edit protected chunks on behalf of offline owners.
# This prevents accidental modification of other players' claims/regions.
# - Monitor server TPS when running large cleaners. The plugin adjusts its throughput based on TPS.
# - If you use CoreProtect logging in high-scale environments, ensure CoreProtect and disk IO can handle the load.
# - For quick recovery, persistence.autosave_interval_seconds default = 60s. You may lower for more frequent saves
# at the cost of increased disk writes.
Support
In need of support for this plugin, or need support for another plugin added? Contact me on Discord @d15co7d!
评论 0
登录后参与评分
还没有评论,来抢沙发吧