AzLagControl

插件

· 作者 Light0mxph

Azlagcontrol Minecraft 服务器优化插件

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

最新 1.2.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

AzLagControl

Minecraft 服务器的专业延迟控制套件 —— 由 AztrixDigitalStudio 开发

AzLagControl 是一个面向 Paper/Spigot 服务器的模块化性能工具包。其核心理念是预防优先,清理为辅:它不仅仅是在损害发生后删除实体,而是主动限制导致延迟的系统(如红石、漏斗、爆炸和怪物过剩),同时提供智能的计划清理、实时性能监控以及当服务器 TPS 崩溃时自动触发的紧急模式。

每个模块完全独立——只需启用你需要的部分。所有配置均可通过 /azlag reload 热重载。


功能特性

模块 功能说明
智能清理器 (Smart Cleaner) 计划性与手动清理掉落的物品、箭矢、投射物,以及可选的怪物/载具。支持倒计时警告、世界过滤和丰富的保护规则(指定名称、驯服、拴绳、乘客、Boss、近期玩家掉落等)。
智能怪物控制 (Smart Mob Control) 按类别限制每个区块的怪物数量(动物、怪物、村民、水生生物、环境生物)。对超过限制的区块进行定期溢出清除。支持 Boss 白名单。
智能物品控制 (Smart Item Control) 按区块限制地面物品上限,合并附近物品,可配置的消失时间,以及定期物品清理。
红石控制 (Redstone Control) 限制每个区块过多的红石状态变化并检测红石时钟。操作选项包括:LOG(记录)、THROTTLE(节流)或 ALERT(通知管理员)。
漏斗控制 (Hopper Control) 通过可配置的传输刻速率降低漏斗的 Tick 开销,可选按区块限制漏斗数量,并在 TPS 低于阈值时自动禁用。
爆炸控制 (Explosion Control) 限制每 Tick 的爆炸次数、每个区块的 TNT 实体数量和每个区块的苦力怕数量。对于大型 TNT 农场,可选减少方块破坏。
区块控制 (Chunk Control) 定期分析区块健康状态,追踪最差的 N 个区块,并在区块实体数超过阈值时通知管理员。
性能监控 (Performance Monitor) 实时采样 TPS、MSPT 和内存使用情况,具有滚动历史记录和可配置的警告/严重警报。
紧急模式 (Emergency Mode) 在 TPS 严重下降时自动激活。降低视距、停止怪物生成、激进地清除实体、移除 TNT,并可选禁用漏斗——一旦 TPS 恢复则自动停用。
数据分析 (Analytics) 保留性能样本的滚动历史记录,并可将快照记录到文件中。

依赖要求

  • 服务器: Paper 1.20+(全程使用 Spigot 兼容 API;api-version 为 1.20)
  • Java: 17 或更高版本
  • 可选集成: PlaceholderAPI、spark

该插件无需任何可选依赖即可完全运行。


安装指南

  1. 从 Modrinth、SpigotMC 或 Releases 页面 下载 AzLagControl-x.y.z.jar。
  2. 将 jar 文件放入服务器的 plugins/ 文件夹中。
  3. 重启(或重新加载)服务器。
  4. 根据需要编辑 plugins/AzLagControl/config.yml,然后运行 /azlag reload。

命令列表

基础命令:/azlagcontrol,别名 /azlag 和 /alc。

命令 描述
/azlag stats 显示完整服务器统计信息
/azlag tps 显示 TPS(1分钟 / 5分钟 / 15分钟)
/azlag mspt 显示每 Tick 毫秒数
/azlag memory 显示 JVM 内存使用情况
/azlag entities 显示各世界的实体数量
/azlag chunks [analyze] 显示区块统计信息
/azlag cleanup 立即触发手动清理
/azlag reload 重新加载配置
/azlag emergency <on|off|status> 管理紧急模式
/azlag diagnose 全面系统诊断
/azlag profiler [last N] 显示性能历史记录
/azlag help 列出可用命令

权限节点

权限 描述 默认值
azlagcontrol.admin 完全管理访问权限(授予以下所有权限) op
azlagcontrol.use 基本命令访问权限(统计、TPS) op
azlagcontrol.reload 重新加载插件配置 op
azlagcontrol.stats 查看服务器性能统计信息 op
azlagcontrol.cleanup 触发手动实体/物品清理 op
azlagcontrol.emergency 激活/停用紧急模式 op
azlagcontrol.diagnose 运行服务器诊断 op
azlagcontrol.profiler 访问性能分析器 op

PlaceholderAPI 支持

安装 PlaceholderAPI 后,azlagcontrol 扩展会自动注册。

占位符 输出内容
%azlagcontrol_tps% 当前 TPS
%azlagcontrol_tps_1m% TPS — 1 分钟平均值
%azlagcontrol_tps_5m% TPS — 5 分钟平均值
%azlagcontrol_tps_15m% TPS — 15 分钟平均值
%azlagcontrol_tps_colored% TPS,根据健康状况着色
%azlagcontrol_mspt% 每 Tick 毫秒数
%azlagcontrol_memory_used% 已用 JVM 内存
%azlagcontrol_memory_max% 最大 JVM 内存
%azlagcontrol_memory_pct% 内存使用百分比
%azlagcontrol_entities% 实体总数
%azlagcontrol_items% 地面物品数量
%azlagcontrol_chunks% 已加载区块数量
%azlagcontrol_emergency% 紧急模式状态

开发者 API

AzLagControl 会触发其他插件可以监听到的 Bukkit 事件:

  • AzCleanupEvent — 在清理运行时触发。
  • AzEmergencyModeChangeEvent — 在紧急模式切换时触发。
@EventHandler
public void onEmergency(AzEmergencyModeChangeEvent event) {
    // 响应紧急模式的变化
}

配置文件

首次运行时会自动生成带有大量注释的完整 config.yml。重点如下:

  • core — 调试开关、消息前缀、更新检查。
  • cleaner — 间隔时间、警告次数、清理对象、保护规则、按世界范围设置。
  • mob-control — 按区块分类上限、溢出清除、白名单。
  • item-control — 按区块数量上限、合并半径、自然消失寿命。
  • redstone — 红石更新上限、时钟检测及处理。
  • hopper — 刻率、按漏斗上限、TPS 自动禁用。
  • explosion — 每秒上限、TNT/苦力怕上限、方块伤害减免。
  • chunk-control — 分析间隔、Top-N 追踪、告警阈值。
  • monitor — 采样频率、历史记录大小、TPS 告警阈值。
  • emergency — TSP 自动激活/禁用、操作、消息提示。
  • analytics — 历史窗口、文件日志记录。
  • integrations — PlaceholderAPI、spark 开关。

所有相关部分均支持 worlds: [](留空表示所有世界),且每个模块都有独立的 enabled 标志。


从源码构建

git clone https://github.com/Light0mxph/AzLagControl.git
cd AzLagControl
./gradlew build

生成的 shaded jar 包位于 build/libs/AzLagControl-<version>.jar。


许可证

本项目依据 GNU General Public License v3.0 许可。详见 LICENSE。


致谢

由 AztrixDigitalStudio 开发并维护。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源