Minecraft-plugin QuickShop-Hikari

🔌 Om QuickShop-Hikari

QuickShop-Hikari er et Minecraft-plugin, der implementerer kistebaserede køb/salg-butikker (ChestShops). Spillere opretter og bruger butikker ved at interagere med kister; det meste gameplay kræver ingen kommandoer. Projektet vedligeholdes af QuickShop-Community og fokuserer på moderne kompatibilitet, datasikkerhed og udvidelige integrationer.

🎯 Formål

At tilbyde en økonomi i spillet baseret på items, hvor spillere kan sætte items til salg eller oprette køb-butikker ved hjælp af kister. Pluginet er målrettet serveradministratorer, der ønsker en fysisk, kistedrevet økonomi og kontrol pr. butik uden at tvinge spillere til at lære kommandoer.

⚙️ Funktioner

• Opret køb- og salgsbutikker med kister og skilte (kistebaserede butikker).
• Understøttelse af NBT-data, enchantments, item damage, potion-data og mob-æg.
• Slå til/fra virtuel display-item over butikker (understøttet af ProtocolLib eller PacketEvents).
• Understøttelse af ubegrænsede kister og blandet køb/salg-adfærd i dobbeltkister.
• Blacklist-understøttelse med bypass-tilladelsesmuligheder.
• Tilladelsesstyring pr. butik og butikfordele mellem ejere og andre spillere.
• i18n-understøttelse for item- og enchantmentnavne samt MiniMessage-syntaks til beskeder.
• Understøttelse af H2 (lokal) og MySQL (fjern) datasource.
• Integrations-hooks til almindelige protection- og utility-plugins (kompatibilitetsmoduler tilgængelige).
• Developer-API (Maven/Gradle-koordinater er angivet) til forespørgsler på butikker og integration af funktioner.
• bStats-telemetri med mulighed for at fravælge via konfiguration.

🧩 Hvem er det til

Til serverejere og administratorer, der kører Survival/SMP eller økonomifokuserede servere og ønsker en fysisk markedsplads baseret på kister. Det passer til små og store servere, som bruger Vault-kompatible økonomiplugins og ønsker kontrol pr. butik samt databasebaseret lagring.

🏗️ Eksempler på brug

• Spillere lægger items i en kiste og mærker den for automatisk at sælge stakke til andre spillere.
• En admin aktiverer tilladelser pr. butik, så moderatorer kan administrere butikker i bestemte verdener eller regioner.
• Et netværk bruger MySQL-lagring til at holde butikker vedvarende på tværs af serverinstanser.

⌨️ Kommandoer

Bemærk: projektets dokumentation angiver, at normalt spiller-gameplay ikke kræver kommandoer; kommandoer er primært administrative.

🔐 Tilladelser

⚙️ Installation

📥 Opsætning

• Download den officielle QuickShop-Hikari jar fra projektets distribution (Modrinth/Spigot/GitHub releases).
• Læg jar-filen i serverens plugins/-mappe.
• Start serveren og bekræft, at pluginet er indlæst (dokumentationen viser, at man kører qs i konsollen for at vise hjælp/testoutput).

📦 Afhængigheder

Bekræftede påkrævede/valgfrie integrationer angivet af projektet:

• Vault (påkrævet for økonomibro)
• Et Vault-kompatibelt økonomiplugin (eksempler er angivet af projektet)
• ProtocolLib eller PacketEvents (påkrævet til virtuelle display-items / lokalisering pr. spiller)
• LuckPerms (anbefalet til tilladelsesstyring)

🧾 Konfiguration

• Pluginet opretter og bruger config.yml (dokumentationen henviser til config.yml-nøgler for display-protokol og privatlivsindstillinger).
• Datalagring understøtter lokal H2 eller fjern MySQL; konfigurationsmuligheder findes i pluginets konfigurationsfiler.

🧠 Tekniske noter

• Den officielle dokumentation anbefaler at køre på en Paper-baseret server og beskriver et krav om Java 21.
• Projektet leverer et developer-API og Maven/Gradle-koordinater til brug ved kompilering.
• QuickShop-Hikari leveres med kompatibilitetsmoduler til tredjepartsplugins (f.eks. WorldGuard, WorldEdit, OpenInv) som valgfrie downloads.
• Telemetri: bruger bStats; opt-out via config-indstillinger.

🤝 Hvornår dette plugin er nyttigt

Hvis du vil have en kistedrevet markedsplads rettet mod spillere, med vedvarende lagring og kontrol pr. butik (i stedet for kun GUI- eller kommandodrevne butikker), tilbyder QuickShop-Hikari en moderne, databasebaseret implementering med hooks til almindelige økonomi- og protection-plugins.