转载 开源 工具 GrimLag 1.2

[MD]
# GrimLag

> 能根据服务器负载自适应调控的卡顿管理插件。

GrimLag 是一款面向 Paper 服务端的性能管理插件，能够感知服务器卡顿情况并动态采取措施。它不会频繁清理实体，不会一发现压力就破坏农场，也不会把卡顿简单归咎于玩家。

插件会持续观察服务器状态，判断实际负载程度，再逐步采取相应的优化策略。

核心思路是**控制损害，而不是一刀切地破坏内容**。

> 未来将推出同时兼容单人游戏与多人游戏的 Fabric 模组版本。

## 功能介绍

### 自适应卡顿阶段

GrimLag 会持续监控服务器性能，并在以下四个内部状态之间自动切换：

| 阶段 | 说明 |
|---|---|
| `HEALTHY` | 服务器运行正常，不进行额外限制。 |
| `WARNING` | 开始实施轻度干预。 |
| `DEGRADED` | 启用更积极但仍尽量公平的限制措施。 |
| `CRITICAL` | 进入高负载应急模式。 |

插件不会突然切换到极端限制，也不会立即惩罚玩家。各项限制会随着负载升高逐渐加强，并在服务器恢复后平缓撤销。

### 实体 AI 限流与自动恢复

当服务器出现明显卡顿时，GrimLag 会选择性暂停部分生物的 AI，以降低 CPU 负载。

服务器性能恢复后，插件会自动重新启用 AI。

生物不会永久失去行为能力；这不是把整个世界变成静态展览馆。

### 刷怪笼速率调节

插件会依据当前卡顿阶段动态调整刷怪笼的生成效率：

- 服务器负载较高时，刷怪笼会降低生成速度；
- 性能恢复后，刷怪笼会逐步回归正常行为；
- 不会因卡顿而粗暴地全局关闭所有刷怪笼。

### 分区块实体数量控制

GrimLag 按**区块**限制实体过度聚集，而不是在全服范围内进行统一清除。

- 优先采用软性数量限制；
- 仅在确有必要时启用硬性上限；
- 不会移除玩家；
- 高优先级实体拥有更长的保留时间；
- 仅处理实体过度拥挤的区块，不会影响整个世界的正常活动。

### 感知卡顿的红石限流

发生卡顿时，插件会通过概率式限流降低红石活动频率。

- 红石装置仍然可以工作；
- 只是当服务器负载过高时，不会保证每个游戏刻都完整触发；
- 在减少卡顿的同时，尽可能避免大型红石装置完全失效。

这是一种有意为之、但尽量温和的性能干预措施。

### 掉落物生命周期管理

GrimLag 不会简单粗暴地清空地面掉落物，而是按以下顺序处理：

1. 尽可能合并可堆叠的掉落物；
2. 在服务器卡顿时加快旧掉落物的老化速度；
3. 仅在必要时移除过量掉落物。

服务器能够获得有效清理，同时避免造成大规模物品消失。

### 柔性恢复机制

随着服务器性能改善，GrimLag 会自动撤销此前启用的限制：

- 恢复生物 AI；
- 将刷怪笼效率调整回正常水平；
- 恢复完整的红石行为；
- 放宽实体消失规则。

任何限制都不会持续超过实际需要的时间。

## 设计理念

- 适应负载，而非遇到问题就恐慌；
- 限流调控，而非直接清空；
- 自动恢复，无需频繁人工干预；
- 保持可预期性，避免过度激进。

GrimLag 适合需要长期稳定运行的生存服务器，而不是只追求短期跑分表现的测试环境。

## 运行环境

- 推荐服务端：Paper
- Java：Java 17 或更高版本
[/MD]