Minecraft plugin Citizens

🔌 Over Citizens

Citizens is een Minecraft-plugin die een compleet systeem biedt voor het maken en beheren van NPC's aan serverzijde. Het ondersteunt veel NPC-types (player-achtig, mobs, shopkeepers, guards, statues) en biedt een API zodat andere plugins en eigen code gedrag, traits en integraties kunnen toevoegen.

🎯 Doel

Citizens voorziet in de behoefte aan persistente, configureerbare niet-spelerpersonages op een server: NPC's kunnen fungeren als interactieve shopkeepers, gescripte personages, guards die waypoints volgen, informatiekiosken of decoratieve standbeelden. De plugin wordt zowel gebruikt door servereigenaren om gameplayfuncties te bouwen als door ontwikkelaars om functionaliteit uit te breiden via de Citizens API.

⚙️ Functies

• NPC's aanmaken en verwijderen met in-game commando's.
• Meerdere NPC-types (player, op mobs gebaseerd, villagers, enz.).
• Commando's of gescripte acties aan NPC's toewijzen (klik/run-triggers, command attachments).
• Waypoints en patrouillegedrag voor bewegende NPC's.
• Traits en editors om het gedrag en uiterlijk van NPC's aan te passen.
• Sjablonen en persistentie zodat NPC's na herstarts blijven bestaan.
• Developer API voor addons, traits en integraties.

🧩 Voor wie is dit

• Servereigenaren die interactieve NPC's willen voor shops, gidsen of decor.
• Pluginontwikkelaars die een NPC-API nodig hebben om integraties of minigames te bouwen.
• Communityservers die decoratieve of functionele niet-spelerpersonages nodig hebben.

🏗️ Voorbeeldgebruik

• Een Survival-server gebruikt NPC-shopkeepers om items te verhandelen zonder economy-plugins.
• Een RPG-server script NPC's om quests en dialogen aan te bieden.
• Een admin plaatst patrouillerende guard-NPC's die waypoints rond een stad volgen.
• Ontwikkelaars koppelen custom traits aan NPC's voor interacties in minigames.

⌨️ Commando's

(Opmerking: /npc biedt veel subcommando's en fijnmazigere permission nodes voor specifieke functies; raadpleeg de documentatie van de plugin voor de volledige set commando's.)

🔐 Permissies

(Er zijn veel extra permission nodes voor specifieke commando's en traits; de permissiereferentie van de plugin beschrijft die in detail.)

⚙️ Installatie

📥 Setup

• Download de officiële Citizens-plugin JAR via de officiële distributie van het project (plugin-catalogus of downloads van het project).
• Plaats de JAR in je plugins/-map op een server die compatibel is met Spigot of Paper.
• Herstart de server en controleer de console om te bevestigen dat Citizens is geladen en zijn datamappen heeft aangemaakt.

📦 Afhankelijkheden

• Er worden standaard geen verplichte externe afhankelijkheden vermeld. Citizens wordt vaak uitgebreid met optionele addons (addons van derden of andere plugins), maar geen daarvan is verplicht voor de basiswerking.

🧠 Technische notities

• Citizens biedt een developer-facing API zodat andere plugins traits kunnen maken, met NPC's kunnen interageren en op NPC-events kunnen inhaken.
• De plugin slaat NPC-gegevens persistent op, zodat NPC's na herstarts blijven bestaan, en ondersteunt traits/editors voor aanpassing tijdens runtime.
• De officiële documentatie en community-wiki behandelen commando's, permissies, traits, editors en integratiepunten.

🤝 Wanneer deze plugin nuttig is

Als je duurzame, scripteerbare NPC's nodig hebt en een API om niet-spelerpersonages in gameplay of serversystemen te integreren, biedt Citizens het kernbeheer van NPC's, persistentie en uitbreidingspunten die nodig zijn voor zowel serverbeheerders als pluginontwikkelaars.