Minecraft-plugin EconomyShop

🔌 Om EconomyShop

EconomyShop är ett Minecraft-plugin som implementerar en serverbutik (GUI) och spelarnas kistbutiker. Det fokuserar på webbläsarliknande inventariemenyer för köp och försäljning, plus spelarskapade kistbutiker som använder en kista + skylt-uppsättning och ett redigerings-GUI. Pluginet är en del av ilius ekonomi-ekosystem och är utformat för servrar som behöver en server-side-butik med konfigurerbara priser, skatter och historikspårning.

🎯 Syfte

EconomyShop erbjuder ett centraliserat, GUI-först handelssystem så att serverägare kan erbjuda butiker som sköts av administratörer och låta spelare skapa och hantera kistbutiker utan chattkommandon eller manuell formatering av skyltar. Det är avsett för servrar som kör en Vault-kompatibel ekonomi och vill ha integrerad prishistorik, skatter och adminverktyg för butiksadministration.

⚙️ Funktioner

• GUI-baserad serverbutik: bläddring i kategorier, mängdval och bekräftelseskärmar före köp.
• Stöd för att sälja tillbaka: högerklicka på butiksföremål för att sälja dem till servern med skatt och bekräftelse visad.
• Spelares kistbutiker: skapa butiker genom att placera en kista och en skylt; priser och redigering hanteras via GUI.
• Lageralternativ: obegränsat eller begränsat lager med automatisk påfyllning för adminbutiker.
• Försäljningsskatt: konfigurerbar transaktionsskatt för försäljning i server- och kistbutiker.
• Prishistorik: delade prischartor (7-, 14- och 30-dagarsvyer) som kombinerar försäljning från adminbutik, kistbutik och auktion.
• Admin-GUI: skapa kategorier, lägg till föremål och redigera butiksinställningar via menyer (ingen manuell konfigredigering krävs för grundläggande funktioner).
• Lagring: SQLite som standard med valfritt stöd för MySQL/MariaDB för skalning.
• Integrationer: Vault-kompatibelt ekonomistöd, PlaceholderAPI-placeholders, valfria integrationspunkter för LuckPerms och WorldGuard.
• Anti-exploit-åtgärder: transaktionslås, dubblettskydd, blockering i creative-läge och begränsning av frekvens.

🧩 Vem det är för

• Survival- och SMP-servrar som vill ha en butiksupplevelse via GUI.
• Servrar där spelare ska driva sina egna kistbutiker med minimal adminbörda.
• Servrar som använder en Vault-kompatibel ekonomi och kan vilja ha databasbaserad lagring.

🏗️ Exempel på användning

• En admin konfigurerar kategorier och fyller serverbutiken med anpassade föremål och priser via admin-GUI.
• En spelare placerar en kista och en skylt för att öppna en kistbutik, ställer in köp-/säljpriser via GUI och säljer föremål till andra spelare.
• Serveroperatörer granskar föremålens prishistorik för att justera adminbutikspriser eller beskattning.

⌨️ Kommandon

🔐 Behörigheter

⚙️ Installation

📥 Installation

• Ladda ner pluginets JAR och placera den i serverns plugins/-katalog.
• Starta om servern för att ladda pluginet.
• Kör /shop admin från ett operatörskonto för att skapa kategorier och lägga till föremål.

📦 Beroenden

• Krävs: Vault (valfritt Vault-kompatibelt ekonomiplugin).
• Valfritt/integrationer: PlaceholderAPI, LuckPerms, WorldGuard, EconomyProvider, AuctionHouse.

🧠 Tekniska anteckningar

• Lagring: SQLite finns direkt ur lådan; MySQL/MariaDB-stöd finns för större servrar.
• Plattformar: pluginet deklarerar stöd för Paper och listar även kompatibilitet med Purpur och Folia.
• Pluginet innehåller inbyggt anti-exploit-skydd, inklusive transaktionslås och begränsning av frekvens.
• Del av ilius ekonomi-stack och integreras med andra ilius-plugins för en konsekvent databas/stil.

🤝 När detta plugin är användbart

Om din server behöver en adminstyrd serverbutik plus spelares kistbutiker med GUI-baserad konfiguration, prishistorik och Vault-kompatibel ekonomi-integration, erbjuder EconomyShop ett GUI-först-arbetsflöde och administrativa verktyg för att hantera butiksföremål, skatter och lagringsbackend utan manuell tolkning av skyltar eller tunga config-ändringar.