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 <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

⚠ 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)

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