Essentials

Ini adalah cabang dari Essentials yang disebut EssentialsX.

Jika Anda menggunakan ini, JANGAN meminta dukungan Essentials.

Repositori upstream resmi untuk proyek Essentials asli ada di https://github.com/Essentials/Essentials.

Mengapa menggunakan EssentialsX?

EssentialsX adalah kelanjutan dari rangkaian plugin Essentials, diperbarui untuk mendukung versi Minecraft dan Spigot modern.

Ini memberikan banyak fitur baru, peningkatan kinerja, dan perbaikan yang tidak tersedia di Essentials atau Spigot-Essentials asli. Untuk lebih jelasnya, lihat wiki.

Jika Anda menggunakan plugin Essentials asli, EssentialsX adalah pengganti Essentials. Namun, ada beberapa persyaratan baru:

• EssentialsX memerlukan CraftBukkit, Spigot, atau Paper untuk dijalankan. Perangkat lunak server lain mungkin berfungsi, namun perangkat lunak ini tidak diuji oleh tim dan kami mungkin tidak dapat membantu mengatasi masalah apa pun yang terjadi.
• EssentialsX saat ini mendukung Minecraft versi 1.8.8, 1.9.4, 1.10.2, 1.11.2, 1.12.2, 1.13.2, 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.2, 1.19 .4, 1.20.6, dan 1.21.4.
• EssentialsX saat ini memerlukan Java 8 atau lebih tinggi. Kami menyarankan untuk menggunakan versi Java terbaru yang didukung oleh perangkat lunak server Anda.
• EssentialsX memerlukan Vault untuk mengaktifkan penggunaan awalan/akhiran obrolan dan dukungan grup dari plugin izin yang didukung.
  • Kami merekomendasikan penggunaan LuckPerms untuk izin dan grup.
  • Jika Anda memiliki plugin izin yang tidak didukung tetapi masih ingin menggunakan wildcard, aktifkan use-bukkit-permissions dalam konfigurasi. Jika tidak, plugin akan kembali ke izin berbasis konfigurasi.

Mendukung

Butuh bantuan dalam menggunakan EssentialsX? Bergabunglah dengan komunitas MOSS Discord untuk meminta bantuan dan mendiskusikan EssentialsX.

Jika Anda perlu melaporkan bug atau ingin menyarankan fitur baru, Anda dapat membuka masalah di GitHub.

Bangunan

Untuk membangun EssentialsX, Anda perlu menginstal JDK 8 atau lebih tinggi di sistem Anda.

Kloning repositori ini, lalu jalankan perintah berikut:

• Di Linux atau macOS: ./gradlew build
• Di Windows: gradlew build

Anda kemudian dapat menemukan build modul EssentialsX di direktori jars/ .

Menjalankan server pengujian

Anda juga dapat menjalankan server pengujian dari lingkungan pengembangan menggunakan perintah berikut:

• Di Linux atau macOS: ./gradlew build :runServer
• Di Windows: gradlew build :runServer

Perhatikan : - tanpanya, Anda akan menjalankan beberapa server sekaligus, yang kemungkinan besar akan membuat Gradle mogok.

Menggunakan EssentialsX di plugin Anda

Apakah Anda ingin berintegrasi dengan EssentialsX di plugin Anda? Anda dapat membuat plugin menggunakan EssentialsX API , tersedia dari repo EssentialsX Maven.

Rilis dihosting di repo Maven di https://repo.essentialsx.net/releases/ , sedangkan snapshot (termasuk build dev) dihosting di https://repo.essentialsx.net/snapshots/ .

Untuk menambahkan EssentialsX ke sistem build Anda, Anda harus menggunakan artefak berikut:

Jenis	ID Grup	ID artefak	Versi
Rilis terbaru	net.essentialsx	EssentialsX	2.20.1
Jepretan	net.essentialsx	EssentialsX	2.21.0-SNAPSHOT
Rilisan yang lebih lama	net.ess3	EssentialsX	2.18.2

Catatan: hingga versi 2.18.2 , EssentialsX menggunakan ID grup net.ess3 .
Mulai 2.19.0 dan seterusnya, EssentialsX menggunakan ID grup net.essentialsx .
Saat memperbarui plugin Anda, pastikan Anda menggunakan ID grup yang benar.

Anda dapat menemukan informasi lebih lanjut, termasuk contoh Maven dan Gradle, di wiki.

Dukung proyek EssentialsX

Ingin membantu meningkatkan EssentialsX? Ada beberapa cara Anda dapat mendukung dan berkontribusi pada proyek ini.

Donasi ke EssentialsX

Donasi memungkinkan kami menutupi biaya infrastruktur kami, dan juga memungkinkan kami terus memperbarui EssentialsX dengan fitur-fitur baru dan untuk versi Minecraft baru.

Anda dapat mendukung kami dengan donasi satu kali atau bulanan melalui Sponsor GitHub, dan Anda akan mendapatkan lencana di GitHub karena mendukung proyek melalui ini.

Alternatifnya, Anda juga dapat berdonasi setiap bulan ke proyek EssentialsX di Patreon, atau Anda dapat memberikan donasi satu kali di halaman Ko-fi kami.

Jika Anda tidak dapat memberikan donasi, jangan khawatir! Ada banyak cara lain untuk berkontribusi:

Berkontribusi langsung ke EssentialsX

• Apakah Anda seorang pengembang? Kami selalu senang menerima perbaikan bug dan penambahan fitur sebagai permintaan penarikan.
• Apakah Anda berbicara dalam berbagai bahasa? Jika demikian, kami selalu menerima kontribusi pada terjemahan komunitas kami. Proyek Crowdin.

Lihat CONTRIBUTING.md untuk mengetahui lebih lanjut.

Memberikan dukungan kepada pengguna lain

• Apakah Anda menjalankan server? Lihatlah masalah "dibutuhkan bantuan" dan "bug: belum dikonfirmasi" kami, di mana Anda dapat menemukan masalah yang memerlukan pengujian dan investigasi tambahan.
• Apakah Anda ingin membantu orang lain menyiapkan EssentialsX? Anda dapat berkontribusi pada dokumen EssentialsX. Anda juga dapat bergabung dengan komunitas MOSS Discord dan memberikan dukungan komunitas langsung kepada pengguna EssentialsX lainnya.