Minecraft plugin Shopkeepers

🔌 Over Shopkeepers

Shopkeepers is een Minecraft Bukkit/Spigot-plug-in waarmee servereigenaren aanpasbare villager-shopkeepers kunnen plaatsen die geconfigureerde items verkopen voor geconfigureerde prijzen. De plug-in ondersteunt zowel admin shops (oneindige voorraad) als player shops die voorraad uit een container halen, en publiceert ook ShopkeepersAPI voor addon-integratie en uitbreidingen.

🎯 Doel

De plug-in biedt een in-game winkelsysteem op basis van NPC's, zodat servers permanente winkels kunnen aanbieden zonder handmatig chestbeheer of complexe winkels met commando's. Het is geschikt voor servereconomieën, roleplay-winkels en survival/SMP-servers die NPC-handelaren willen. ()

⚙️ Functies

• Maak aangepaste villager-shopkeepers met gedefinieerde trades en prijzen.
• Admin shops met oneindige voorraad.
• Player shops die items uit een gekoppelde container (chest) halen voor voorraad.
• ShopkeepersAPI voor plug-inontwikkelaars om shopkeepers programmatisch op te vragen en te beheren.
• Aanpassing van items/itemgegevens in-game en ondersteuning voor taalbestanden via de wiki en taalbestanden van het project. ()

🧩 Voor wie is het

• Survival- en SMP-servers die door NPC's beheerde winkels willen.
• Roleplay- of economy-servers die villager-NPC's als handelaren gebruiken.
• Plug-inontwikkelaars die een API nodig hebben om winkelgedrag in andere systemen te integreren. ()

🏗️ Voorbeeldtoepassingen

• Een admin maakt een oneindige admin shop die servergoederen verkoopt.
• Een speler opent een winkel die automatisch items verkoopt uit een gekoppelde chest.
• Een ontwikkelaar bouwt een addon die shopkeepers weergeeft of wijzigt met behulp van ShopkeepersAPI. ()

⌨️ Commando's

(Opmerking: hierboven staan alleen commando's die expliciet door officiële bronnen zijn gedocumenteerd.) ()

⚙️ Installatie

📥 Instellen

• Download de officiële plug-in-jar en plaats deze in de plugins/-map van je server.
• Start de server opnieuw op en controleer de serverconsole om te bevestigen dat de plug-in is geladen.

(Dit zijn de standaardinstallatiestappen voor Bukkit/Spigot-plug-ins en worden ondersteund door de documentatie van het project.) ()

🧠 Technische opmerkingen

• Shopkeepers is uitgebracht onder de GPL-3.0-licentie en de projectrepository bevat een API-module (ShopkeepersAPI) en build-instructies. ()
• Het project biedt Maven-artifacts en een gepubliceerde API voor addonontwikkelaars; de README beschrijft het gebruik van de repository en de afhankelijkheidscoördinaten van de API. ()
• Officiële distributie en communitysupport zijn beschikbaar via de Spigot-resourcepagina en de Discord-server van de plug-in. ()

🤝 Wanneer deze plug-in nuttig is

Als je permanente, configureerbare NPC-handelaren nodig hebt met ondersteuning voor zowel admin shops als door spelers beheerde winkels, en je een API wilt om winkels in andere plug-ins te integreren, biedt Shopkeepers een bewezen implementatie voor Bukkit/Spigot-servers. ()