命令
| 命令 | 描述 |
|---|---|
/cm |
打开 GUI |
/cm help |
列出所有命令 |
/chunkstatus |
查看性能统计 |
/chunkreload |
重新加载配置 |
/optimizechunks |
强制优化区块 |
/chunkgc |
释放内存 |
/chunksummary |
世界分析 |
/maintenance <on|off|auto|status> |
切换维护模式 |
/chunklang <lang> |
更改语言 |
/chunkanalyze [world] |
分析区块复杂度 |
/chunkregions |
区域统计 |
/chunkmetrics |
高级指标 |
/cmtop |
最昂贵的已加载区块 |
/cminspect |
查看当前区块为何保持加载状态 |
/cmfreeze <add|remove|list|clear> |
固定区块使其永不卸载 |
/cmpregen <start|stop|status|resume> [radius] |
预生成区块 |
/cmviz |
按热度着色的区块边界粒子效果 |
/cmrtps |
各区域 TPS(Folia) |
/cmmap <refresh|on|off> |
Dynmap/BlueMap 热区块叠加层 |
权限
| 权限 | 描述 | 默认值 |
|---|---|---|
chunkmanager.admin |
所有命令 | op |
chunkmanager.notify |
性能通知 | op |
chunkmanager.bypass |
永不标记为 AFK,无加载限制 | false |
chunkmanager.radius.1 至 chunkmanager.radius.6 |
按等级预加载半径 | false |
功能
- 基于热度的卸载 - 跟踪活动情况,卸载冷区块
- 自动性能调整 - 根据 TPS/RAM 自动适应
- 区块预取 - 预测玩家去向,预加载区块
- 区域优化 - 根据活动情况优化区域
- 智能缓存 - 快速重新加载区块
- 实时监控 - TPS、内存、缓存统计
- 多语言支持 - en, es, fr, de, pt, it, ru, ja, ko, zh, ar
- 开发者 API - 可从插件中调用
- 世界黑名单 - 排除不想管理的世界
- Folia 支持 - 兼容 Folia、Paper、Spigot 和 Bukkit 1.20.4 - 1.21.x
- AFK 节省器 - 闲置玩家加载更少的区块,移动后立即恢复
- 实体限制器 - 每个区块对怪物、动物和物品的上限,命名和驯服的实体始终安全
- 预生成 - 感知 TPS,可恢复,跳过已存在的区块
- 冻结区块 - 固定任意区块使其永不卸载
- 顶级区块与分析器 - 查看哪些区块成本最高及其原因
- 区域 TPS - Folia 上的各区域刻时间
- 地图叠加层 - 在 Dynmap 和 BlueMap 上绘制热区块
- 尊重其他插件 - 永不卸载强制加载的区块、插件票证、WorldGuard 区域或正在运行的 Chunky
- PlaceholderAPI - 用于记分牌和标签页列表的 TPS、区块、AFK 及每区块数值
PlaceholderAPI
数值每秒缓存一次,因此它们在记分牌和标签页列表中是安全的。
服务器占位符
| 占位符 | 返回值 |
|---|---|
%chunkmanager_tps% |
当前 TPS |
%chunkmanager_tps_color% |
带有绿/黄/金/红色调的 TPS |
%chunkmanager_tick% |
刻时间(毫秒) |
%chunkmanager_tick_p95% |
过去 5 分钟内的 P95 刻时间 |
%chunkmanager_status% |
EXCELLENT(优秀)、GOOD(良好)、MODERATE(一般)、POOR(较差)或 CRITICAL(危急) |
%chunkmanager_platform% |
Folia、Paper、Spigot 或 Bukkit |
%chunkmanager_memory_used% |
已用内存(MB) |
%chunkmanager_memory_max% |
最大内存(MB) |
%chunkmanager_memory_percent% |
内存使用百分比 |
%chunkmanager_chunks% |
所有世界中已加载的区块总数 |
%chunkmanager_world_chunks_<world>% |
单个世界中已加载的区块数 |
%chunkmanager_chunks_queue% |
等待加载的区块 |
%chunkmanager_chunks_loading% |
正在加载的区块 |
%chunkmanager_loads_per_minute% |
过去一分钟内加载的区块数 |
%chunkmanager_unloads_per_minute% |
过去一分钟内卸载的区块数 |
%chunkmanager_culled% |
被限制器移除的实体数量 |
%chunkmanager_frozen% |
冻结的区块数 |
%chunkmanager_radius% |
当前预加载半径 |
%chunkmanager_maintenance% |
yes/no |
%chunkmanager_afk_count% |
当前处于 AFK 状态的玩家数量 |
%chunkmanager_worst_region% |
最慢的区域耗时(毫秒,Folia) |
%chunkmanager_pregen_active% |
yes/no |
%chunkmanager_pregen_percent% |
预生成进度 |
玩家占位符
| 占位符 | 返回值 |
|---|---|
%chunkmanager_afk% |
yes/no |
%chunkmanager_idle_seconds% |
玩家上次移动以来的秒数 |
%chunkmanager_player_radius% |
玩家的预加载半径 |
%chunkmanager_bedrock% |
yes/no(Geyser) |
%chunkmanager_chunk_x% |
玩家所在的区块 X 坐标 |
%chunkmanager_chunk_z% |
玩家所在的区块 Z 坐标 |
%chunkmanager_chunk_heat% |
该区块的热度 |
%chunkmanager_chunk_cost% |
该区块的成本评分 |
%chunkmanager_chunk_entities% |
该区块中的实体数量 |
%chunkmanager_chunk_tiles% |
该区块中的方块实体数量 |
%chunkmanager_chunk_frozen% |
yes/no |
开发者 API
设置
depend: [ChunkManager]
获取 API
ChunkManagerAPI api = (ChunkManagerAPI) Bukkit.getPluginManager().getPlugin("ChunkManager");
方法
// 基础操作
api.getCurrentRadius();
api.isMaintenanceMode();
api.setMaintenanceMode(true);
// 针对特定玩家
api.setPlayerRadius(player, 8);
api.getPlayerRadius(player);
// 统计数据
api.getAverageTickTime();
api.getMemoryUsagePercentage();
api.getLoadedChunksCount();
// 操作
api.forceChunkOptimization();
api.forceGarbageCollection();
api.reloadConfiguration();
// 异步操作
api.getWorldStatistics(world); // 返回 CompletableFuture
// 额外功能
api.getCurrentTps();
api.isBedrockPlayer(player);
api.getQueuedChunksCount();
config.yml
chunk-loading-radius: 3
cache-expiration-time: 30000
max-chunks-to-load: 5
max-cache-size: 100
logging-level: INFO
language: en
afk:
enabled: true
idle-seconds: 300
radius: 1
view-distance: 0
entity-limiter:
enabled: false
total-limit: 100
spawn-chunks:
radius: -1
更新预览:

Commands
| Command | Description |
|---|---|
/cm |
Open GUI |
/cm help |
List every command |
/chunkstatus |
View performance stats |
/chunkreload |
Reload config |
/optimizechunks |
Force chunk optimization |
/chunkgc |
Free up memory |
/chunksummary |
World analysis |
/maintenance <on|off|auto|status> |
Toggle maintenance mode |
/chunklang <lang> |
Change language |
/chunkanalyze [world] |
Analyze chunk complexity |
/chunkregions |
Region stats |
/chunkmetrics |
Advanced metrics |
/cmtop |
Most expensive loaded chunks |
/cminspect |
Why your current chunk is kept loaded |
/cmfreeze <add|remove|list|clear> |
Pin chunks so they never unload |
/cmpregen <start|stop|status|resume> [radius] |
Pre-generate chunks |
/cmviz |
Chunk border particles coloured by heat |
/cmrtps |
Per-region TPS (Folia) |
/cmmap <refresh|on|off> |
Dynmap/BlueMap hot-chunk overlay |
Permissions
| Permission | Description | Default |
|---|---|---|
chunkmanager.admin |
All commands | op |
chunkmanager.notify |
Performance notifications | op |
chunkmanager.bypass |
Never marked AFK, no loading limits | false |
chunkmanager.radius.1 to chunkmanager.radius.6 |
Per-rank preload radius | false |
Features
- Heat-Based Unloading - Tracks activity, unloads cold chunks
- Auto Performance Adjust - Adapts to TPS/RAM automatically
- Chunk Prefetching - Predicts where players go, preloads chunks
- Region Optimization - Optimizes areas based on activity
- Smart Caching - Fast chunk reloading
- Live Monitoring - TPS, memory, cache stats
- Multi-Language - en, es, fr, de, pt, it, ru, ja, ko, zh, ar
- Developer API - Hook into it from your plugins
- World Blacklist - Exclude worlds you don't want managed
- Folia Support - Runs on Folia, Paper, Spigot and Bukkit 1.20.4 - 1.21.x
- AFK Saver - Idle players load fewer chunks, restored the moment they move
- Entity Limiter - Per-chunk caps for mobs, animals and items, named and tamed always safe
- Pre-Generation - TPS-aware, resumable, skips chunks that already exist
- Frozen Chunks - Pin any chunk so it never unloads
- Top Chunks & Analyzer - See which chunks cost the most and why
- Region TPS - Per-region tick times on Folia
- Map Overlay - Hot chunks drawn on Dynmap and BlueMap
- Respects Other Plugins - Never unloads force-loaded chunks, plugin tickets, WorldGuard regions or a running Chunky
- PlaceholderAPI - TPS, chunks, AFK and per-chunk values for scoreboards and tab lists
PlaceholderAPI
Values are cached once a second, so they are safe in scoreboards and tab lists.
Server placeholders
| Placeholder | Returns |
|---|---|
%chunkmanager_tps% |
Current TPS |
%chunkmanager_tps_color% |
TPS with a green/yellow/gold/red colour |
%chunkmanager_tick% |
Tick time in ms |
%chunkmanager_tick_p95% |
Tick time p95 over the last 5 minutes |
%chunkmanager_status% |
EXCELLENT, GOOD, MODERATE, POOR or CRITICAL |
%chunkmanager_platform% |
Folia, Paper, Spigot or Bukkit |
%chunkmanager_memory_used% |
Used memory in MB |
%chunkmanager_memory_max% |
Max memory in MB |
%chunkmanager_memory_percent% |
Memory usage in percent |
%chunkmanager_chunks% |
Loaded chunks across all worlds |
%chunkmanager_world_chunks_<world>% |
Loaded chunks in one world |
%chunkmanager_chunks_queue% |
Chunks waiting to load |
%chunkmanager_chunks_loading% |
Chunks loading right now |
%chunkmanager_loads_per_minute% |
Chunk loads in the last minute |
%chunkmanager_unloads_per_minute% |
Chunk unloads in the last minute |
%chunkmanager_culled% |
Entities removed by the limiter |
%chunkmanager_frozen% |
Frozen chunks |
%chunkmanager_radius% |
Current preload radius |
%chunkmanager_maintenance% |
yes/no |
%chunkmanager_afk_count% |
Players currently AFK |
%chunkmanager_worst_region% |
Slowest region in ms (Folia) |
%chunkmanager_pregen_active% |
yes/no |
%chunkmanager_pregen_percent% |
Pre-generation progress |
Player placeholders
| Placeholder | Returns |
|---|---|
%chunkmanager_afk% |
yes/no |
%chunkmanager_idle_seconds% |
Seconds since the player last moved |
%chunkmanager_player_radius% |
The player's preload radius |
%chunkmanager_bedrock% |
yes/no (Geyser) |
%chunkmanager_chunk_x% |
Chunk X the player stands in |
%chunkmanager_chunk_z% |
Chunk Z the player stands in |
%chunkmanager_chunk_heat% |
Heat of that chunk |
%chunkmanager_chunk_cost% |
Cost score of that chunk |
%chunkmanager_chunk_entities% |
Entities in that chunk |
%chunkmanager_chunk_tiles% |
Tile entities in that chunk |
%chunkmanager_chunk_frozen% |
yes/no |
Developer API
Setup
depend: [ChunkManager]
Get API
ChunkManagerAPI api = (ChunkManagerAPI) Bukkit.getPluginManager().getPlugin("ChunkManager");
Methods
// Basics
api.getCurrentRadius();
api.isMaintenanceMode();
api.setMaintenanceMode(true);
// Per-player
api.setPlayerRadius(player, 8);
api.getPlayerRadius(player);
// Stats
api.getAverageTickTime();
api.getMemoryUsagePercentage();
api.getLoadedChunksCount();
// Actions
api.forceChunkOptimization();
api.forceGarbageCollection();
api.reloadConfiguration();
// Async
api.getWorldStatistics(world); // returns CompletableFuture
// Extra
api.getCurrentTps();
api.isBedrockPlayer(player);
api.getQueuedChunksCount();
config.yml
chunk-loading-radius: 3
cache-expiration-time: 30000
max-chunks-to-load: 5
max-cache-size: 100
logging-level: INFO
language: en
afk:
enabled: true
idle-seconds: 300
radius: 1
view-distance: 0
entity-limiter:
enabled: false
total-limit: 100
spawn-chunks:
radius: -1
Updated Previews:

下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ChunkManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
- 自动视距(Paper/Folia):当服务器出现卡顿时会降低视距和模拟距离,待恢复平稳后再将其调回
- 预生成会在动作栏中显示其速度(每秒生成的区块数)
改进
- 在 Paper/Folia 上预生成速度大幅提升。服务器状态良好时会自动加速,状态不佳时则自动降速
- 维护模式现在也会降低实际视距,从而真正减轻服务器负载
- 整体运行更流畅:后台工作被分散到各个 Tick 中执行,因此不再因区块扫描或保存文件而出现卡顿峰值
- Spigot 上不再在主线程加载区块
- 高速飞行者不再导致服务器在其前方远处提前生成地形
/chunkgc不再强制触发垃圾回收。它会清理缓存并显示清晰的内存报告/cmtop现在在大服务器上覆盖所有已加载的区块
修复
/chunkreload现在会应用所有设置- 维护模式不再反复开关
- 修复了
/chunkanalyze从错误线程读取区块的问题 - 修复了实体限制器跳过部分区块的问题
- 在 1.21.6+ 版本中,新的对话菜单:
/cm现在会打开干净的界面,用于设置、功能、预生成和顶部区块 - Bedrock 及旧版客户端仍然使用箱子菜单,而
/cm menu始终打开该菜单 - 功能切换现在立即生效,无需重新加载
- “智能卸载”开关现在真正起作用了
- 可以从控制台启动预生成,大型任务会在开始前询问确认
- 传送至顶部区块时,现在会落在安全的位置
/chunkanalyze <world>检查整个世界,/chunkanalyze here检查你所在的区块- 帮助、状态和分析器信息更加整洁,且已完全翻译
- Floodgate 玩家现在被识别为 Bedrock 玩家
- Tab 补全仅建议与你输入内容匹配的选项
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧