OptiFoundry

Smart server optimization with powerful control tools.
Reduce lag, clean entities, and take full control over game ticks.

---

✅ Compatibility

• Platforms: Spigot / Paper / Purpur
• Minecraft: 1.12 → 1.21.6
• Server-side only: no client mods required

---

✨ Features

Feature	Description
🚀 Performance	Optimized handling of entities, items, and chunks.
⏱ Tick control	Freeze, unfreeze, step, sprint/boost, set tick rate, live TPS query.
🧹 Entity cleanup	/opti kill filters (items, mobs, armor stands, TNT, boats, carts, players, all).
🗺 Chunk sweeping	Unload idle chunks safely (spawn and forceload aware).
📊 Status helpers	Quick stats for entities, chunks, and TPS.
🧩 Wide version support	Works from 1.12 up to 1.21+.

---

🖥 Commands

/opti help
/opti status
/opti reload
/opti chunksweep              # unload idle chunks
/opti itemsweep               # sweep dropped items
/opti toggle <chunk|items> <on|off>

Entity cleanup

/opti kill [radius ]

types: items, mobs, animals, villagers, golems, armorstands, tnt, boats, minecarts, bosses, players, entities, all, or

/optick query # show tick info (TPS, rate, frozen) /optick rate <1-10000> # set target tick rate (default 20) /optick freeze | unfreeze /optick step | step stop /optick sprint | sprint stop

⚠ **Note:**  
Since Minecraft **1.20.3**, vanilla already adds `/tick`.  
OptiFoundry therefore uses **`/optick`** as a safe alias.

---

## 🔐 Permissions

| Permission           | Default | Description                       |
|----------------------|:-------:|-----------------------------------|
| `optifoundry.use`    |   op    | Access to `/opti` commands        |
| `optifoundry.kill`   |   op    | Allows `/opti kill ...`           |
| `optifoundry.tick`   |   op    | Allows `/optick ...` tick control |

---

## 🛠 Installation

1. Download the latest **OptiFoundry** JAR.  
2. Place it into your server’s `plugins/` folder.  
3. Start (or restart) the server.  
4. *(Optional)* Edit `plugins/OptiFoundry/config.yml` and run `/opti reload`.

---

## ⚙️ Default config (excerpt)

```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: []