Minecraft plugin eco

🔌 O eco

eco je vývojová knihovna pro Spigot (samostatný Minecraft plugin), která je navržená tak, aby zjednodušila vývoj pluginů a poskytla znovupoužitelné engine funkce pro další pluginy. Nabízí API pro příkazy a konfiguraci, adaptéry pro perzistentní úložiště, systémy GUI a vlastních předmětů a také řadu integrací, aby autoři pluginů mohli znovu používat běžnou funkcionalitu místo její opětovné implementace.

🎯 Účel

eco existuje proto, aby centralizovalo běžné systémy, které moderní pluginy potřebují na straně vývojáře: parsování příkazů, formáty barev a zpráv, formáty konfigurace, přístup k perzistentním datům, komponenty GUI, práci s předměty a integrace s dalšími server-side systémy. Je určeno autorům pluginů, kteří chtějí rychle vytvářet funkce na nadstavbě udržovaného sdíleného frameworku.

⚙️ Funkce

• Moderní API příkazů a parsování
• Nativní parsování barev s podporou hex / RGB / MiniMessage
• Konfigurační systém podporující YAML, JSON a TOML
• API pro perzistentní datové úložiště s backendy YAML, MySQL a MongoDB
• API pro GUI a předpřipravené komponenty
• Vlastní předměty a extrémně rychlé zpracování ItemStack
• Zobrazení předmětů přes packety a lehká packet event loop
• API AI entit s téměř 1:1 mapováním NMS
• Placeholder API a nativní integrace (projektem je uvedeno více než 30 integrací)
• Abstrakce ceny/ekonomiky (cenový systém podporující economy pluginy, XP a předměty)
• Nativní podpora bStats a kontrola aktualizací pluginu
• Systém rozšíření (pluginy pro pluginy) a nástroje dependency injection pro vývojáře

🧩 Pro koho to je

• Vývojáře pluginů, kteří vytvářejí pluginy kompatibilní se Spigot/Paper a chtějí znovupoužitelný framework
• Majitele serverů, kteří provozují pluginy závislé na eco (eco musí být nainstalováno jako závislost)
• Projekty, které vyžadují vlastní předměty, GUI nebo sjednocené nástroje pro úložiště a příkazy

🏗️ Příklady použití

• Vývojář vytvoří vlastní balíček předmětů, který používá eco API pro vyhledávání předmětů a GUI.
• Plugin používá storage API z eco, aby podporoval lokální YAML i vzdálený MongoDB backend bez duplikace kódu.
• Několik menších pluginů sdílí eco pro konzistentní zpracování příkazů a parsování barev.

⚙️ Instalace

📥 Nastavení

• Nainstalujte eco jako plugin na jakýkoli server, který ho potřebuje, tak, že umístíte JAR do složky plugins/ na serveru a server restartujete.
• Pokud jiný plugin na eco závisí, uveďte to v plugin.yml daného pluginu v depend: pomocí - eco, aby server načetl eco jako první.

📦 Závislost (pro vývojáře pluginů)

• Projekt publikuje Maven repository a Gradle souřadnice pro použití compile-only. Projekt nabízí publikovaný artifact (například se skupinou com.willfp a verzovacími tagy), aby vývojáři přidali eco jako provided dependency během buildu.

🧠 Technické poznámky

• Podporovaný serverový software: oficiální projekt uvádí podporu pro Spigot, Paper, Purpur a Folia.
• Podporované verze Minecraftu: projekt uvádí podporu od verze 1.21.4 a pozdější buildy cílí na moderní řadu 1.21.x.
• Úložiště: framework poskytuje adaptéry YAML, MySQL a MongoDB.
• Licence: eco je vydáno pod licencí MIT.

🤝 Kdy je tento plugin užitečný

Pokud vyvíjíte více funkcí nebo pluginů, které sdílejí stejné potřeby (příkazy, formáty konfigurace, komponenty GUI, úložiště, vlastní předměty), eco snižuje duplicitní práci tím, že poskytuje udržovaný framework a integrace, na které mohou jiné pluginy spoléhat.