ZNPCs: plugin för att skapa NPC:er i Minecraft
Beroenden: Servertyp: Paper eller Spigot 1.8.8–1.21.4 Minecraft-version: 1.8.8–1.21.4 Beroende plugins: PlaceholderAPI (valfritt, för…
Beroenden: Servertyp: Paper eller Spigot 1.8.8–1.21.4 Minecraft-version: 1.8.8–1.21.4 Beroende plugins: PlaceholderAPI (valfritt, för variabler i hologram) Ladda ner: SpigotMC / GitHub Om du behöver enkla NPC:er för en
Beroenden:
Servertyp: Paper eller Spigot 1.8.8–1.21.4
Minecraft-version: 1.8.8–1.21.4
Beroende plugins: PlaceholderAPI (valfritt, för variabler i hologram)
Ladda ner: SpigotMC / GitHub
Om du behöver enkla NPC:er för en lobby eller dekoration kan Citizens kännas för tungt. ZNPCs löser samma uppgift enklare: det är en enda .jar-fil utan en hög med beroenden, som låter dig placera figurer med egen skin, text och reaktion på klick.
Huvudfunktioner
Alla NPC:er har ett unikt numeriskt ID. Du kan skapa en vanlig spelare med en skin utifrån smeknamn eller URL, eller placera en mob som en ZOMBIE eller SKELETON.
När en spelare klickar på en NPC utför pluginet de angivna åtgärderna. Det kan vara ett meddelande, ett kommando i spelarens eller konsolens namn, eller till och med att skicka spelaren till en annan server via BungeeCord. Om det finns flera åtgärder utförs de i tur och ordning. Du kan även ställa in en cooldown (fördröjning) för varje åtgärd.
Text ovanför huvudet (Lines)
Ovanför en NPC kan du lägga till text med kommandot lines. Pluginet stöder färgkoder, och om PlaceholderAPI är installerat även variabler, som %player_name% eller %server_online%. Du kan också ändra textens höjd med kommandot height.
Rutter (Paths)
En NPC behöver inte nödvändigtvis stå still. För att lära den att gå måste du slå på inspelningsläget (/znpcs path create <namn>) och själv gå den önskade rutten. När du är klar behöver du skriva /znpcs path exit. Därefter tilldelas rutten en specifik NPC (/znpcs path set <id> <namn>), och den börjar röra sig oändligt längs den.
Viktig detalj: rörelsen är väldigt enkel. ZNPCs använder inte vanilla-pathfinding (Pathfinder), så figurerna undviker inte hinder och reagerar inte på andra spelare.
Utrustning och utseende
Figurerna kan klädas i rustning och få föremål i händerna. Det räcker att hålla det önskade föremålet och skriva /znpcs equip <id> <slot> (tillgängliga slots: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
Det finns även möjlighet att ställa in NPC:ns beteende via kommandot toggle: få den att titta på närliggande spelare (look), spegla skinnet hos spelaren som tittar på den (mirror), eller lägga till en glöd (glow) i den valda färgen.
Kommandon
Dessa kommandon kräver administratörsrättigheter (znpcs.admin).
Kommando | Beskrivning | Rättighet |
| Skapar en NPC på dina koordinater | znpcs.admin |
| Tar bort en NPC | znpcs.admin |
| Visar en lista över NPC:er och deras ID:n | znpcs.admin |
| Teleporterar en NPC till dig | znpcs.admin |
| Teleporterar dig till en NPC | znpcs.admin |
| Ändrar typen på en befintlig NPC | znpcs.admin |
| Ändrar figurens skin | znpcs.admin |
| Ger föremålet från din hand till NPC:n | znpcs.admin |
| Ändrar texten ovanför NPC:n | znpcs.admin |
| Ändrar textens höjd (standard 1) | znpcs.admin |
| Lägger till en åtgärd vid klick | znpcs.admin |
| Visar en lista över NPC:ns åtgärder (med deras ID) | znpcs.admin |
| Tar bort en åtgärd utifrån dess ID | znpcs.admin |
| Ställer in en fördröjning för utförandet av en åtgärd | znpcs.admin |
| Spelar in en ny rutt | znpcs.admin |
| Lämnar inspelningsläget för rutter | znpcs.admin |
| Tilldelar en rutt till en NPC | znpcs.admin |
| Slår på/av alternativ (look, holo, mirror) | znpcs.admin |
| Lägger till en glödeffekt i den valda färgen | znpcs.admin |
Åtgärdstyper för action add:
CMD (kör ett kommando i spelarens namn)
CONSOLE (kör ett kommando från konsolen)
CHAT (spelaren skriver ett meddelande i chatten)
MESSAGE (skickar ett meddelande till spelaren)
SERVER (skickar vidare till en annan server via BungeeCord)
Åtkomsträttigheter
Här är allt så enkelt som möjligt. För nästan allt behövs bara en enda node:
Node | Vad den ger |
znpcs.admin | Full åtkomst till alla kommandon |
Konfiguration
config.json
Parameter | Värde | Beskrivning |
| 500 | Det maximala antalet punkter (steg) som kan spelas in för en enda NPC-rutt. Om rutten är för lång stoppas inspelningen automatiskt när denna gräns nås. |
| "DEFAULT" | Algoritmen för att generera interna namn för NPC:er. Standardvärdet säkerställer korrekt koppling av ID. |
| TRUE | Justerar automatiskt NPC:n exakt i mitten av blocket när den skapas. Förhindrar att modellen förskjuts mot blockets kant. |
| "-" | Symbolen som pluginet använder för att ersätta mellanslag i kommandotext eller vid generering av identifierare. |
| 600 | Intervallet för automatisk sparning av skapade figurer till filen npcs.json (600 sekunder = 10 minuter). Skyddar mot dataförlust vid en plötslig serverkrasch. |
| TRUE | Aktivering av felsökningsläget. Pluginet börjar skriva ut detaljerad teknisk information och felloggar till serverkonsolen. Rekommenderas att stängas av (false) på stabila servrar, för en ren konsol. |
| 0.3 | Avståndet mellan raderna i hologrammet (texten) ovanför NPC:ns huvud. Ett mindre värde gör texten mer kompakt. |
| 32 | Radien (i block) inom vilken servern börjar skicka paket till spelaren för att rita upp NPC-modellen. Att sänka värdet sparar server- och klientresurser. |
| FALSE | Stöd för dynamisk färgändring (RGB-övergång) för hologramtext. Att aktivera det kan skapa extra belastning på klienten. |
npcs.json
Alla skapade NPC:er skrivs till filen npcs.json. Pluginet genererar den automatiskt, så det är bäst att inte redigera den för hand. Den enda ursäkten att ge sig in i den här filen är när du behöver flytta konfigurerade NPC:er till en annan server.
conversations.json
Alla dialoger sparas här.
paths
Mappen där alla inspelade rutter sparas.
data.json
Här sparas all detaljerad information om de skapade NPC:erna.
Integrationer
Om PlaceholderAPI är installerat på servern fångar ZNPCs upp det automatiskt, utan särskilda tillägg. Det är användbart till exempel om du vill visa en dynamisk online-räknare ovanför en NPC.
Kompatibilitet
Det ursprungliga ZNPCs fungerar normalt endast upp till version 1.21.1. För nyare servrar (1.21.1 och högre) måste du installera forken ZNPC Plus.
Dessutom körs pluginet inte på Folia på grund av särdragen i hur det hanterar entiteter.
När du bör använda ZNPCs
Om du behöver placera en NPC på spawnen som helt enkelt öppnar en meny, delar ut ett startkit eller skickar spelare vidare till andra minispelsservrar är ZNPCs ett utmärkt val. Det gör precis vad det lovar och belastar inte servern med onödig funktionalitet.
Men om du planerar att skapa förgrenade dialoger eller komplexa uppdrag behöver du ekosystemet Citizens + Denizen. ZNPCs är inte avsett för det.
Installation
En typisk installation tar ungefär 5 minuter. Flödet är detsamma; bara Loader och den matchande builden skiljer sig.
- 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.








