🚀 CollisionToggle

Full control over mob and player collisions — one command, zero restarts.

A lightweight Bukkit/Paper plugin that instantly toggles entity collisions in every world. No external dependencies, no TPS impact, no compromises.

---

✨ What you get

• ⚡ Instant changes — applies immediately to all existing entities across all worlds. No restart needed.
• 🔄 Automatic inheritance — new players and freshly spawned mobs instantly pick up active settings.
• 💾 Persistent config — state saves to config.yml and survives server restarts.
• ⌨️ Tab-completion — argument hints in console and chat. Fast, no typos.
• 🔐 Permissions — access control via collisiontoggle.use (OP by default).
• 🪶 Clean code — zero external dependencies, pure native Bukkit API.

---

🛠️ How it works

Entity	Mechanism	TPS impact
Players	Native COLLISION_RULE scoreboard team rule	Zero
Mobs	LivingEntity#setCollidable() on all living entities (except players)	Minimal

---

📋 Requirements

• Platform: Paper / Purpur / Spigot / Bukkit 1.21+
• Java: 21+

---

💬 Commands

/collision on mobs      # Enable mob collision
/collision off mobs     # Disable mob collision
/collision on players   # Enable player collision
/collision off players  # Disable player collision
/collision on all       # Enable all collisions
/collision off all      # Disable all collisions

---

🔐 Permissions

Permission	Description	Default
collisiontoggle.use	Access to /collision command	OP

---

💡 Use cases

• Mob farms — disable mob collisions so they don't block or push each other.
• PvP events — enable player collisions only where you want them.
• Tight corridors — off for mobs = no traffic jams.
• Redstone / AFK — zero TPS impact, so you can leave it on permanently.

---

Install: drop the JAR into plugins/, restart once, then use commands only.
Config: plugins/CollisionToggle/config.yml — state saves automatically.

Simple. Light. Under control. 🚀

---

🚀 CollisionToggle (Polski)

Pełna kontrola nad kolizjami mobów i graczy — jedna komenda, zero restartów.

Lekki plugin Bukkit/Paper, który natychmiast przełącza kolizje encji w każdym świecie. Bez zewnętrznych zależności, bez wpływu na TPS, bez kompromisów.

---

✨ Co zyskujesz?

• ⚡ Natychmiastowe zmiany — działa od razu na wszystkich istniejących encjach, we wszystkich światach. Żadnego restartu.
• 🔄 Automatyczne dziedziczenie — nowi gracze i świeżo zaspawnione moby od razu łapią aktywne ustawienia.
• 💾 Trwała konfiguracja — stan zapisuje się w config.yml i przetrwa restart serwera.
• ⌨️ Tab-completion — podpowiedzi argumentów w konsoli i na czacie. Szybko i bez literówek.
• 🔐 Uprawnienia — kontrola dostępu przez collisiontoggle.use (domyślnie OP).
• 🪶 Czysty kod — zero zależności zewnętrznych, wyłącznie natywne Bukkit API.

---

🛠️ Jak to działa?

Encja	Mechanizm	Wpływ na TPS
Gracze	Natywna reguła COLLISION_RULE drużyny scoreboardowej	Zerowy
Moby	LivingEntity#setCollidable() na wszystkich żywych bytach (poza graczami)	Minimalny

---

📋 Wymagania

• Silnik: Paper / Purpur / Spigot / Bukkit 1.21+
• Java: 21+

---

💬 Komendy

/collision on mobs      # Włącz kolizję mobów
/collision off mobs     # Wyłącz kolizję mobów
/collision on players   # Włącz kolizję graczy
/collision off players  # Wyłącz kolizję graczy
/collision on all       # Włącz wszystkie kolizje
/collision off all      # Wyłącz wszystkie kolizje

---

🔐 Uprawnienia

Uprawnienie	Opis	Domyślnie
collisiontoggle.use	Dostęp do komendy /collision	OP

---

💡 Przykłady użycia

• Farmy mobów — wyłącz kolizje mobów, żeby się nie blokowały i nie wypychały.
• Eventy PvP — włącz kolizje graczy tylko tam, gdzie chcesz.
• Ciasne korytarze — off dla mobów = brak zatorów.
• Redstone / AFK — brak wpływu na TPS, więc możesz zostawić na stałe.

---

Instalacja: wrzuć JAR do plugins/, zrestartuj raz, potem już tylko komendami.
Config: plugins/CollisionToggle/config.yml — stan zapisuje się automatycznie.

Prosto. Lekko. Pod kontrolą. 🚀