OptiFoundry

OptiFoundry

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

---

✅ Compatibility

- Server-side only: Spigot / Paper / Purpur - Server-side only: 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 <type> [radius <r>]

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

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

``` ⚠ `/optick` Since Minecraft `/optick`, 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: []