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