PerfGuard 性能优化插件

一个轻量无依赖的 Minecraft 服务器性能优化插件，一个插件管好 8 项性能优化，专为中小型生存服设计。

功能特性

• ⚡ 状态命令：/性能 一键查看 TPS / MSPT / 内存 / 在线 / 实体 / 掉落物 / 区块 / 怪物分布
• 🧹 掉落物周期清理：固定周期统一清理超时掉落物，贵重物品自动保护（可自定义清单），清理前倒计时提示
• 💎 经验球合并：1.5 格内的经验球自动合并，经验不损失、实体数减半
• 😴 怪物休眠：远离玩家 64 格的怪物禁用 AI 原地站立（最省性能），玩家靠近自动唤醒
• 🗑️ 闲置生物清理：远离玩家 128 格的怪物自动清除，保护命名怪 / Boss
• 🚫 怪物上限控制：每种怪物全服超过上限自动清除离玩家最远的，防刷怪塔怪物堆积
• 🧠 内存自动管理：内存占用超过阈值自动 GC 释放
• 📢 TPS 低报警：TPS 低于阈值控制台警告 + 全服广播，5 分钟最多一次

安装

1. 下载 perfguard-1.3.0.jar
2. 放入服务器 plugins/ 目录
3. 重启服务器或执行 reload
4. 完成！无任何前置依赖

命令

命令	权限	说明
/性能	所有玩家	查看服务器状态
/性能 重载	OP	重载配置

配置（plugins/PerfGuard/config.yml）

cleanup:
  item-timeout: 300     # 掉落物超时（秒），0=完全关闭
  interval: 60          # 清理周期（秒）
  protect-enabled: true # 贵重物品保护总开关
  protected-items:      # 保护清单，可自由添加
    - DIAMOND
    - NETHERITE_SCRAP
    - ENCHANTED_BOOK
    - GOLD_INGOT
merge-exp: true         # 经验球合并开关
idle-clean:
  enabled: true
  distance: 128         # 远离玩家 N 格清除
mob-sleep:
  enabled: true
  distance: 64          # 远离玩家 N 格休眠
mob-limit:
  enabled: true
  per-type: 200         # 每种怪全服上限
memory:
  auto-gc: true
  gc-threshold: 85      # 内存占用 % 超阈值自动 GC
monitor:
  tps-warn: 15.0        # TPS 报警阈值
  warn-interval: 300    # 报警最小间隔（秒）

兼容性

• Paper / Spigot / Purpur / Leaves 1.18+
• Java 17+
• 无任何前置依赖

作者

TinyAII 工作室

🇬🇧 English Version (click to expand)

PerfGuard Performance Plugin

A lightweight, dependency-free Minecraft server performance optimization plugin. 8 performance features in one plugin, designed for small and medium survival servers.

Features

• ⚡ Status Command: /perf shows TPS / MSPT / Memory / Players / Entities / Items / Chunks / Mob distribution
• 🧹 Item Cleanup: Periodic batch cleanup of timed-out dropped items, protected list for valuables, countdown notification before cleanup
• 💎 XP Orb Merging: Merge XP orbs within 1.5 blocks — no XP loss, half the entities
• 😴 Mob Sleeping: Mobs beyond 64 blocks disable AI and stand still (saves the most performance), wake up when players approach
• 🗑️ Idle Mob Cleanup: Remove mobs beyond 128 blocks from players, protects named mobs / bosses
• 🚫 Mob Limit: Cap mob count per type server-wide, removes the farthest ones (protects named/Boss/persistent)
• 🧠 Auto Memory Management: Auto GC when memory usage exceeds threshold
• 📢 TPS Alert: Console warning + server broadcast when TPS drops below threshold, max once per 5 minutes

Commands

Command	Permission	Description
/性能	Everyone	View server status
/性能 重载	OP	Reload config

Compatibility

• Paper / Spigot / Purpur / Leaves 1.18+
• Java 17+
• No dependencies

Author

TinyAII Studio