Minecraft plugin zAuctionHouse

🔌 Over zAuctionHouse

zAuctionHouse is een Minecraft-plugin die een volledig uitgeruste veiling voor spelers implementeert om items te plaatsen, te bekijken en te kopen. De focus ligt op configureerbaarheid, GUI-gestuurde interfaces en ondersteuning voor meerdere economie-types. Het project wordt onderhouden door GroupeZ-dev, en de repository en documentatie laten een V4-herschrijving zien die gericht is op moderne Java- en serverarchitecturen.

🎯 Doel

zAuctionHouse lost het probleem van itemhandel in-game op door een centrale marktplaats te bieden waar spelers buy-now-lijsten kunnen maken, bulkverkopen kunnen uitvoeren en inventarissen per categorie kunnen doorbladeren. Het is bedoeld voor servers die een geïntegreerde marktplaats willen met admin-auditing en optionele netwerksynchronisatie.

⚙️ Functies

• Instant-buy (buy-it-now) listings en biedingsworkflows waar ondersteund.
• Bulkverkopen: verkoop meerdere items in één listing.
• Shulker box-voorbeeld zodat kopers de inhoud vóór aankoop kunnen bekijken.
• Categoriefiltering, geavanceerd sorteren en paginering voor grote aantallen listings.
• Ondersteuning voor meerdere economieën (Vault, PlayerPoints, CoinsEngine, item-gebaseerde valuta, XP/niveaus).
• Configureerbaar belastingsysteem en op permissies gebaseerde belastingkortingen.
• Automatische of handmatige geldafhandeling en meldingen van offline verkopen.
• zMenu-integratie voor volledig aanpasbare GUI's en inventarissjablonen.
• Ondersteuning voor PlaceholderAPI en MiniMessage voor opgemaakte berichten en placeholders.
• Beheertools: een adminpaneel, actielogs, transactiegeschiedenis, itemherstel en cachebeheercommando's.
• Synchronisatie over meerdere servers via een Redis-addon met distributed locking en pub/sub.
• Blacklist/whitelist-itemregels, wereldbeperkingen, listing- en prijslimieten, en transactievergrendeling om race conditions te voorkomen.
• Ondersteuning voor Discord-webhooks voor verkoopmeldingen met configureerbare embed-inhoud.

🧩 Voor wie is het bedoeld

• Survival- en SMP-servers die een door spelers aangedreven marktplaats willen.
• Skyblock-, Factions- en economiegerichte servers die handelssystemen nodig hebben.
• Netwerken die gesynchroniseerde marktplaatsen over meerdere backend-servers vereisen.
• Serverbeheerders die auditlogs en admin-hersteltools nodig hebben.

🏗️ Voorbeeldgebruik

• Spelers plaatsen zeldzame drops of gemaakte items voor een vaste prijs zodat andere spelers ze direct kunnen kopen.
• Een serveroperator handhaaft belastingregels en VIP-belastingkortingen via permissies.
• Een multi-servernetwerk synchroniseert listings en verkopen tussen hub- en backend-servers met de Redis-addon.

⌨️ Commando's

(Bovenstaande commando's zijn afkomstig uit de officiële projectdocumentatie en de quick-startmaterialen in de repository.)

🔐 Permissies

(Alleen permissienodes die expliciet worden genoemd in de officiële configuratie en docs zijn opgenomen.)

⚙️ Installatie

📥 Setup

• Verkrijg de officiële zAuctionHouse-jar uit de distributie van het project (officiële verkooppagina of catalogus).
• Plaats de zAuctionHouse-jar (en vereiste plugins) in de plugins/-map van de server.
• Herstart de server en controleer of de plugin correct initialiseert in de serverconsole.
• Configureer de plugin via plugins/zAuctionHouse/config.yml en pas GUI-inventarissen aan in plugins/zAuctionHouse/inventories/.

📦 Afhankelijkheden

• Vereist: zMenu, PlaceholderAPI.
• Optionele / ondersteunde integraties: Vault, LuckPerms en de zAuctionHouse Redis-addon voor synchronisatie over meerdere servers.

🧠 Technische notities

• Het project richt zich op moderne Java (de V4-herschrijving richt zich op Java 21) en gebruikt een repository-patroon / ORM in de architectuur.
• Aanbevolen serversoftware omvat Paper en Paper-forks; Folia en verschillende Paper-gebaseerde forks worden ook als ondersteund genoemd.
• Officiële documentatie en distributie tonen ondersteuning voor Minecraft 1.20 tot en met 1.21+ (controleer de projectdocs voor exacte build-compatibiliteit voordat je naar productie uitrolt).

❓ FAQ

• Is er een gratis versie?
  Er is een gratis demo-build beschikbaar (het project biedt op sommige platforms een gratis/demo-release aan), terwijl volledige, ondersteunde releases via de premiumkanalen van het project worden वितribueerd.

🤝 Wanneer deze plugin nuttig is

Als je een configureerbare, GUI-gestuurde marktplaats nodig hebt met ondersteuning voor meerdere economieën en optionele synchronisatie over meerdere servers, biedt zAuctionHouse een onderhouden veilingimplementatie samen met admin-auditing en GUI-aanpassing via zMenu.