zAuctionHouse adalah plugin Minecraft yang menghadirkan rumah lelang lengkap bagi pemain untuk memasang, menelusuri, dan membeli item. Fokusnya ada pada konfigurasi yang fleksibel, antarmuka berbasis GUI, dan dukungan untuk berbagai jenis ekonomi. Proyek ini dikelola oleh GroupeZ-dev, dan repositori serta dokumentasinya menunjukkan penulisan ulang V4 yang menargetkan Java modern dan arsitektur server modern.

🎯 Tujuan

zAuctionHouse menyelesaikan masalah perdagangan item di dalam game dengan menyediakan pasar pusat tempat pemain dapat membuat listing beli sekarang, melakukan penjualan massal, dan menelusuri inventaris berdasarkan kategori. Plugin ini ditujukan untuk server yang ingin memiliki marketplace terintegrasi dengan audit admin dan sinkronisasi jaringan opsional.

⚙️ Fitur

Listing beli langsung (buy-it-now) dan alur berbasis penawaran jika didukung.
Penjualan massal: jual beberapa item dalam satu listing.
Pratinjau shulker box agar pembeli bisa memeriksa isinya sebelum membeli.
Penyaringan kategori, pengurutan lanjutan, dan pagination untuk set listing yang besar.
Dukungan multi-ekonomi (Vault, PlayerPoints, CoinsEngine, mata uang berbasis item, XP/level).
Sistem pajak yang dapat dikonfigurasi dan pengurangan pajak berbasis izin.
Pengiriman uang dengan klaim otomatis atau klaim manual, serta notifikasi penjualan offline.
Integrasi zMenu untuk GUI dan template inventaris yang sepenuhnya dapat disesuaikan.
Dukungan PlaceholderAPI dan MiniMessage untuk pesan berformat dan placeholder.
Alat admin: panel admin, log aksi, riwayat transaksi, pemulihan item, dan perintah pengelolaan cache.
Sinkronisasi multi-server melalui addon Redis dengan distributed locking dan pub/sub.
Kontrol item blacklist/whitelist, pembatasan world, batas listing dan harga, serta transaction locking untuk mencegah race condition.
Dukungan webhook Discord untuk notifikasi penjualan dengan konten embed yang dapat dikonfigurasi.

🧩 Cocok untuk

Server Survival dan SMP yang menginginkan marketplace yang digerakkan pemain.
Server Skyblock, Factions, dan server berfokus ekonomi yang membutuhkan sistem perdagangan.
Jaringan yang memerlukan marketplace tersinkron di beberapa server backend.
Administrator server yang membutuhkan log audit dan alat pemulihan admin.

🏗️ Contoh Penggunaan

Pemain memasang drop langka atau item hasil craft dengan harga tetap agar pemain lain bisa membelinya langsung.
Operator server menerapkan aturan pajak dan pengurangan pajak VIP melalui permission.
Jaringan multi-server menyinkronkan listing dan penjualan di hub dan server backend menggunakan addon Redis.

⌨️ Perintah

Perintah	Deskripsi	Akses
`/ah`	Membuka GUI rumah lelang.	Pemain
`/ah sell <price>`	Menjual item yang ada di tangan Anda dengan harga tetap.	Pemain
`/ah sell <price> <amount>`	Menjual jumlah tertentu dari item yang ada di tangan.	Pemain
`/ah selling`	Melihat item yang saat ini Anda pasang.	Pemain
`/ah expired`	Melihat listing Anda yang kedaluwarsa.	Pemain
`/ah purchased`	Melihat item yang telah Anda beli.	Pemain
`/ah history`	Melihat riwayat penjualan/pembelian Anda.	Pemain
`/ah claim`	Mengklaim uang yang menunggu (jika tidak diklaim otomatis).	Pemain
`/ah reload`	Memuat ulang konfigurasi plugin.	Admin
`/ah admin history <player>`	Melihat riwayat beli/jual seorang pemain (tampilan admin).	Admin
`/ah admin open <type> <player>`	Membuka listing seorang pemain/tampilan admin.	Admin
`/ah admin migrate <source>`	Memigrasikan data dari versi/sumber sebelumnya.	Admin

(Perintah di atas diambil dari dokumentasi resmi proyek dan materi quick-start repositori.)

🔐 Permission

Permission	Deskripsi	Default
`zauctionhouse.config`	Mengonfigurasi plugin di dalam game.	tidak ditentukan
`zauctionhouse.history`	Melihat riwayat pembelian dan/atau penjualan Anda.	tidak ditentukan
`zauctionhouse.transaction`	Melihat riwayat beli atau jual seorang pemain (perintah admin).	tidak ditentukan

(Hanya node permission yang secara eksplisit dirujuk dalam konfigurasi dan dokumentasi resmi yang dicantumkan.)

⚙️ Instalasi

📥 Setup

Dapatkan jar resmi zAuctionHouse dari distribusi proyek (halaman penjualan resmi atau katalog).
Letakkan jar zAuctionHouse (dan plugin yang diperlukan) ke direktori server plugins/.
Restart server dan pastikan plugin berhasil diinisialisasi di konsol server.
Konfigurasikan plugin menggunakan plugins/zAuctionHouse/config.yml dan sesuaikan inventaris GUI di plugins/zAuctionHouse/inventories/.

📦 Dependensi

Diperlukan: zMenu, PlaceholderAPI.
Integrasi opsional / didukung: Vault, LuckPerms, dan addon zAuctionHouse Redis untuk sinkronisasi multi-server.

🧠 Catatan Teknis

Proyek ini menargetkan Java modern (penulisan ulang V4 menargetkan Java 21) dan menggunakan pola repository / ORM dalam arsitekturnya.
Perangkat lunak server yang direkomendasikan mencakup Paper dan turunan Paper; Folia dan beberapa fork berbasis Paper juga tercantum sebagai yang didukung.
Dokumentasi resmi dan distribusi menunjukkan dukungan untuk Minecraft 1.20 hingga 1.21+ (periksa dokumentasi proyek untuk kompatibilitas build yang tepat sebelum diterapkan ke produksi).

❓ FAQ

Apakah ada versi gratis?
Build demo gratis tersedia (proyek menyediakan rilis gratis/demo di beberapa platform), sedangkan rilis penuh yang didukung didistribusikan melalui channel premium proyek.

🤝 Kapan Plugin Ini Berguna

Jika Anda membutuhkan marketplace yang dapat dikonfigurasi, berbasis GUI, dengan dukungan multi-ekonomi dan sinkronisasi multi-server opsional, zAuctionHouse menyediakan implementasi rumah lelang yang terawat lengkap dengan audit admin dan kustomisasi GUI melalui zMenu.

Server dengan plugin zAuctionHouse

11
56
CorePlay
Server survival CZ/SK klasik dengan event, duel, lelang dan komunitas ramah.
1
52.72
discord.gg/aflandz
1
52.61
EthelMC
Survival komunitas dengan ekonomi, klaim tanah, arena, dan crossplay (Java & Bedrock). Toko pemain dan event.
0
47.35
The Dojo
Towny survival dengan progresi mcMMO, ekonomi pemain dan fokus komunitas — bangun kota, tingkatkan skill, main bareng teman.
0
47.09
Racsu Planet
Cross-play Survival MMORPG (Java + Bedrock) dengan skill, quest, dungeon kustom, dan ekonomi dalam game yang didukung oleh toko resmi serta hub komunitas.
0
45.63
Pinging
0
45.26
Unleashed Craft
0
44.77
Minecraft server freakplot.minecraft.best:25584 d0d865663236
0
43.81
Survival
0
43.73
VoidCraft » PvP Factions 1.21 Forge ta faction. Ecrase tes ennemis. Regnez.
0
43.25
ÂA sci-fi themed dungeons server in the sky!Â ÂÂá´á´É´É¢á´á´É´ê± - á´á´ê±á´á´á´ Éªá´á´á´ê± - ê±á´yÊÊá´á´á´
0
42.85
CyoriaSMP
SMP Survival yang berfokus pada komunitas, dengan ekonomi dalam game, perlindungan lahan, crossplay Java+Bedrock, voice chat berbasis jarak, mob kustom, dan mini-game — permainan yang ramah untuk builder, trader, dan PvPer.
0
42.62
Tu nic nie ma ;)
0
42.11

Halaman plugin zAuctionHouse menampilkan di server mana monitoring menemukan plugin ini, dengan platform dan versi apa ia ditemukan.

Plugin dapat menambahkan perintah, ekonomi, perlindungan, hak akses, mini-game, integrasi, atau mekanik lainnya. Peran sebenarnya dari zAuctionHouse bergantung pada konfigurasi server yang bersangkutan.

Data terbentuk otomatis dari respons teknis server. Jika server menyembunyikan daftar plugin, server tersebut mungkin tidak muncul di bagian ini meskipun menggunakan zAuctionHouse.

Gunakan daftar server dengan zAuctionHouse untuk membandingkan proyek, memeriksa versi yang kompatibel, atau menemukan contoh penggunaan plugin di server publik.