ZNPCs: plug-in om NPC's te maken in Minecraft
Afhankelijkheden: Servertype: Paper of Spigot 1.8.8–1.21.4 Minecraft-versie: 1.8.8–1.21.4 Afhankelijke plug-ins: PlaceholderAPI (optioneel…
Afhankelijkheden: Servertype: Paper of Spigot 1.8.8–1.21.4 Minecraft-versie: 1.8.8–1.21.4 Afhankelijke plug-ins: PlaceholderAPI (optioneel, voor variabelen in hologrammen) Downloaden: SpigotMC / GitHub Als je eenvoudige
Afhankelijkheden:
Servertype: Paper of Spigot 1.8.8–1.21.4
Minecraft-versie: 1.8.8–1.21.4
Afhankelijke plug-ins: PlaceholderAPI (optioneel, voor variabelen in hologrammen)
Downloaden: SpigotMC / GitHub
Als je eenvoudige NPC's nodig hebt voor een lobby of decoratie, kan Citizens te zwaar aanvoelen. ZNPCs lost dezelfde taak eenvoudiger op: het is één enkel .jar-bestand zonder een berg afhankelijkheden, waarmee je personages kunt plaatsen met een eigen skin, tekst en reactie op een klik.
Belangrijkste functies
Alle NPC's hebben een unieke numerieke ID. Je kunt een gewone speler maken met een skin op basis van een nickname of URL, of een mob plaatsen zoals een ZOMBIE of SKELETON.
Wanneer een speler op een NPC klikt, voert de plug-in de opgegeven acties uit. Dat kan een bericht zijn, een commando namens de speler of de console, of zelfs het versturen van de speler naar een andere server via BungeeCord. Als er meerdere acties zijn, worden ze één voor één uitgevoerd. Je kunt ook een cooldown (vertraging) instellen voor elke actie.
Tekst boven het hoofd (Lines)
Boven een NPC kun je tekst toevoegen met het commando lines. De plug-in ondersteunt kleurcodes, en als PlaceholderAPI geïnstalleerd is, ook variabelen zoals %player_name% of %server_online%. Je kunt de hoogte van de tekst ook wijzigen met het commando height.
Routes (Paths)
Een NPC hoeft niet op zijn plaats te blijven staan. Om hem te leren lopen, moet je de opnamemodus inschakelen (/znpcs path create <naam>) en de gewenste route zelf afleggen. Na afloop typ je /znpcs path exit. Vervolgens wijs je deze route toe aan een specifieke NPC (/znpcs path set <id> <naam>), en die begint er eindeloos overheen te bewegen.
Belangrijk detail: de beweging is heel simpel. ZNPCs gebruikt geen vanilla pathfinding (Pathfinder), dus de personages ontwijken obstakels niet en reageren niet op andere spelers.
Uitrusting en uiterlijk
Personages kun je harnassen aantrekken en voorwerpen in handen geven. Het volstaat om het gewenste item vast te houden en /znpcs equip <id> <slot> te typen (beschikbare slots: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
Ook kun je het gedrag van een NPC instellen via het commando toggle: hem naar nabije spelers laten kijken (look), de skin spiegelen van de speler die naar hem kijkt (mirror), of een gloed (glow) in de gekozen kleur toevoegen.
Commando's
Deze commando's vereisen beheerdersrechten (znpcs.admin).
Commando | Beschrijving | Recht |
| Maakt een NPC op jouw coördinaten | znpcs.admin |
| Verwijdert een NPC | znpcs.admin |
| Toont een lijst van NPC's en hun ID's | znpcs.admin |
| Teleporteert een NPC naar jou | znpcs.admin |
| Teleporteert jou naar een NPC | znpcs.admin |
| Wijzigt het type van een bestaande NPC | znpcs.admin |
| Wijzigt de skin van het personage | znpcs.admin |
| Geeft het item uit jouw hand aan de NPC | znpcs.admin |
| Wijzigt de tekst boven de NPC | znpcs.admin |
| Wijzigt de hoogte van de tekst (standaard 1) | znpcs.admin |
| Voegt een actie toe bij het klikken | znpcs.admin |
| Toont een lijst van NPC-acties (met hun ID) | znpcs.admin |
| Verwijdert een actie op basis van zijn ID | znpcs.admin |
| Stelt een vertraging in op de uitvoering van een actie | znpcs.admin |
| Neemt een nieuwe route op | znpcs.admin |
| Verlaat de opnamemodus voor routes | znpcs.admin |
| Wijst een route toe aan een NPC | znpcs.admin |
| Schakelt opties in/uit (look, holo, mirror) | znpcs.admin |
| Voegt een gloei-effect toe in de gekozen kleur | znpcs.admin |
Actietypes voor action add:
CMD (voert een commando uit namens de speler)
CONSOLE (voert een commando uit vanaf de console)
CHAT (de speler typt een bericht in de chat)
MESSAGE (stuurt een bericht naar de speler)
SERVER (stuurt door naar een andere server via BungeeCord)
Toegangsrechten
Hier is alles uiterst eenvoudig. Voor bijna alles is slechts één node nodig:
Node | Wat het geeft |
znpcs.admin | Volledige toegang tot alle commando's |
Configuratie
config.json
Parameter | Waarde | Beschrijving |
| 500 | Het maximale aantal punten (stappen) dat je kunt opnemen voor één NPC-route. Als de route te lang is, stopt de opname automatisch zodra deze limiet bereikt is. |
| "DEFAULT" | Het algoritme voor het genereren van interne namen voor NPC's. De standaardwaarde zorgt voor een correcte koppeling van de ID. |
| TRUE | Lijnt de NPC bij het aanmaken automatisch precies in het midden van het blok uit. Voorkomt dat het model naar de rand van het blok verschuift. |
| "-" | Het symbool dat de plug-in gebruikt om spaties in commandotekst te vervangen of bij het genereren van identifiers. |
| 600 | Het interval voor het automatisch opslaan van aangemaakte personages in het bestand npcs.json (600 seconden = 10 minuten). Beschermt tegen gegevensverlies bij een plotselinge crash van de server. |
| TRUE | Activering van de debugmodus. De plug-in begint gedetailleerde technische informatie en foutenlogboeken naar de serverconsole te sturen. Aanbevolen om uit te schakelen (false) op stabiele servers, voor een schone console. |
| 0.3 | De afstand tussen de regels van het hologram (de tekst) boven het hoofd van de NPC. Een kleinere waarde maakt de tekst compacter. |
| 32 | De straal (in blokken) waarbinnen de server pakketten naar de speler begint te sturen om het NPC-model te renderen. Een lagere waarde bespaart server- en clientbronnen. |
| FALSE | Ondersteuning voor dynamische kleurwisseling (RGB-overgang) voor hologramtekst. Inschakelen kan extra belasting voor de client veroorzaken. |
npcs.json
Alle aangemaakte NPC's worden weggeschreven naar het bestand npcs.json. De plug-in genereert het automatisch, dus je kunt het beter niet handmatig bewerken. De enige rechtvaardiging om in dit bestand te duiken is wanneer je geconfigureerde NPC's naar een andere server moet overzetten.
conversations.json
Alle dialogen worden hier opgeslagen.
paths
De map waarin alle opgenomen routes worden bewaard.
data.json
Hier wordt alle gedetailleerde informatie over de aangemaakte NPC's bewaard.
Integraties
Als PlaceholderAPI op de server geïnstalleerd is, pikt ZNPCs het automatisch op, zonder speciale uitbreidingen. Dat komt bijvoorbeeld van pas als je boven een NPC een dynamische online-teller wilt tonen.
Compatibiliteit
De originele ZNPCs werkt alleen goed tot versie 1.21.1. Voor nieuwere servers (1.21.1 en hoger) moet je de fork ZNPC Plus installeren.
Daarnaast draait de plug-in niet op Folia, vanwege de eigenaardigheden in de manier waarop het met entiteiten omgaat.
Wanneer ZNPCs gebruiken
Als je een NPC op de spawn moet plaatsen die gewoon een menu opent, een starterskit uitdeelt of spelers doorstuurt naar andere minigame-servers, dan is ZNPCs een uitstekende keuze. Het doet precies wat het belooft en belast de server niet met onnodige functionaliteit.
Maar als je vertakte dialogen of complexe quests wilt maken, heb je het ecosysteem van Citizens + Denizen nodig. Daar is ZNPCs niet voor bedoeld.
Installatie
Een typische installatie duurt ongeveer 5 minuten. De stappen zijn gelijk; alleen de loader en de bijbehorende build verschillen.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.








