# OptiFoundry
**智能服务器优化,配备强大的控制工具。**
减少延迟,清理实体,并完全控制游戏滴答。
---
## ✅ 兼容性
- **平台:** Spigot / Paper / Purpur
- **Minecraft:** 1.12 → 1.21.6
- **仅服务器端:** 不需要客户端模组
---
## ✨ 功能
| 功能 | 描述 |
|--------------------------------|-----------------------------------------------------------------------------|
| 🚀 性能 | 优化实体、物品和区块的处理。 |
| ⏱ 滴答控制 | 冻结、解冻、步进、冲刺/加速、设置滴答率、实时 TPS 查询。 |
| 🧹 实体清理 | `/opti kill` 过滤器(物品、生物、盔甲架、TNT、船、矿车、玩家、全部)。 |
| 🗺 区块清理 | 安全卸载空闲区块(考虑生成和强制加载)。 |
| 📊 状态助手 | 实体、区块和 TPS 的快速统计。 |
| 🧩 广泛版本支持 | 从 1.12 到 1.21+ 均可工作。 |
---
## 🖥 指令
```
/opti help
/opti status
/opti reload
/opti chunksweep # 卸载空闲区块
/opti itemsweep # 清理掉落的物品
/opti toggle
# 实体清理
/opti kill [radius ]
# types: items, mobs, animals, villagers, golems, armorstands, tnt, boats, minecarts, bosses, players, entities, all, or
/optick query # 显示滴答信息(TPS、速率、冻结)
/optick rate <1-10000> # 设置目标滴答率(默认 20)
/optick freeze | unfreeze
/optick step | step stop
/optick sprint | sprint stop
```
⚠ **注意:**
从 **1.20.3** 开始,原版已经添加了 `/tick`。
OptiFoundry 因此使用 **`/optick`** 作为安全的别名。
---
## 🔐 权限
| 权限 | 默认值 | 描述 |
|----------------------|:-------:|-----------------------------------|
| `optifoundry.use` | op | 访问 `/opti` 指令 |
| `optifoundry.kill` | op | 允许 `/opti kill ...` |
| `optifoundry.tick` | op | 允许 `/optick ...` 滴答控制 |
---
## 🛠 安装
1. 下载最新的 **OptiFoundry** JAR 文件。
2. 将其放入服务器的 `plugins/` 文件夹中。
3. 启动(或重启)服务器。
4. *(可选)* 编辑 `plugins/OptiFoundry/config.yml` 并运行 `/opti reload`。
---
## ⚙️ 默认配置 (节选)
```yaml
chunk-guardian:
enabled: true
scan-interval-ticks: 60
player-buffer-chunks: 1
respect-forceload: true
item-flow:
enabled: true
merge-radius: 2.5
max-stack: 64
ttl-seconds: 180
blacklist-materials: []
```