Minecraft-plugin QuickShop-Hikari

🔌 Om QuickShop-Hikari

QuickShop-Hikari är ett Minecraft-plugin som implementerar kistbaserade köp-/säljbutiker (ChestShops). Spelare skapar och använder butiker genom att interagera med kistor; det mesta av spelet kräver inga kommandon. Projektet underhålls av QuickShop-Community och fokuserar på modern kompatibilitet, datasäkerhet och utbyggbara integrationer.

🎯 Syfte

Att erbjuda en ekonomi i spelet baserad på föremål, där spelare kan lägga ut föremål till försäljning eller skapa köpbutiker med kistor. Pluginet är avsett för serveradministratörer som vill ha en fysisk, kistdriven ekonomi och kontroll per butik utan att tvinga spelare att lära sig kommandon.

⚙️ Funktioner

• Skapa köp- och säljbutiker med kistor och skyltar (kistbaserade butiker).
• Stöd för NBT-data, förtrollningar, föremålsskada, dryckesdata och mobägg.
• Växlingsbar virtuell visningsföremål ovanför butiker (stöds via ProtocolLib eller PacketEvents).
• Stöd för obegränsat antal kistor och blandat köp-/säljbeteende i dubbelkistor.
• Stöd för blacklist med bypass-alternativ för behörigheter.
• Behörighetshantering per butik och butikfördelar mellan ägare och andra spelare.
• i18n-stöd för namn på föremål och förtrollningar samt MiniMessage-syntax för meddelanden.
• Stöd för H2 (lokal) och MySQL (fjärr) datasource.
• Integrationshooks för vanliga skydds- och verktygsplugins (kompatibilitetsmoduler finns tillgängliga).
• Utvecklar-API (Maven/Gradle-koordinater anges) för att fråga butiker och integrera funktioner.
• bStats-telemetri med opt-out via konfiguration.

🧩 För vem är detta

För serverägare och administratörer som kör Survival/SMP eller ekonomifokuserade servrar och vill ha en fysisk, kistbaserad marknadsplats. Det passar små till stora servrar som använder Vault-kompatibla ekonomiplugins och vill ha kontroll per butik samt databaserad lagring.

🏗️ Exempel på användning

• Spelare lägger föremål i en kista och märker den för att automatiskt sälja stackar till andra spelare.
• En admin aktiverar behörigheter per butik så att moderatorer kan hantera butiker i specifika världar eller regioner.
• Ett nätverk använder MySQL-lagring för att hålla butiker beständiga mellan serverinstanser.

⌨️ Kommandon

Observera: projektets dokumentation säger att normalt spelande inte kräver kommandon; kommandon är främst administrativa.

🔐 Behörigheter

⚙️ Installation

📥 Installera

• Ladda ner den officiella QuickShop-Hikari-jarfilen från projektets distribution (Modrinth/Spigot/GitHub-releaser).
• Placera jar-filen i serverns plugins/-mapp.
• Starta servern och kontrollera att pluginet har laddats (dokumentationen visar att man kör kommandot qs i konsolen för att visa hjälp/testutdata).

📦 Beroenden

Bekräftade obligatoriska/valfria integrationer listade av projektet:

• Vault (obligatoriskt för ekonomibryggning)
• Ett Vault-kompatibelt ekonomiplugin (exempel anges av projektet)
• ProtocolLib eller PacketEvents (krävs för virtuella visningsföremål / lokalisering per spelare)
• LuckPerms (rekommenderas för behörighetshantering)

🧾 Konfiguration

• Pluginet skapar och använder config.yml (dokumentationen hänvisar till config.yml-nycklar för visningsprotokoll och integritetsinställningar).
• Datalagring stöder lokal H2 eller fjärr-MySQL; konfigurationsalternativ finns i pluginets konfigurationsfiler.

🧠 Tekniska anteckningar

• Den officiella dokumentationen rekommenderar körning på en Paper-baserad server och anger ett krav på Java 21.
• Projektet tillhandahåller ett utvecklar-API och Maven/Gradle-koordinater för användning vid kompilering.
• QuickShop-Hikari levererar kompatibilitetsmoduler för tredjepartsplugins (t.ex. WorldGuard, WorldEdit, OpenInv) som valfria nedladdningar.
• Telemetri: använder bStats; opt-out via konfigurationsinställningar.

🤝 När detta plugin är användbart

Om du vill ha en kistdriven, spelarnära marknadsplats med beständig lagring och kontroll per butik (i stället för enbart GUI- eller kommandodrivna butiker), erbjuder QuickShop-Hikari en modern, databasmässig implementation med hooks för vanliga ekonomi- och skyddsplugins.