Plugin Minecraft eco

🔌 Tentang eco

eco adalah pustaka pengembangan Spigot (plugin Minecraft mandiri) yang dirancang untuk menyederhanakan pengembangan plugin dan menyediakan fitur engine yang dapat digunakan ulang untuk plugin lain. Pustaka ini menyediakan API untuk perintah dan konfigurasi, adapter penyimpanan persisten, sistem GUI dan item kustom, serta banyak integrasi sehingga penulis plugin dapat menggunakan ulang fungsi umum alih-alih membuatnya dari awal.

🎯 Tujuan

eco dibuat untuk memusatkan sistem umum yang dibutuhkan plugin modern bagi developer: parsing perintah, format warna dan pesan, format konfigurasi, akses data persisten, komponen GUI, penanganan item, dan integrasi dengan sistem server-side lainnya. Ini ditujukan untuk penulis plugin yang ingin membangun fitur dengan cepat di atas framework bersama yang terus dipelihara.

⚙️ Fitur

• API perintah modern dan parsing
• Parsing warna bawaan dengan dukungan hex / RGB / MiniMessage
• Sistem konfigurasi yang mendukung YAML, JSON, dan TOML
• API penyimpanan data persisten dengan backend YAML, MySQL, dan MongoDB
• API GUI dan komponen siap pakai
• Item kustom dan penanganan ItemStack super cepat
• Tampilan item berbasis packet dan event loop packet yang ringan
• API AI entity dengan pemetaan NMS hampir 1:1
• Placeholder API dan integrasi bawaan (30+ integrasi tercantum oleh proyek)
• Abstraksi harga/ekonomi (sistem harga yang mendukung plugin ekonomi, XP, item)
• Dukungan native bStats dan pemeriksaan pembaruan plugin
• Sistem ekstensi (plugin untuk plugin) dan tooling dependency injection untuk developer

🧩 Untuk Siapa Ini

• Developer plugin yang membangun plugin kompatibel Spigot/Paper dan ingin framework yang dapat digunakan ulang
• Pemilik server yang menjalankan plugin yang bergantung pada eco (eco harus dipasang sebagai dependency)
• Proyek yang memerlukan item kustom, GUI, atau tooling penyimpanan dan perintah yang terpadu

🏗️ Contoh Penggunaan

• Seorang developer membuat paket item kustom yang menggunakan API pencarian item dan GUI milik eco.
• Sebuah plugin memakai API penyimpanan eco untuk mendukung YAML lokal dan backend MongoDB jarak jauh tanpa menggandakan kode.
• Beberapa plugin kecil berbagi eco untuk penanganan perintah dan parsing warna yang konsisten.

⚙️ Instalasi

📥 Setup

• Pasang eco sebagai plugin di server mana pun yang membutuhkannya dengan meletakkan JAR ke folder plugins/ di server dan restart server.
• Jika plugin lain bergantung pada eco, deklarasikan di plugin.yml plugin tersebut pada depend: dengan - eco agar server memuat eco terlebih dahulu.

📦 Dependency (untuk developer plugin)

• Proyek ini menerbitkan repository Maven dan koordinat Gradle untuk penggunaan compile-only. Proyek ini menyediakan artifact yang dipublikasikan (misalnya dengan group com.willfp dan tag versi) sehingga developer menambahkan eco sebagai dependency provided saat build.

🧠 Catatan Teknis

• Software server yang didukung: proyek resmi menunjukkan dukungan untuk Spigot, Paper, Purpur, dan Folia.
• Versi Minecraft yang didukung: proyek menyatakan dukungan mulai dari 1.21.4 dan build berikutnya menargetkan seri modern 1.21.x.
• Backend penyimpanan: adapter YAML, MySQL, dan MongoDB disediakan oleh framework.
• Lisensi: eco dirilis di bawah lisensi MIT.

🤝 Kapan Plugin Ini Berguna

Jika Anda mengembangkan banyak fitur atau plugin yang memiliki kebutuhan umum yang sama (perintah, format konfigurasi, komponen GUI, penyimpanan, item kustom), eco mengurangi pekerjaan duplikat dengan menyediakan framework yang dipelihara dan integrasi yang dapat diandalkan oleh plugin lain.