ChunkPreLoader999

插件

· 作者 Erik9994857

ChunkPreLoader999 是一款强大且专注于性能优化的 Minecraft 插件,允许服务器管理员预加载并维持世界特定区域的区块加载状态。

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

最新 1.0.2 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

? 功能

  • 加载玩家特定中心周围的矩形区域或正方形及圆形区域。
  • 限制每个刻(tick)和每个世界区域内的加载区块数量。
  • 限制每个玩家允许的区域大小;按世界序列化区块加载,以保持服务器负载可预测。
  • 查看加载进度、预计剩余时间、已保存区域以及服务器内存状态。
  • 取消加载任务并释放由中断任务加载的区块。
  • 重命名和调整已保存区域的大小。
  • 导出和导入区域定义,并创建已保存区域数据的备份。
  • 自动释放不活跃区域,同时保留其已保存的定义。
  • 追踪多个区域共享的区块,以便卸载一个区域时不会释放另一个区域的区块。

? 命令

所有命令均可通过 /cpl 或 /chunkpreloader 使用。

命令 描述
/cpl start <x1,z1> <x2,z2> <name> 使用两个方块坐标角点加载矩形区域。
/cpl center <x,z> 在当前世界中设置以方块坐标表示的半径中心。
/cpl radius <radius-chunks> 加载以你保存的中心为圆心的正方形区域,半径以区块为单位测量。区域名称自动生成。
/cpl circle <radius-chunks> <name> 加载以你保存的中心为圆心的圆形区域,半径以区块为单位测量。
/cpl cancel [area-name] 取消当前的激活加载任务,可选择指定其名称。
/cpl list 列出已保存区域及其是否处于激活状态。
/cpl info <name> 显示区域的所属世界、形状、区块数量和坐标。
/cpl status 显示已保存区域数量、正在进行的加载任务数、管理的强制加载区块数以及内存使用情况。
/cpl unload <name> 卸载并移除已保存的区域。
/cpl rename <old-name> <new-name> 重命名已保存的区域。
/cpl resize <name> <x1,z1> <x2,z2> 替换矩形区域的边界并加载新区域。
/cpl export <area-name> <file-name> 将区域定义导出到插件的 exports 文件夹中。
/cpl import <file-name> <new-area-name> 从 exports 文件夹导入定义并保存。
/cpl backup 创建带有时间戳的已保存区域数据备份。
/cpl reload 重新加载配置并恢复符合条件的已保存区域。

坐标与半径详情

start、center 和 resize 接受方块坐标,而非区块坐标。例如,100,200 表示方块 X=100 和方块 Z=200。坐标会被转换为它们所触及的区块。半径值以区块为单位;一个区块等于 16 个方块。/radius 创建正方形,/circle 创建以距离中心区块的区块距离测量的圆形足迹。

区域名称长度为 1–32 个字符,仅限字母、数字、下划线或连字符。导出文件名为 1–64 个字符,仅限字母、数字、下划线或连字符。在世界中单独设置中心;它仅对设置它的玩家私有。

? 权限

每个命令都有独立的权限节点。默认情况下,加载和只读命令授予基本访问权限;区域管理命令默认仅限操作员使用。

  • chunkpreloader.command.start, .center, .radius, .cancel, .list, .info, .status
  • chunkpreloader.command.unload, .rename, .resize, .export, .import, .backup, .reload
  • chunkpreloader.notifications:当 notifications.enabled 为 true 时接收通知。
  • chunkpreloader.admin:授予管理员权限,并绕过玩家特定的区域上限。
  • chunkpreloader.limit.<size>:授予匹配的已配置区域大小层级(例如 chunkpreloader.limit.5000)。

服务器配置的每世界限制是所有玩家的上限。如果没有 chunkpreloader.admin,有效限制是该上限与玩家默认或授予层级的较小值。

⚙️ 配置

默认的 config.yml 如下:

enabled-worlds:
  - world
  - world_nether
  - world_the_end

performance:
  # 每个活动任务每秒最多强制加载的区块数
  chunks-per-tick: 100
  # 区域可能包含的最大已保存/加载区块数
  max-area-size: 10000
  # 在开始大型加载前警告玩家
  show-warnings: true

auto-unload:
  # 如果区域没有玩家活动,则释放强制加载的区块
  enabled: false
  # 不活跃超时时间(分钟)
  timeout: 1440

autosave:
  # 每隔多少秒保存管理的区域定义
  interval: 300

notifications:
  # 当加载完成/失败或区域自动卸载时,通知有权限的在线玩家
  enabled: false

permissions:
  # 没有提升大小权限的玩家的最大区域大小
  default-max-area-size: 1000
  # 可通过 chunkpreloader.limit.<size> 获得的额外区块限制
  area-size-limits:
    - 5000
    - 10000

world-specific:
  world:
    max-area-size: 10000
    chunk-load-speed: 100
  world_nether:
    max-area-size: 5000
    chunk-load-speed: 50
  world_the_end:
    max-area-size: 5000
    chunk-load-speed: 50
  • enabled-worlds: 允许区域加载和恢复的世界。
  • performance.chunks-per-tick: 服务器每个刻(tick)处理加载的最大区块数默认值。数值越大,完成加载越快,但会增加服务器每个刻的工作量。
  • performance.max-area-size: 单个区域的最大区块数默认值;也是各世界限制的上限。
  • performance.show-warnings: 当加载区域超过玩家有效区域限制的一半时,向玩家发出警告。
  • auto-unload.enabled: 在区域空闲后释放其活跃区块的内存占用。已保存的区域定义仍会保留,当玩家返回该区域时可再次恢复。
  • auto-unload.timeout: 释放前无操作的时间长度,单位为分钟。
  • autosave.interval: 保存区域数据的时间间隔,单位为秒;低于 10 秒的值将被调整为 10。
  • notifications.enabled: 向拥有 chunkpreloader.notifications 权限且在线的玩家发送加载成功/失败通知以及自动卸载提示。
  • permissions.default-max-area-size: 未配置大小层级权限的玩家所能拥有的最大区块数上限。
  • permissions.area-size-limits: 可用的区域大小层级,对应权限为 chunkpreloader.limit.<size>。
  • world-specific.<world>.max-area-size: 指定世界的最大区域大小(以区块数计)。
  • world-specific.<world>.chunk-load-speed: 指定世界每刻处理的区块批次大小,覆盖全局批次设置。

当插件启动或重载时,无效或过小的安全设置会被钳制到安全的最小值。

? 已保存的区域与备份

区域定义会自动保存并在重启后恢复。若启用了空闲卸载功能,区块会被释放,但区域定义仍会保留;进入该区域范围可重新启动恢复过程。区域导出文件存储在插件的 exports 文件夹中,执行 /cpl backup 命令会将带时间戳的数据备份写入其 backups 文件夹。

由多个受管理区域共享的区块将保持强制加载状态,直到最后一个拥有该区块的区域被卸载为止。如果某个区块在插件开始管理之前就已存在强制加载设置,则当插件停止管理该区块时,原有的强制加载设置将会被恢复。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源