Chunky 区块预生成插件

Chunky 区块预生成插件

> 一款快速、高效、安全的区块预生成工具，可在开服前把地图按指定形状与半径提前生成完毕，从根源上消除玩家探索时的卡顿与"掉方块"；支持 Bukkit / Paper / Folia、Sponge、Fabric、Forge、NeoForge 多平台，GPL-3.0 开源。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | Chunky |
| 开发者 | pop4959 |
| 最新版本 | 1.5.4（2026-07-23，Forge / NeoForge）；1.5.3（2026-05-04，Bukkit / Paper / Spigot / Folia / Sponge / Fabric） |
| 许可协议 | GPL-3.0-only |
| 兼容版本 | Minecraft Java 1.13.2 – 26.2（覆盖 1.14.x ~ 1.21.x、26.1.x、26.2） |
| 运行平台 | Bukkit / Spigot / Paper / Purpur / Folia、Sponge、Fabric、Forge、NeoForge |
| 项目地址 | https://modrinth.com/plugin/chunky |
| 官方 Wiki | https://github.com/pop4959/Chunky/wiki |
| 附属插件 | ChunkyBorder（https://modrinth.com/plugin/chunkyborder） |
简介

Chunky 是一款区块预生成（pre-generation）工具。玩家的每一次探索都会触发服务端实时生成地形，若生成速度跟不上移动速度，就会出现卡顿、掉帧甚至"掉方块"的现象。Chunky 的做法是在开服前或低峰期用一个后台任务把指定范围内的区块全部生成并写盘，之后玩家再怎么跑图，读到的都是现成地形。

它同时支持一个或多个生成任务并行（便于榨干多核 CPU），任务可暂停并保存进度、随时继续，也能随时取消。运行过程中会显示已处理区块数、完成百分比、预计剩余时间、区块处理速率等详细信息，进度一目了然。

配合 ChunkyBorder 还能直接按世界边界选取范围，是开荒服、跑图服与大型生存服的标准配置。
核心特性
多任务并行：可同时启动多个区块生成任务，充分利用多核 CPU
可暂停可续跑：暂停会保存进度，之后用 continue 接着跑，不必从头再来
详细进度反馈：区块数、完成百分比、ETA、处理速率等实时展示
自定义形状：方形、圆形、菱形、五边形、六边形、椭圆等形状可选（详见 Wiki 的 Shapes 页面）
生成模式：支持 concentric、spiral 等遍历顺序，按需选择（详见 Wiki 的 Patterns 页面）
世界边界联动：配合 ChunkyBorder 可直接按世界边界设定范围
区块裁剪：trim 可删除选区之外的区块，用于给存档"瘦身"
多平台统一：同一套核心覆盖插件端与模组端各加载器
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Bukkit / Spigot / Paper / Purpur / Folia；或 Sponge / Fabric / Forge / NeoForge |
| Minecraft | Java 版 1.13.2 – 26.2（各平台 jar 略有差异） |
| Java | 以所装版本对应的服务端要求为准 |
| 权限 | 需为 OP；单人存档需开启作弊 |
| 磁盘 | 预生成会显著增大存档体积，请预留足够空间 |
安装方法
从 Modrinth 下载对应平台的 jar（如 Chunky-Bukkit-1.5.3.jar）
放入服务端 plugins/（插件端）或 mods/（模组端）目录
重启服务端，插件自动生成配置文件
用 OP 账号执行 chunky help 确认安装成功

> 建议在开服前或玩家较少的时段执行预生成；任务会持续占用 CPU 与磁盘 IO。
命令一览

主命令为 chunky，按功能分为三类。下表整理自官方项目说明与 Wiki，权限节点以 chunky.command. 形式提供，未授予时默认回退到 OP。
任务管理

| 命令 | 说明 |
| --- | --- |
| chunky start | 按当前选区启动一个新的区块生成任务 |
| chunky pause | 暂停当前任务并保存进度 |
| chunky continue | 继续运行当前或已保存的任务 |
| chunky cancel | 停止并清除任务进度（已生成的区块不会被删除） |
范围选择

| 命令 | 说明 |
| --- | --- |
| chunky world [world] | 设置当前选中的世界 |
| chunky shape <shape> | 设置生成形状 |
| chunky center [<x> <z>] | 设置中心坐标 |
| chunky radius <radius> | 设置半径（支持 10k 表示 10000、625c 表示 625 区块、+1k 表示在原有基础上扩大） |
| chunky worldborder | 以所选世界的世界边界作为中心与半径 |
| chunky spawn | 以出生点为中心 |
| chunky corners <x1> <z1> <x2> <z2> | 以两个对角坐标划定选区 |
| chunky pattern <pattern> | 设置生成遍历模式 |
| chunky selection | 显示当前选区信息 |
其他

| 命令 | 说明 |
| --- | --- |
| chunky silent | 开关进度更新消息 |
| chunky quiet <interval> | 设置进度消息的间隔秒数 |
| chunky progress | 在游戏内显示所有任务的进度 |
| chunky reload | 重载配置文件 |
| chunky trim | 删除选区之外的区块 |

> 权限节点形如 chunky.command.radius、chunky.command.cancel，可通过 LuckPerms 等权限插件精细分配；完整清单以所装版本的 plugin.yml 与官方 Wiki 为准。
使用示例

以出生点为中心、半径 1000 的主世界方形预生成：

chunky radius 1000
chunky start

以下界出生点为中心、半径 1000 的圆形预生成：

chunky world the_nether
chunky shape circle
chunky spawn
chunky radius 1000
chunky start

按世界边界预生成（需 ChunkyBorder）：

worldborder center 0 0
worldborder set 20000
chunky worldborder
chunky start
配置说明

配置文件在插件端为 plugins/Chunky/config.yml，主要包含消息语言与进度提示相关设置；任务进度单独保存在插件目录下，重启后仍可 continue 续跑。

> 具体字段随版本变动，请以所装版本生成的配置文件与官方 Wiki 为准。
使用场景
开荒/跑图服：提前生成主城周边与常用传送点范围，杜绝玩家跑图卡顿
生存服扩容：地图边界扩张后，先预生成再解封，避免开图瞬间的服务器卡顿暴涨
世界边界的"干净化"：配合 ChunkyBorder 生成整齐的方形世界，边缘不留零星区块
存档瘦身：用 trim 删掉选区外的冗余区块，减小存档体积
活动地图准备：活动/赛事地图提前生成完毕，保证活动期间零卡顿
相关链接
Modrinth 下载：https://modrinth.com/plugin/chunky
官方 Wiki：https://github.com/pop4959/Chunky/wiki
ChunkyBorder 附属插件：https://modrinth.com/plugin/chunkyborder
GitHub 源码：https://github.com/pop4959/Chunky
CodeMC 构建镜像：https://ci.codemc.io/view/Author/job/pop4959/job/Chunky/
bStats 统计：https://bstats.org/plugin/bukkit/Chunky/8211
翻译协作：https://crowdin.com/project/chunky
Discord：https://discord.gg/ZwVJukcNQG