⚡ Overclock
减少卡顿,不影响玩法。
怪物农场、村民大厅和物品堆积是大多数服务器上 TPS 下降的最大杀手。常见的修复方法要么清除地面上的所有实体,要么冻结怪物直到你的农场停止工作。
Overclock 采取了更智能的方法。 它会实时监控服务器的 Tick 时间,仅在服务器真正吃力时才介入。它会减缓远处和拥挤区域怪物的 AI,并清理物品堆积,同时农场、命名实体和贵重物品不受影响。
? 智能怪物 AI
- 仅在需要时生效。 Overclock 每个 Tick 读取你的 MSPT(每 Tick 毫秒数),并在 ? 正常、? 警告 和 ? 严重 状态之间切换。当服务器健康时,它不做任何改变。
- 感知距离与密度。 远离玩家的怪物,或挤在密集区块中的怪物,思考频率降低:每 2、4 或 8 个 Tick 思考一次,而不是每个 Tick 都思考。靠近玩家的怪物保持完整 AI。
- 仅减速大脑。 寻路和目标是限速的。重力、水流、伤害、自然消失、繁殖和生长等机制仍以全速运行。
- 无卡住怪物。 被限速的怪物以短促的爆发方式醒来,其中总是包含一个完整的决策步骤,因此它们永远不会原地冻结或忘记自己在做什么。
- 瞬间唤醒。 攻击、喂食、交易、拴绳或被限速怪物追逐时,它会立即恢复完整 AI。
?️ 农场保护
Overclock 旨在绝不让玩家构建的设施失效。以下情况始终保留原版 AI:
- ?️ 拥有名牌、驯服或拴绳的怪物
- ? 繁殖的动物和 ? 交易的猪灵
- ?? 正在交易的村民,以及在服务器达到严重状态之前的一般村民
- ⚔️ 正在战斗或追逐玩家的怪物
- ? 矿车和小船内的怪物,以及骑手
- ?️ 位于检测到的玩家农场内部的怪物。 漏斗、发射器、床和蜂巢会被自动识别。
- ? 使用
/tag <mob> add overclock.exempt 标记的任何实体
? 地面物品管理器
- 热点合并。 彼此靠近的相同掉落物会合并成完整的堆叠,但仅在繁忙地点如铁工厂收集器和分拣器溢出处进行。不会丢失任何东西;只是实体数量减少了。
- 仅修剪多余部分。 默认情况下,扫描仅触及堆积超过 64 个物品的区块,并优先移除最旧的物品。基地周围散落的一些物品绝不会受影响。偏好经典的全清模式?那只是一个设置选项。
- 玩家始终会收到警告。 每次扫描前都会在聊天中显示倒计时(60秒、30秒、10秒、5秒...),扫描后会有总结。扫描按定时器运行,物品堆积时会提前开始,或由工作人员手动启动。
- 贵重物品永远不会被删除:
- ? 下界合金、钻石、潜影盒、鞘翅、图腾等(完全可配置)
- ?️ 所有盔甲,以及改名、附魔和资源包物品
- ? 来自其他插件的自定义物品,通过其数据键匹配(例如
mmoitems:*)
- ☠️ 死亡掉落物,受 5 分钟保护
- ? 生成不到 60 秒的新鲜掉落物
- 其他插件也安全。 商店展示和全息图永远不会被合并或删除。
? 专为 Folia 和大服务器设计
- Folia 区域感知。 每个区域根据其自身的 Tick 时间进行评估,因此地图一侧卡顿的农场会被限速,而其他区域保持原版行为。
- 线程安全设计。 每个怪物、物品和区块都在拥有它的线程上处理。
- 清洁器本身不造成卡顿。 Overclock 从不扫描整个世界。工作按区域划分,并分散到小批量的 Tick 中。
- 崩溃安全。 如果服务器在限速过程中宕机,受影响的怪物在其区块加载时会自动恢复。
? 查看其工作状态
/overclock status 显示实时 MSPT、TPS、内存使用情况、有多少怪物被限速以及你每秒节省了多少 AI Tick。
/overclock items 显示每个世界的地面物品数量、最繁忙的热点和下一次扫描时间。
/overclock inspect 详细解释你当前注视的怪物为何被(或未被)限速。
? 命令与权限
| 命令 |
功能 |
权限 |
/overclock status |
实时性能概览 |
overclock.status |
/overclock inspect |
你注视的怪物的限速信息 |
overclock.inspect |
/overclock items |
地面物品数量和热点 |
overclock.items |
/overclock sweep |
启动带有警告倒计时的扫描 |
overclock.sweep |
/overclock sweep now / cancel |
立即扫描 / 取消倒计时 |
overclock.sweep |
/overclock pause / resume |
在测试期间给予所有怪物完整 AI |
overclock.toggle |
/overclock reload |
无需重启即可重新加载配置 |
overclock.reload |
| (聊天警报) |
加载状态变更警报 |
overclock.notify |
| (聊天警报) |
扫描警告和结果 (默认所有人可见) |
overclock.sweep.notify |
别名 /oc 同样有效。overclock.* 授予所有权限。除扫描通知外,所有权限默认赋予 OP。
⚙️ 配置
开箱即用效果极佳。每个选项都在 config.yml 中有详细说明,更新时新选项会自动添加到你的文件中。
配置预览
load-monitor:
warning-mspt: 40.0
critical-mspt: 47.0
throttling:
near-distance: 24
far-distance: 48
profiles:
warning: { near: 1, medium: 2, far: 4 }
critical: { near: 2, medium: 4, far: 8 }
ground-items:
merging:
radius: 2.5
sweeping:
mode: EXCESS # or ALL
excess-per-chunk: 64
interval-minutes: 15
warn-at-seconds: [60, 30, 10, 5, 3, 2, 1]
protection:
materials: ["NETHERITE_*", "DIAMOND*", "*SHULKER_BOX", ELYTRA, TOTEM_OF_UNDYING]
armor: true
enchanted: true
data-keys: ["mmoitems:*"]
? 安装方法
- 需要 Paper 1.21+ 或 Folia,并在 Java 21 上运行。
- 将 jar 文件放入
plugins 文件夹。
- 重启服务器。完成!
❓ 常见问题
它会破坏我的农场吗?
Overclock 的设计初衷就是不会破坏农场。基于物理的组件(水、漏斗、红石)永远不会被限制,重要生物受到保护,且农场区域会自动检测。你也可以使用 /overclock pause 来并排对比行为差异。
当服务器没有卡顿时会改变什么吗?
在 MSPT(每刻平均处理时间)上升之前,生物 AI 保持原版状态。物品合并和清扫仅对真实堆积生效。
移除它安全吗?
安全。正常停止服务器并删除 jar 文件即可。在关闭时,每个生物都会恢复正常的 AI。
它支持 Spigot 吗?
不支持。Overclock 需要 Paper 或 Folia。
⚡ Overclock
Stop lag, not gameplay.
Mob farms, villager halls and item overflows are the biggest TPS killers on most servers. The usual fixes either delete everything on the ground or freeze mobs until your farms stop working.
Overclock takes a smarter approach. It watches your tick time live and steps in only when your server actually struggles. It slows the brains of distant and crowded mobs, and it cleans up item pileups, while farms, named mobs and valuable items stay untouched.
? Smart Mob AI
- Only acts when needed. Overclock reads your MSPT every tick and switches between ? Normal, ? Warning and ? Critical. While your server is healthy, it changes nothing.
- Distance and crowd aware. Mobs far from players, or packed into crowded chunks, think less often: every 2nd, 4th or 8th tick instead of every tick. Mobs near players keep full AI.
- Only the brain slows down. Pathfinding and target selection are throttled. Gravity, water streams, damage, despawning, breeding and growth all run at full speed.
- No stuck mobs. Throttled mobs wake in short bursts that always include a full decision step, so they never freeze in place or forget what they were doing.
- Instant wake-up. Hit, feed, trade with, leash or get chased by a throttled mob, and it gets full AI immediately.
?️ Farm Safeguard
Overclock is built to never break your players' builds. These always keep vanilla AI:
- ?️ Name-tagged, tamed and leashed mobs
- ? Breeding animals and ? bartering piglins
- ?? Villagers in a trade, and villagers in general until the server is critical
- ⚔️ Mobs that are fighting or chasing a player
- ? Mobs in minecarts and boats, and jockeys
- ?️ Mobs inside detected player farms. Hoppers, dispensers, beds and beehives are recognized automatically.
- ? Anything you tag with
/tag <mob> add overclock.exempt
? Ground Item Manager
- Hotspot merging. Identical dropped items near each other are combined into full stacks, but only in busy spots like iron farm collectors and sorter overflows. Nothing is lost; there are just fewer entities.
- Trims the excess only. By default, a sweep only touches chunks piled with more than 64 items and removes the oldest first. A few items lying around a base are never touched. Prefer a classic full clear? That's one setting.
- Players always get warned. A chat countdown runs before every sweep (60s, 30s, 10s, 5s...), and a summary follows afterwards. Sweeps run on a timer, start early when items pile up, or can be started by staff.
- Valuables are never deleted:
- ? Netherite, diamonds, shulker boxes, elytra, totems and more (fully configurable)
- ?️ All armor, plus renamed, enchanted and resource-pack items
- ? Custom items from other plugins, matched by their data keys (e.g.
mmoitems:*)
- ☠️ Death drops, protected for 5 minutes
- ? Fresh drops younger than 60 seconds
- Other plugins are safe too. Shop displays and holograms are never merged or removed.
? Built for Folia and big servers
- Region-aware on Folia. Each region is judged by its own tick time, so a lagging farm on one side of the map gets throttled while everywhere else stays vanilla.
- Thread-safe by design. Every mob, item and chunk is handled on the thread that owns it.
- No lag from the cleaner itself. Overclock never scans your whole world. Work is split by area and spread across ticks in small batches.
- Crash-safe. If the server goes down mid-throttle, affected mobs are restored automatically when their chunks load.
? See what it's doing
/overclock status shows live MSPT, TPS, memory, how many mobs are throttled and how many AI ticks per second you're saving.
/overclock items shows ground items per world, the busiest hotspots and the next sweep.
/overclock inspect explains exactly why the mob you're looking at is (or isn't) throttled.
? Commands & Permissions
| Command |
What it does |
Permission |
/overclock status |
Live performance overview |
overclock.status |
/overclock inspect |
Throttle info for the mob you look at |
overclock.inspect |
/overclock items |
Ground item counts and hotspots |
overclock.items |
/overclock sweep |
Start a sweep with a warning countdown |
overclock.sweep |
/overclock sweep now / cancel |
Sweep immediately / cancel a countdown |
overclock.sweep |
/overclock pause / resume |
Give all mobs full AI while you test |
overclock.toggle |
/overclock reload |
Reload the config without a restart |
overclock.reload |
| (chat alert) |
Load state change alerts |
overclock.notify |
| (chat alert) |
Sweep warnings and results (everyone by default) |
overclock.sweep.notify |
The alias /oc works too. overclock.* grants everything. All permissions except sweep notifications default to OP.
⚙️ Configuration
Works great out of the box. Every option is explained in config.yml, and new options are added to your file automatically when you update.
Config preview
load-monitor:
warning-mspt: 40.0
critical-mspt: 47.0
throttling:
near-distance: 24
far-distance: 48
profiles:
warning: { near: 1, medium: 2, far: 4 }
critical: { near: 2, medium: 4, far: 8 }
ground-items:
merging:
radius: 2.5
sweeping:
mode: EXCESS # or ALL
excess-per-chunk: 64
interval-minutes: 15
warn-at-seconds: [60, 30, 10, 5, 3, 2, 1]
protection:
materials: ["NETHERITE_*", "DIAMOND*", "*SHULKER_BOX", ELYTRA, TOTEM_OF_UNDYING]
armor: true
enchanted: true
data-keys: ["mmoitems:*"]
? Installation
- Requires Paper 1.21+ or Folia, running on Java 21.
- Drop the jar into your
plugins folder.
- Restart your server. That's it!
❓ FAQ
Will it break my farms?
Overclock is designed not to. Physics-based parts (water, hoppers, redstone) are never throttled, important mobs are protected, and farm areas are detected automatically. You can also use /overclock pause to compare behaviour side by side.
Does it change anything when my server isn't lagging?
Mob AI stays fully vanilla until MSPT rises. Item merging and sweeps only act on real pileups.
Is it safe to remove?
Yes. Stop your server normally and delete the jar. Every mob gets its normal AI back on shutdown.
Does it work with Spigot?
No. Overclock needs Paper or Folia.
评论 0
登录后参与评分
还没有评论,来抢沙发吧