zAuctionHouse, oyuncuların öğe listelemesine, göz atmasına ve satın almasına olanak tanıyan tam özellikli bir açık artırma evi uygulayan bir Minecraft eklentisidir. Yapılandırılabilirlik, GUI odaklı arayüzler ve birden fazla ekonomi türü desteğine odaklanır. Proje GroupeZ-dev tarafından sürdürülmektedir ve depo ile dokümantasyon, modern Java ve sunucu mimarilerini hedefleyen V4 yeniden yazımını göstermektedir.

🎯 Amaç

zAuctionHouse, oyuncuların hemen al listeleri oluşturabildiği, toplu satış yapabildiği ve kategorilere ayrılmış envanterlere göz atabildiği merkezi bir pazar yeri sağlayarak oyun içi eşya ticareti sorununu çözer. Yönetici denetimi ve isteğe bağlı ağ senkronizasyonu isteyen sunuculara yöneliktir.

⚙️ Özellikler

Desteklendiği yerlerde anında satın alma (buy-it-now) ilanları ve teklif verme tarzı akışlar.
Toplu satış: bir ilan içinde birden fazla eşya satma.
Alıcıların satın almadan önce içeriği inceleyebilmesi için Shulker kutusu önizlemesi.
Büyük ilan setleri için kategori filtreleme, gelişmiş sıralama ve sayfalama.
Çoklu ekonomi desteği (Vault, PlayerPoints, CoinsEngine, eşya tabanlı para birimleri, XP/seviyeler).
Yapılandırılabilir vergi sistemi ve izin tabanlı vergi indirimleri.
Otomatik talep veya manuel talep ile para teslimi ve çevrimdışı satış bildirimleri.
Tamamen özelleştirilebilir GUI'ler ve envanter şablonları için zMenu entegrasyonu.
Biçimlendirilmiş mesajlar ve placeholders için PlaceholderAPI ve MiniMessage desteği.
Yönetici araçları: admin paneli, işlem kayıtları, işlem geçmişi, eşya kurtarma ve önbellek yönetim komutları.
Dağıtık kilitleme ve pub/sub kullanan bir Redis eklentisiyle çok sunuculu senkronizasyon.
Kara liste/beyaz liste eşya kontrolleri, dünya kısıtlamaları, ilan ve fiyat sınırları ve race conditions önlemek için işlem kilitleme.
Yapılandırılabilir embed içeriğiyle satış bildirimleri için Discord webhook desteği.

🧩 Kimler için

Oyuncu odaklı bir pazar yeri isteyen Survival ve SMP sunucuları.
Ticaret sistemlerine ihtiyaç duyan Skyblock, Factions ve ekonomi odaklı sunucular.
Birden fazla backend sunucu arasında senkronize pazar yerleri gerektiren ağlar.
Denetim kayıtlarına ve yönetici kurtarma araçlarına ihtiyaç duyan sunucu yöneticileri.

🏗️ Kullanım örnekleri

Oyuncular nadir düşen eşyaları veya üretilen öğeleri sabit fiyatla listeler, diğer oyuncular da bunları anında satın alır.
Bir sunucu operatörü izinler aracılığıyla vergi kurallarını ve VIP vergi indirimlerini uygular.
Çok sunuculu bir ağ, Redis eklentisini kullanarak hub ve backend sunucuları arasında ilanları ve satışları senkronize eder.

⌨️ Komutlar

Komut	Açıklama	Erişim
`/ah`	Açık artırma evi GUI'sini açar.	Oyuncu
`/ah sell <price>`	Elinizdeki öğeyi sabit bir fiyatla satar.	Oyuncu
`/ah sell <price> <amount>`	Eldeki öğenin belirli bir miktarını satar.	Oyuncu
`/ah selling`	Şu anda listelenmiş öğelerinizi gösterir.	Oyuncu
`/ah expired`	Süresi dolmuş ilanlarınızı gösterir.	Oyuncu
`/ah purchased`	Satın aldığınız öğeleri gösterir.	Oyuncu
`/ah history`	Satış/satın alma geçmişinizi gösterir.	Oyuncu
`/ah claim`	Bekleyen parayı alır (otomatik alınmıyorsa).	Oyuncu
`/ah reload`	Eklenti yapılandırmasını yeniden yükler.	Admin
`/ah admin history <player>`	Bir oyuncunun satın alma/satış geçmişini gösterir (admin görünümü).	Admin
`/ah admin open <type> <player>`	Bir oyuncunun ilanlarını/admin görünümünü açar.	Admin
`/ah admin migrate <source>`	Önceki bir sürüm/kaynaktan verileri taşır.	Admin

(Yukarıdaki komutlar, resmi proje dokümantasyonundan ve depo hızlı başlangıç materyallerinden alınmıştır.)

🔐 İzinler

İzin	Açıklama	Varsayılan
`zauctionhouse.config`	Eklentiyi oyun içinde yapılandırın.	belirtilmedi
`zauctionhouse.history`	Satın alma ve/veya satış geçmişinizi görüntüleyin.	belirtilmedi
`zauctionhouse.transaction`	Bir oyuncunun satın alma veya satış geçmişini görüntüleyin (admin komutu).	belirtilmedi

(Yalnızca resmi yapılandırma ve dokümanlarda açıkça referans verilen izin düğümleri listelenmiştir.)

⚙️ Kurulum

📥 Kurulum

Projenin dağıtımından resmi zAuctionHouse jar dosyasını edinin (resmi satış sayfası veya katalog).
zAuctionHouse jar dosyasını (ve gerekli eklentileri) sunucunun plugins/ dizinine yerleştirin.
Sunucuyu yeniden başlatın ve eklentinin sunucu konsolunda başlatıldığını doğrulayın.
Eklentiyi plugins/zAuctionHouse/config.yml kullanarak yapılandırın ve GUI envanterlerini plugins/zAuctionHouse/inventories/ içinde özelleştirin.

📦 Bağımlılıklar

Gerekli: zMenu, PlaceholderAPI.
İsteğe bağlı / desteklenen entegrasyonlar: Vault, LuckPerms ve çok sunuculu senkronizasyon için zAuctionHouse Redis eklentisi.

🧠 Teknik Notlar

Proje modern Java'yı hedefler (V4 yeniden yazımı Java 21'i hedefler) ve mimarisinde repository pattern / ORM kullanır.
Önerilen sunucu yazılımları arasında Paper ve Paper forkları bulunur; Folia ve birkaç Paper tabanlı fork da desteklenenler arasında listelenmiştir.
Resmi dokümantasyon ve dağıtım, Minecraft 1.20'den 1.21+'a kadar destek gösterir (üretime almadan önce tam build uyumluluğu için proje dokümanlarını kontrol edin).

❓ SSS

Ücretsiz sürüm var mı?
Ücretsiz bir demo derlemesi mevcuttur (proje bazı platformlarda ücretsiz/demo sürümü sağlar), ancak tam ve desteklenen sürümler projenin premium kanalları üzerinden dağıtılır.

🤝 Bu eklenti ne zaman kullanışlıdır

Yapılandırılabilir, GUI odaklı, çoklu ekonomi desteği olan ve isteğe bağlı çok sunuculu senkronizasyon sağlayan bir pazar yerine ihtiyacınız varsa, zAuctionHouse yönetici denetimi ve zMenu üzerinden GUI özelleştirmesiyle birlikte bakımı yapılan bir açık artırma evi uygulaması sunar.

zAuctionHouse eklentisine sahip sunucular

13
56.24
discord.gg/aflandz
1
52.61
CorePlay
Etkinlikler, düellolar, açık artırmalar ve samimi bir topluluk sunan CZ/SK survival sunucusu.
1
52.45
The Dojo
Towny survival, mcMMO ilerleme, oyuncu ekonomisi ve topluluk odaklı oynanış — kasaba kur, yetenek geliştir, arkadaşlarınla oyna.
1
49.38
EthelMC
Topluluk odaklı survival: ekonomi, arazi koruma, arenalar ve Java/Bedrock crossplay. Sıralamalar, oyuncu mağazaları ve etkinlikler.
0
47.78
Minecraft server freakplot.minecraft.best:25584 d0d865663236
1
46.39
Racsu Planet
Yetenekler, görevler, özel zindanlar ve resmi bir mağaza ile topluluk merkezi tarafından desteklenen oyun içi ekonomiye sahip çapraz oyun uyumlu Survival MMORPG (Java + Bedrock).
0
45.66
Pinging
0
45.62
Unleashed Craft
0
45.13
Survival
0
44.08
VoidCraft » PvP Factions 1.21 Forge ta faction. Ecrase tes ennemis. Regnez.
0
43.25
CyoriaSMP
Topluluk odaklı Survival SMP; oyun içi ekonomi, arazi koruması, Java+Bedrock çapraz oynama, mesafeye duyarlı sesli sohbet, özel moblar ve mini oyunlar içerir — builder'lar, trader'lar ve PvP'ciler için dostça bir oyun deneyimi.
0
42.96
ÂA sci-fi themed dungeons server in the sky!Â ÂÂá´á´É´É¢á´á´É´ê± - á´á´ê±á´á´á´ Éªá´á´á´ê± - ê±á´yÊÊá´á´á´
0
42.85
Tu nic nie ma ;)
0
42.43

zAuctionHouse eklenti sayfası, izleme sisteminin bu eklentiyi hangi sunucularda bulduğunu, hangi platformlar ve sürümlerle görüldüğünü gösterir.

Eklentiler komutlar, ekonomi, koruma, izinler, mini oyunlar, entegrasyonlar veya başka mekanikler ekleyebilir. zAuctionHouse eklentisinin gerçek rolü belirli sunucunun yapılandırmasına bağlıdır.

Veriler sunucuların teknik yanıtlarından otomatik oluşturulur. Bir sunucu eklenti listesini gizliyorsa zAuctionHouse kullansa bile bu bölümde görünmeyebilir.

Projeleri karşılaştırmak, uyumlu sürümleri kontrol etmek veya eklentinin herkese açık sunucularda nasıl kullanıldığına dair örnekler bulmak için zAuctionHouse bulunan sunucu listesini kullanın.