Minecraft plugin QuickShop-Hikari

🔌 Over QuickShop-Hikari

QuickShop-Hikari is een Minecraft-plugin die op kisten gebaseerde koop/verkoopwinkels (ChestShops) implementeert. Spelers maken en gebruiken winkels door met kisten te interageren; voor het grootste deel van de gameplay zijn geen commando's nodig. Het project wordt onderhouden door de QuickShop-Community en richt zich op moderne compatibiliteit, dataveiligheid en uitbreidbare integraties.

🎯 Doel

Een in-game, op items gebaseerde economie bieden waarin spelers items te koop kunnen aanbieden of koopwinkels kunnen maken met kisten. De plugin is bedoeld voor serverbeheerders die een fysieke, op kisten gebaseerde economie willen met controle per winkel, zonder spelers te verplichten commando's te leren.

⚙️ Functies

• Koop- en verkoopwinkels maken met kisten en borden (op kisten gebaseerde winkels).
• Ondersteuning voor NBT-gegevens, enchantments, itemschade, potion-gegevens en mob-eieren.
• In- of uitschakelbaar virtueel display-item boven winkels (ProtocolLib of PacketEvents ondersteund).
• Ondersteuning voor onbeperkte kisten en gemengd koop/verkoopgedrag bij dubbele kisten.
• Blacklist-ondersteuning met bypass-permissie-opties.
• Permissiebeheer per winkel en winkelvoordelen tussen eigenaren en andere spelers.
• i18n-ondersteuning voor item- en enchantmentnamen en MiniMessage-syntaxis voor berichten.
• Ondersteuning voor H2-(lokaal) en MySQL-(extern) datasource.
• Integratiehooks voor veelgebruikte protection- en utility-plugins (compatibiliteitsmodules beschikbaar).
• Developer-API (Maven/Gradle-coördinaten beschikbaar) voor het opvragen van winkels en integreren van functies.
• bStats-telemetrie met opt-out via configuratie.

🧩 Voor wie is dit

Servereigenaren en -beheerders die Survival/SMP of op economie gerichte servers draaien en een fysieke, op kisten gebaseerde marktplaats willen. Het past bij kleine tot grote servers die Vault-compatibele economieplugins gebruiken en controle per winkel plus database-opslag willen.

🏗️ Voorbeeldgebruik

• Spelers plaatsen items in een kist en labelen die om automatisch stapels aan andere spelers te verkopen.
• Een admin schakelt permissies per winkel in zodat moderators winkels kunnen beheren in specifieke werelden of regio's.
• Een netwerk gebruikt MySQL-opslag om winkels persistent te houden over meerdere serverinstanties.

⌨️ Commando's

Opmerking: de documentatie van het project geeft aan dat normaal spelersgedrag geen commando's vereist; commando's zijn vooral administratief.

🔐 Permissies

⚙️ Installatie

📥 Setup

• Download de officiële QuickShop-Hikari-jar uit de distributie van het project (Modrinth/Spigot/GitHub releases).
• Plaats het jar-bestand in de map plugins/ van je server.
• Start de server en controleer of de plugin geladen is (de documentatie laat zien dat je het commando qs in de console uitvoert om de hulp-/testoutput te tonen).

📦 Afhankelijkheden

Bevestigde vereiste/optionele integraties volgens het project:

• Vault (vereist voor economie-koppeling)
• Een Vault-compatibele economieplugin (voorbeelden gegeven door het project)
• ProtocolLib of PacketEvents (vereist voor virtuele display-items / lokalisatie per speler)
• LuckPerms (aanbevolen voor permissiebeheer)

🧾 Configuratie

• De plugin maakt config.yml aan en gebruikt deze (de documentatie verwijst naar config.yml-sleutels voor display-protocol en privacy-instellingen).
• Datopslag ondersteunt lokale H2 of externe MySQL; configuratie-opties zijn beschikbaar in de configuratiebestanden van de plugin.

🧠 Technische notities

• De officiële documentatie raadt aan te draaien op een Paper-gebaseerde server en vermeldt een vereiste van Java 21.
• Het project biedt een developer-API en Maven/Gradle-coördinaten voor gebruik tijdens het compileren.
• QuickShop-Hikari levert compatibiliteitsmodules voor plugins van derden (bijv. WorldGuard, WorldEdit, OpenInv) als optionele downloads.
• Telemetrie: gebruikt bStats; opt-out via config-instellingen.

🤝 Wanneer deze plugin nuttig is

Als je een marktplaats wilt die op kisten is gebaseerd, zichtbaar is voor spelers, persistente opslag heeft en controle per winkel biedt (in plaats van alleen GUI- of commando-gebaseerde winkels), biedt QuickShop-Hikari een moderne, database-gestuurde implementatie met hooks voor veelgebruikte economie- en protection-plugins.