Minecraft-plugin zAuctionHouse

🔌 Om zAuctionHouse

zAuctionHouse er et Minecraft-plugin, der implementerer et fuldt udstyret auktionshus, hvor spillere kan oprette, gennemse og købe items. Det fokuserer på konfigurerbarhed, GUI-drevne grænseflader og understøttelse af flere økonomityper. Projektet vedligeholdes af GroupeZ-dev, og repositoryet samt dokumentationen viser en V4-omskrivning, der retter sig mod moderne Java og moderne serverarkitekturer.

🎯 Formål

zAuctionHouse løser problemet med handel med items i spillet ved at tilbyde en central markedsplads, hvor spillere kan oprette buy-now listings, foretage bulk-salg og gennemse inventarer kategoriseret efter kategori. Det er målrettet servere, der ønsker en integreret markedsplads med admin-audit og valgfri netværkssynkronisering.

⚙️ Funktioner

• Instant-buy (buy-it-now) listings og budgivningsforløb, hvor det understøttes.
• Bulk-salg: sælg flere items i én listing.
• Shulker box-forhåndsvisning, så købere kan inspicere indholdet før køb.
• Kategorifiltrering, avanceret sortering og pagination til store listing-sæt.
• Understøttelse af flere økonomier (Vault, PlayerPoints, CoinsEngine, item-baserede valutaer, XP/niveauer).
• Konfigurerbart skattesystem og tilladelsesbaserede skatterabatter.
• Automatisk eller manuel udbetaling af penge samt notifikationer om salg offline.
• zMenu-integration til fuldt tilpasselige GUI'er og inventory-skabeloner.
• Understøttelse af PlaceholderAPI og MiniMessage til formaterede beskeder og placeholders.
• Adminværktøjer: adminpanel, handlingslogge, transaktionshistorik, item-gendannelse og kommandoer til cachehåndtering.
• Synkronisering på tværs af flere servere via en Redis-addon med distributed locking og pub/sub.
• Blacklist/whitelist-kontrol af items, verdensbegrænsninger, grænser for listings og priser samt transaction locking for at forhindre race conditions.
• Understøttelse af Discord-webhooks til salgsnotifikationer med konfigurerbart embed-indhold.

🧩 Hvem det er til

• Survival- og SMP-servere, der ønsker en spillerstyret markedsplads.
• Skyblock-, Factions- og økonomifokuserede servere, der har brug for handelssystemer.
• Netværk, der kræver synkroniserede markedspladser på tværs af flere backend-servere.
• Serveradministratorer, der har brug for auditlogs og admin-gendannelsesværktøjer.

🏗️ Eksempler på brug

• Spillere opretter listings med sjældne drops eller craftede items til en fast pris, så andre spillere kan købe dem med det samme.
• En serveroperator håndhæver skatteregler og VIP-skatte­rabatter via permissions.
• Et multi-server-netværk synkroniserer listings og salg mellem hub- og backend-servere ved hjælp af Redis-addon.

⌨️ Kommandoer

(Kommandoerne ovenfor er hentet fra projektets officielle dokumentation og repositoryets quick-start-materiale.)

🔐 Tilladelser

(Kun permission nodes, der eksplicit er nævnt i den officielle konfiguration og dokumentation, er medtaget.)

⚙️ Installation

📥 Opsætning

• Hent den officielle zAuctionHouse-jar fra projektets distribution (den officielle salgsside eller katalog).
• Placér zAuctionHouse-jar-filen (og de nødvendige plugins) i serverens plugins/-mappe.
• Genstart serveren, og bekræft at pluginet initialiseres korrekt i serverkonsollen.
• Konfigurer pluginet via plugins/zAuctionHouse/config.yml, og tilpas GUI-inventarer i plugins/zAuctionHouse/inventories/.

📦 Afhængigheder

• Påkrævet: zMenu, PlaceholderAPI.
• Valgfrie / understøttede integrationer: Vault, LuckPerms og zAuctionHouse Redis-addon til synkronisering på tværs af flere servere.

🧠 Tekniske noter

• Projektet retter sig mod moderne Java (V4-omskrivningen retter sig mod Java 21) og bruger et repository pattern / ORM i sin arkitektur.
• Anbefalet serversoftware inkluderer Paper og Paper-forks; Folia og flere Paper-baserede forks er også angivet som understøttede.
• Officiel dokumentation og distribution viser understøttelse af Minecraft 1.20 op til 1.21+ (tjek projektets docs for præcis build-kompatibilitet, før du ruller ud i produktion).

❓ FAQ

• Findes der en gratis version?
  Der findes en gratis demo-build (projektet tilbyder en gratis/demo-udgivelse på nogle platforme), mens fulde, understøttede udgivelser distribueres via projektets premium-kanaler.

🤝 Hvornår dette plugin er nyttigt

Hvis du har brug for en konfigurerbar, GUI-drevet markedsplads med understøttelse af flere økonomier og valgfri synkronisering på tværs af flere servere, leverer zAuctionHouse en vedligeholdt auktionshusimplementation sammen med admin-audit og GUI-tilpasning via zMenu.