Minecraft-plugin AuctionHouse

🔌 Om AuctionHouse

AuctionHouse är ett Minecraft-plugin som lägger till ett auktionshus i spelet som nås med kommandot /ah. Spelare kan lägga ut föremål till försäljning, bläddra bland och söka i annonser, och köpa föremål via en GUI-baserad marknad. Pluginet fokuserar på handel mellan spelare med konfigurerbara regler för listningar, avgifter och meddelanden.

🎯 Syfte

AuctionHouse erbjuder en centraliserad, GUI-driven marknadsplats så att servrar kan erbjuda ett hanterat auktionssystem i stället för att förlita sig på spelardrivna butiker eller skyltbaserade marknader. Det är avsett för servrar som vill ha en sökbar offentlig marknad med konfigurerbara begränsningar och ekonomiintegration.

⚙️ Funktioner

• Auktionshus med GUI som öppnas med /ah.
• Skapa och avbryta listningar; hämta avbrutna eller utgångna föremål.
• Sök och filtrera listningar efter namn, typ, lore, enchantments eller säljare.
• Sortera listningar efter tid eller pris.
• Listningskontroller: ställ in min-/maxpriser, listningsavgifter (fast och/eller procent), säljar-skatt med tak och cooldown mellan listningar.
• Föremålsbegränsningar baserade på namn, typ, lore, enchantments, skada, unbreakable-flagga, custom_model_data och regex-mönster.
• Alternativ att lista serverföremål (engångs- eller obegränsade listningar).
• Särskilda triggers för att öppna auktionen via skyltar, namngivna block entities (chests, shulkers, dispensers, osv.) eller entiteter med anpassat namn.
• Tooltipar vid hover visar återstående tid och enchantments.
• Valfria meddelanden för nya listningar och Discord-integration.
• Stöd för internationalisering samt konfigurerbara meddelanden, material och ljud.
• Transaktionsloggning till en separat loggfil och automatisk rensning av övergivna föremål.

🧩 Vem det är för

• Survival- och SMP-servrar som vill ha en gemensam spelarmarknad.
• Ekonomifokuserade servrar som vill ha ett sökbart auktions-GUI.
• Administratörer som behöver konfigurerbara regler, avgifter och föremålsbegränsningar.

🏗️ Exempel på användning

• Spelare listar överskottsloot och auktionerar ut den till servercommunityn i stället för att använda kistor eller butiker.
• Serverpersonal skapar begränsade eller obegränsade servererbjudna listningar för butiksföremål.
• Administratörer upprätthåller serverns ekonomiregler genom att begränsa vissa föremål eller införa listningsskatter.

⌨️ Kommandon

🔐 Permissions

⚙️ Installation

📥 Setup

• Ladda ner den officiella plugin .jar-filen och placera den i serverns plugins/-katalog för Spigot-kompatibla servrar.
• Starta om servern helt och kontrollera serverkonsolen för att bekräfta att pluginet laddades.
• Konfigurera pluginet med de medföljande konfigurationsfilerna vid behov.

📦 Dependencies

• Vault (krävs, 1.7.1+ rekommenderas).
• Ett passande ekonomiplugin (t.ex. EssentialsX economy eller annan Vault-kompatibel ekonomileverantör).
• Ett passande permissions-plugin (om du använder rättigheter utöver standardinställningarna).

🧠 Tekniska noteringar

• Lagring: pluginet använder SQLite (ingen extern databassupport dokumenterad).
• Pluginet loggar transaktioner till en separat loggfil och stöder internationalisering.
• Stödjer HeadDatabase-huvuden och anpassade skull-texturer som GUI-knappar.
• Författaren noterar att funktioner och versionskompatibilitet är riktade mot Spigot; beteendet kan skilja sig på annan serverprogramvara.

🤝 När detta plugin är användbart

Om du vill ha ett konfigurerbart auktionssystem baserat på GUI, integrerat med serverns ekonomi och Vault, erbjuder AuctionHouse kontroll över listningar, sökning/filtrering, avgifter/skatter och transaktionsloggning för att skapa en hanterbar spelarmarknad.