一个适用于 Paper 和 Spigot 的强大插件,通过基于坐标的区域或 WorldEdit 选择来保持区块加载。
功能特性
- 交互式 GUI - 易于使用的图形界面,用于管理区块加载器
- 跨服务器重启永久保持区块加载
- 使用坐标 (x1, z1, x2, z2) 创建区块加载器
- 从 WorldEdit 选择区域创建区块加载器(可选)
- 为区块加载器区域命名,便于管理
- 启用/禁用区块加载器而无需删除它们
- 持久化数据存储(支持服务器重启后保留)
- 基于权限的访问控制
- 列出并查看所有区块加载器及其状态信息
安装方法
- 下载最新的
UltimateChunkLoader.jar
- 将其放入服务器的
plugins/ 文件夹中
- (可选)安装 WorldEdit 以支持基于选择的区块加载
- 重启服务器
- 根据需要配置权限(所有命令默认仅限 OP 使用)
命令列表
所有命令均可使用 /chunkloader、/cl 或 /cloader 前缀执行
/chunkloader gui 或 /chunkloader menu - 打开 GUI 管理菜单
/chunkloader create <name> <x1> <z1> <x2> <z2> - 使用方块坐标创建区块加载器
/chunkloader create <name> worldedit - 根据 WorldEdit 选择区域创建区块加载器
/chunkloader remove <name> - 删除区块加载器
/chunkloader enable <name> - 启用已禁用的区块加载器
/chunkloader disable <name> - 禁用区块加载器而不删除它
/chunkloader list - 列出所有区块加载器及其状态
/chunkloader info <name> - 查看区块加载器的详细信息
/chunkloader reload - 重新加载插件配置和数据
权限节点
chunkloader.* - 访问所有命令(默认:op)
chunkloader.create - 创建区块加载器(默认:op)
chunkloader.remove - 删除区块加载器(默认:op)
chunkloader.enable - 启用区块加载器(默认:op)
chunkloader.disable - 禁用区块加载器(默认:op)
chunkloader.list - 列出区块加载器(默认:op)
chunkloader.info - 查看区块加载器信息(默认:op)
chunkloader.gui - 使用 GUI 菜单(默认:op)
chunkloader.reload - 重新加载插件(默认:op)
使用示例
使用 GUI(推荐)
通过 GUI 管理区块加载器是最简单的方式:
/chunkloader gui
在 GUI 中:
- 绿色羊毛 = 已启用的区块加载器
- 红色羊毛 = 已禁用的区块加载器
- 左键点击 - 查看详细详细信息
- 右键点击 - 切换启用/禁用状态
- Shift + 左键点击 - 删除(需确认)
使用坐标创建区块加载器
/chunkloader create spawn 0 0 64 64
这将创建一个名为 "spawn" 的区块加载器,保持方块坐标 (0, 0) 和 (64, 64) 之间的所有区块处于加载状态。
使用 WorldEdit 选择区域创建区块加载器
- 进行 WorldEdit 选择 (
//wand,然后左键和右键点击)
- 运行:
/chunkloader create myregion worldedit
列出所有区块加载器
/chunkloader list
查看特定区块加载器的信息
/chunkloader info spawn
删除区块加载器
/chunkloader remove spawn
临时禁用区块加载器
/chunkloader disable spawn
这将卸载区块但保留区域配置,以便稍后重新启用。
启用之前禁用的区块加载器
/chunkloader enable spawn
配置文件
插件会在 plugins/ChunkLoader/ 目录下生成一个 config.yml 文件,包含以下选项:
settings:
debug: false
auto-save-interval: 5
messages:
prefix: "&6[ChunkLoader]&r "
no-permission: "&cYou don't have permission to do that."
reload-success: "&aPlugin reloaded successfully!"
数据存储
区块加载器数据存储在 plugins/ChunkLoader/data.yml 中,并在服务器重启后持久保留。插件在以下情况自动保存:
要求
- Paper 1.21+ 或 Spigot 1.21+(或兼容分支)
- WorldEdit(可选,用于基于选择的加载)
工作原理
该插件利用 Minecraft 的区块票证系统来保持区块加载:
addPluginChunkTicket() - 注册插件对某个区块的兴趣
setForceLoaded(true) - 确保区块保持加载状态
即使附近没有玩家,区块也会保持加载状态,非常适合用于农场、红石装置或任何自动化系统。
许可证
本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
A powerful plugin for Paper and Spigot that keeps chunks loaded using coordinate-based regions or WorldEdit selections.
Features
- Interactive GUI - Easy-to-use graphical interface for managing chunk loaders
- Keep chunks loaded permanently across server restarts
- Create chunk loaders using coordinates (x1, z1, x2, z2)
- Create chunk loaders from WorldEdit selections (optional)
- Name your chunk loader regions for easy management
- Enable/disable chunk loaders without removing them
- Persistent data storage (survives server restarts)
- Permission-based access control
- List and view information about all chunk loaders with their status
Installation
- Download the latest
UltimateChunkLoader.jar
- Place it in your server's
plugins/ folder
- (Optional) Install WorldEdit for selection-based chunk loading
- Restart your server
- Configure permissions if needed (all commands default to OP)
Commands
All commands can be used with /chunkloader, /cl, or /cloader
/chunkloader gui or /chunkloader menu - Open the GUI management menu
/chunkloader create <name> <x1> <z1> <x2> <z2> - Create a chunk loader using block coordinates
/chunkloader create <name> worldedit - Create a chunk loader from your WorldEdit selection
/chunkloader remove <name> - Remove a chunk loader
/chunkloader enable <name> - Enable a disabled chunk loader
/chunkloader disable <name> - Disable a chunk loader without removing it
/chunkloader list - List all chunk loaders with their status
/chunkloader info <name> - View detailed information about a chunk loader
/chunkloader reload - Reload the plugin configuration and data
Permissions
chunkloader.* - Access to all commands (default: op)
chunkloader.create - Create chunk loaders (default: op)
chunkloader.remove - Remove chunk loaders (default: op)
chunkloader.enable - Enable chunk loaders (default: op)
chunkloader.disable - Disable chunk loaders (default: op)
chunkloader.list - List chunk loaders (default: op)
chunkloader.info - View chunk loader information (default: op)
chunkloader.gui - Use the GUI menu (default: op)
chunkloader.reload - Reload the plugin (default: op)
Usage Examples
Using the GUI (Recommended)
The easiest way to manage your chunk loaders is through the GUI:
/chunkloader gui
In the GUI:
- Green wool = Enabled chunk loader
- Red wool = Disabled chunk loader
- Left Click - View detailed information
- Right Click - Toggle enable/disable
- Shift + Left Click - Remove (with confirmation)
Create a chunk loader using coordinates
/chunkloader create spawn 0 0 64 64
This creates a chunk loader named "spawn" that keeps all chunks loaded between block coordinates (0, 0) and (64, 64).
Create a chunk loader using WorldEdit selection
- Make a WorldEdit selection (
//wand, then left-click and right-click)
- Run:
/chunkloader create myregion worldedit
List all chunk loaders
/chunkloader list
View information about a specific chunk loader
/chunkloader info spawn
Remove a chunk loader
/chunkloader remove spawn
Disable a chunk loader temporarily
/chunkloader disable spawn
This unloads the chunks but keeps the region configuration saved, so you can re-enable it later.
Enable a previously disabled chunk loader
/chunkloader enable spawn
Configuration
The plugin creates a config.yml file in plugins/ChunkLoader/ with the following options:
settings:
debug: false
auto-save-interval: 5
messages:
prefix: "&6[ChunkLoader]&r "
no-permission: "&cYou don't have permission to do that."
reload-success: "&aPlugin reloaded successfully!"
Data Storage
Chunk loader data is stored in plugins/ChunkLoader/data.yml and persists across server restarts. The plugin automatically saves when:
- A chunk loader is created
- A chunk loader is removed
- The server shuts down
Requirements
- Paper 1.21+ or Spigot 1.21+ (or compatible forks)
- WorldEdit (optional, for selection-based loading)
How It Works
The plugin uses Minecraft's chunk ticket system to keep chunks loaded:
addPluginChunkTicket() - Registers the plugin's interest in a chunk
setForceLoaded(true) - Ensures the chunk stays loaded
Chunks remain loaded even when no players are nearby, making this perfect for farms, redstone contraptions, or any automated systems.
License
This project is licensed under the MIT License - see the LICENSE file for details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧