Minecraft plugin AuctionHouse

🔌 Over AuctionHouse

AuctionHouse is een Minecraft-plugin die een in-game veilinghuis toevoegt dat toegankelijk is met het commando /ah. Spelers kunnen items te koop zetten, aanbiedingen bekijken en doorzoeken, en items kopen via een op GUI gebaseerde markt. De plugin richt zich op handel tussen spelers met configureerbare regels voor listings, kosten en aankondigingen.

🎯 Doel

AuctionHouse biedt een centraal, op GUI gebaseerd marktplaatsysteem, zodat servers een beheerd veilingsysteem kunnen aanbieden in plaats van te vertrouwen op winkels van spelers of markten via borden. Het is bedoeld voor servers die een doorzoekbare publieke markt willen met configureerbare beperkingen en integratie met de economie.

⚙️ Functies

• Veilinghuis met GUI geopend met /ah.
• Listings maken en annuleren; geannuleerde of verlopen items ophalen.
• Listings zoeken en filteren op naam, type, lore, enchantments of verkoper.
• Listings sorteren op tijd of prijs.
• Listing-opties: minimum-/maximumprijzen instellen, listingkosten (vast en/of percentage), verkopersbelasting met limiet, en cooldown tussen listings.
• Itembeperkingen op basis van naam, type, lore, enchantments, damage, unbreakable-vlag, custom_model_data en regex-patronen.
• Optie om serveritems te plaatsen (eenmalige of onbeperkte listings).
• Speciale triggers om de veiling te openen via borden, met naam aangepaste block entities (chests, shulkers, dispensers, enz.) of entiteiten met een aangepaste naam.
• Tooltips bij hoveren tonen resterende tijd en enchantments.
• Optionele aankondigingen voor nieuwe listings en Discord-integratie.
• Ondersteuning voor internationalisatie en configureerbare berichten, materialen en geluiden.
• Transactielogging naar een apart logbestand en automatische opruiming van achtergelaten items.

🧩 Voor wie is het

• Survival- en SMP-servers die een gedeelde spelersmarkt willen.
• Servers met focus op economie die een doorzoekbare veiling-GUI willen.
• Beheerders die configureerbare regels, kosten en itembeperkingen nodig hebben.

🏗️ Voorbeeldgebruik

• Spelers zetten overtollige loot te koop en veilen die aan de servercommunity in plaats van chests of winkels te gebruiken.
• Serverpersoneel maakt beperkte of onbeperkte door de server aangeboden listings voor winkelitems.
• Beheerders handhaven servereconomieregels door bepaalde items te beperken of listingbelasting toe te passen.

⌨️ Commando's

🔐 Permissions

⚙️ Installatie

📥 Setup

• Download de officiële plugin .jar en plaats deze in de map plugins/ van je server voor Spigot-compatibele servers.
• Start de server volledig opnieuw en controleer de serverconsole om te bevestigen dat de plugin is geladen.
• Configureer de plugin indien nodig met de meegeleverde configuratiebestanden.

📦 Dependencies

• Vault (vereist, 1.7.1+ aanbevolen).
• Een geschikte economy-plugin (bijv. EssentialsX economy of een andere Vault-compatibele economy-provider).
• Een geschikte permissions-plugin (als je permissions gebruikt buiten de standaardinstellingen).

🧠 Technische notities

• Opslag: de plugin gebruikt SQLite (geen externe database-ondersteuning gedocumenteerd).
• De plugin logt transacties naar een apart logbestand en ondersteunt internationalisatie.
• Ondersteunt HeadDatabase-hoofden en aangepaste skull-texturen als GUI-knoppen.
• De auteur geeft aan dat functies en versiecompatibiliteit zijn gericht op Spigot; gedrag kan verschillen op andere serversoftware.

🤝 Wanneer deze plugin nuttig is

Als je een configureerbaar, op GUI gebaseerd veilingsysteem wilt dat is geïntegreerd met je servereconomie en Vault, biedt AuctionHouse listingbeheer, zoeken/filteren, kosten/belastingen en transactielogging om een beheersbare spelersmarkt te leveren.