Minecraft plugin eco

🔌 Over eco

eco is een Spigot-ontwikkelingsbibliotheek (een zelfstandige Minecraft-plugin) die is ontworpen om pluginontwikkeling eenvoudiger te maken en herbruikbare engine-functies te bieden voor andere plugins. Het biedt API's voor commando's en configuratie, adapters voor permanente opslag, GUI- en aangepaste itemsystemen, en tal van integraties, zodat pluginauteurs veelvoorkomende functionaliteit kunnen hergebruiken in plaats van alles opnieuw te implementeren.

🎯 Doel

eco bestaat om veelgebruikte ontwikkelaarsystemen die moderne plugins nodig hebben te centraliseren: het parseren van commando's, kleur- en berichtformaten, configuratieformaten, toegang tot persistente data, GUI-componenten, itemverwerking en integraties met andere server-side systemen. Het is bedoeld voor pluginauteurs die snel functies willen bouwen bovenop een onderhouden, gedeeld framework.

⚙️ Functies

• Moderne command API en parsing
• Ingebouwde kleurparsing met ondersteuning voor hex / RGB / MiniMessage
• Configuratiesysteem met ondersteuning voor YAML, JSON en TOML
• API voor permanente gegevensopslag met YAML-, MySQL- en MongoDB-backends
• GUI API en kant-en-klare componenten
• Aangepaste items en ultrasnelle ItemStack-verwerking
• Packet-gebaseerde itemweergave en een lichtgewicht packet event loop
• Entity AI API met bijna 1-op-1 NMS-mappings
• Placeholder API en native integraties (door het project worden 30+ integraties genoemd)
• Prijs-/economie-abstrahering (prijssysteem dat economy-plugins, XP en items ondersteunt)
• Native bStats-ondersteuning en controle op plugin-updates
• Extensiesysteem (plugins voor plugins) en dependency-injection-tools voor ontwikkelaars

🧩 Voor wie is het

• Pluginontwikkelaars die Spigot/Paper-compatibele plugins bouwen en een herbruikbaar framework willen
• Servereigenaren die plugins draaien die afhankelijk zijn van eco (eco moet als dependency geïnstalleerd zijn)
• Projecten die aangepaste items, GUI's of uniforme tools voor opslag en commando's nodig hebben

🏗️ Voorbeelden van gebruik

• Een ontwikkelaar maakt een aangepaste item pack die gebruikmaakt van eco's item lookup- en GUI-API's.
• Een plugin gebruikt eco's storage API om zowel lokale YAML als een externe MongoDB-backend te ondersteunen zonder code te dupliceren.
• Meerdere kleine plugins delen eco voor consistente commandverwerking en kleurparsing.

⚙️ Installatie

📥 Setup

• Installeer eco als plugin op elke server die het nodig heeft door het JAR-bestand in de map plugins/ van de server te plaatsen en de server opnieuw op te starten.
• Als een andere plugin afhankelijk is van eco, vermeld dit dan in plugin.yml onder depend: met - eco, zodat de server eco eerst laadt.

📦 Afhankelijkheid (voor pluginontwikkelaars)

• Het project publiceert een Maven-repository en Gradle-coördinaten voor gebruik als compile-only. Het project biedt een gepubliceerd artifact aan (bijvoorbeeld met group com.willfp en versietags), zodat ontwikkelaars eco tijdens het bouwen als provided dependency toevoegen.

🧠 Technische notities

• Ondersteunde serversoftware: het officiële project geeft ondersteuning aan voor Spigot, Paper, Purpur en Folia.
• Ondersteunde Minecraft-versies: het project vermeldt ondersteuning vanaf 1.21.4 en latere builds richten zich op de moderne 1.21.x-serie.
• Opslagback-ends: YAML-, MySQL- en MongoDB-adapters worden door het framework geleverd.
• Licentie: eco is uitgebracht onder de MIT-licentie.

🤝 Wanneer deze plugin nuttig is

Als je meerdere functies of plugins ontwikkelt die dezelfde behoeften hebben (commando's, configuratieformaten, GUI-componenten, opslag, aangepaste items), vermindert eco dubbel werk door een onderhouden framework en integraties te bieden waarop andere plugins kunnen vertrouwen.