⚡ Trixinity-Event Plugin

Trixinity-Event je specializovaný plugin pro správu herních eventů na Minecraft serverech, který nabízí přehledné příkazy, automatizované úkony a integraci s klíčovými serverovými pluginy.

Status	Hodnota	Zdroj
Verze	v1.0.0
API Verze	1.21
Autor	BabyMsp2k

---

🧩 Požadované pluginy

Povinné závislosti

• WorldGuard: Používá se pro přepínání flagů (build, pvp) v regionu EVENT.

Doporučené / Soft Dependencies

• PlaceholderAPI: Umožňuje zobrazení aktuálního statusu eventu a jména Eventera.
• LuckPerms: Plugin využívá příkazy /lp user... pro nastavení role Eventer.
• WorldEdit: Zmiňován v nápovědě pro administrátory pro úpravy event arén.

---

⚙️ Příkazy

Všechny příkazy pro správu eventů vyžadují oprávnění trixinity.event.admin nebo op.

Příkaz	Popis	Oprávnění
/trixinity	Zobrazí základní informace o pluginu (verze, autor).	trixinity.admin (op)
/event (alias: /e)	Hlavní příkaz pro správu eventů.	trixinity.event.admin (op)
/eventer <nick>	Nastaví hráče jako Eventera (pomocí LuckPerms role eventer) a uloží do konfigurace.	* (pouze pro administrátory)
/cleareventer	Vymaže současného Eventera a vrátí jeho LuckPerms roli na default.	* (pouze pro administrátory)

Sub-příkazy /event

Sub-příkaz	Popis	Klíčové akce
pripravuje	Nastaví status eventu na "Připravuje se" a vypne whitelist.	whitelist off
start	Nastaví status na "Začal", zapne whitelist a zaplní oblast železnými mřížemi.	whitelist on, /fill ... iron_bars
end	Nastaví status na "Skončil" a resetuje oblast bloků.	/fill ... air, /fill ... iron_bars
event spleef	Spustí Spleef event: naplní arénu sněhovými bloky a dá hráčům zlatou lopatu s Efficiency III.	Připraví Spleef arénu.
build <on/off>	Povolí/zakáže stavění v regionu WorldGuardu s názvem __global__ ve světě EVENT.	WorldGuard flag build
pvp <on/off>	Povolí/zakáže PvP v regionu WorldGuardu s názvem __global__ ve světě EVENT.	WorldGuard flag pvp

---

🏗️ Struktura projektu

Projekt používá standardní Gradle strukturu pro Minecraft pluginy s využitím Wrapperu a GitHub Actions pro CI.

.
├── .github/ # Konfigurace pro GitHub, CI/CD, Issues a Bots
│ ├── actions/
│ │ └── common-setup/ # Společné nastavení Javy pro Workflows
│ ├── CODEOWNERS
│ ├── CONTRIBUTING.md # Pokyny pro přispívání
│ ├── dependabot.yml # Konfigurace pro automatické aktualizace závislostí
│ ├── ISSUE_TEMPLATE/
│ ├── stale.yml # Konfigurace pro Probot: Stale
│ └── workflows/ # Workflows pro Testy, Releasy a Notifikace
├── build.gradle # Hlavní konfigurační soubor Gradle (závislosti, ShadowJar, Checkstyle)
├── config/
│ └── checkstyle/
│ └── checkstyle.xml # Konfigurace pro kontrolu stylu (Google Java Style)
├── CODE_OF_CONDUCT.md # Kodex chování pro přispěvatele
├── gradle/
│ └── wrapper/
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew # Skript pro spuštění Gradle na Linuxu/macOS
├── gradlew.bat # Skript pro spuštění Gradle na Windows
├── LICENSE # Licence projektu (GNU GPL v3)
├── README.md # Tento soubor
├── settings.gradle # Nastavení názvu projektu (Trixinity-Event)
└── src/
├── main/
│ ├── java/
│ │ └── dev/trixinity/event/
│ │ ├── commands/ # Logika pro /event, /eventer, /cleareventer
│ │ ├── placeholders/ # Implementace PlaceholderAPI
│ │ └── TrixinityEvent.java # Hlavní třída pluginu
│ └── resources/
│ ├── config.yml # Výchozí konfigurační soubor
│ └── plugin.yml # Metadata pluginu a definice příkazů
└── test/
└── java/ # Testy (aktuálně obsahuje pouze prázdný testovací soubor)

---

💖 Credits

Plugin Trixinity-Event vytvořil s ❤️ BabyMsp2k.