Minecraft-plugin eco

🔌 Om eco

eco er et Spigot-udviklingsbibliotek (et selvstændigt Minecraft-plugin), der er designet til at gøre plugin-udvikling enklere og levere genanvendelige engine-funktioner til andre plugins. Det tilbyder API'er til kommandoer og konfiguration, adapters til vedvarende lagring, systemer til GUI og brugerdefinerede items samt mange integrationer, så plugin-forfattere kan genbruge fælles funktionalitet i stedet for at genimplementere den.

🎯 Formål

eco findes for at samle de almindelige udviklerrettede systemer, som moderne plugins har brug for: kommando-parsing, farve- og beskedformater, konfigurationsformater, adgang til vedvarende data, GUI-komponenter, item-håndtering og integrationer med andre server-side systemer. Det er tiltænkt plugin-forfattere, der vil bygge funktioner hurtigt oven på et vedligeholdt, fælles framework.

⚙️ Funktioner

• Moderne command API og parsing
• Indbygget farve-parsing med støtte for hex / RGB / MiniMessage
• Config-system med støtte for YAML, JSON og TOML
• API til vedvarende datalagring med YAML-, MySQL- og MongoDB-backends
• GUI API og færdigbyggede komponenter
• Brugerdefinerede items og ultrahurtig ItemStack-håndtering
• Packet-baseret item-visning og en let packet event loop
• Entity AI API med næsten 1:1 NMS-mapping
• Placeholder API og native integrationer (30+ integrationer er listet af projektet)
• Pris-/økonomi-abstraktion (prissystem, der understøtter economy-plugins, XP, items)
• Native bStats-understøttelse og kontrol af plugin-opdateringer
• Udvidelsessystem (plugins for plugins) og dependency-injection-værktøjer til udviklere

🧩 Hvem det er til

• Pluginudviklere, der bygger Spigot/Paper-kompatible plugins og ønsker et genanvendeligt framework
• Serverejere, der kører plugins, som afhænger af eco (eco skal installeres som dependency)
• Projekter, der har brug for brugerdefinerede items, GUI'er eller samlet værktøj til lagring og kommandoer

🏗️ Eksempler på brug

• En udvikler laver en brugerdefineret item-pakke, som bruger eco's item lookup- og GUI-API'er.
• Et plugin bruger eco's storage API til at understøtte både lokal YAML og en fjern MongoDB-backend uden at duplikere kode.
• Flere små plugins deler eco for ensartet kommandohåndtering og farve-parsing.

⚙️ Installation

📥 Opsætning

• Installer eco som et plugin på enhver server, der har brug for det, ved at placere JAR-filen i serverens plugins/-mappe og genstarte serveren.
• Hvis et andet plugin afhænger af eco, så angiv det i det pågældende plugins plugin.yml under depend: med - eco, så serveren indlæser eco først.

📦 Afhængighed (for pluginudviklere)

• Projektet udgiver et Maven-repository og Gradle-koordinater til brug som compile-only. Projektet tilbyder et publiceret artifact (for eksempel med group com.willfp og version tags), så udviklere kan tilføje eco som en provided dependency under build.

🧠 Tekniske noter

• Understøttet serversoftware: det officielle projekt angiver understøttelse af Spigot, Paper, Purpur og Folia.
• Understøttede Minecraft-versioner: projektet angiver understøttelse fra 1.21.4 og senere builds målrettes den moderne 1.21.x-serie.
• Lagrings-backends: frameworket leverer adapters til YAML, MySQL og MongoDB.
• Licens: eco er udgivet under MIT-licensen.

🤝 Hvornår dette plugin er nyttigt

Hvis du udvikler flere funktioner eller plugins, der deler fælles behov (kommandoer, konfigurationsformater, GUI-komponenter, lagring, brugerdefinerede items), reducerer eco dobbeltarbejde ved at levere et vedligeholdt framework og integrationer, som andre plugins kan afhænge af.