ZNPCs: Plugin zum Erstellen von NPCs in Minecraft
Abhängigkeiten: Servertyp: Paper oder Spigot 1.8.8–1.21.4 Minecraft-Version: 1.8.8–1.21.4 Abhängige Plugins: PlaceholderAPI (optional, für…
Abhängigkeiten: Servertyp: Paper oder Spigot 1.8.8–1.21.4 Minecraft-Version: 1.8.8–1.21.4 Abhängige Plugins: PlaceholderAPI (optional, für Variablen in Hologrammen) Download: SpigotMC / GitHub Wenn du einfache NPCs für
Abhängigkeiten:
Servertyp: Paper oder Spigot 1.8.8–1.21.4
Minecraft-Version: 1.8.8–1.21.4
Abhängige Plugins: PlaceholderAPI (optional, für Variablen in Hologrammen)
Download: SpigotMC / GitHub
Wenn du einfache NPCs für die Lobby oder Dekorationen brauchst, könnte Citizens zu schwergewichtig sein. ZNPCs löst dieselbe Aufgabe einfacher: Es ist eine einzige .jar-Datei ohne einen Haufen Abhängigkeiten, mit der du Charaktere mit eigenem Skin, Text und Reaktion auf Klicks platzieren kannst.
Hauptfunktionen
Alle NPCs haben eine eindeutige numerische ID. Du kannst einen gewöhnlichen Spieler mit einem Skin per Nickname oder URL erstellen oder einen Mob wie einen ZOMBIE oder ein SKELETT platzieren.
Wenn ein Spieler auf einen NPC klickt, führt das Plugin die vorgegebenen Aktionen aus. Das kann eine Nachricht sein, ein Befehl im Namen des Spielers oder der Konsole oder sogar das Senden des Spielers an einen anderen Server über BungeeCord. Wenn es mehrere Aktionen gibt, werden sie nacheinander ausgeführt. Du kannst auch für jede Aktion einen Cooldown (Verzögerung) einstellen.
Text über dem Kopf (Lines)
Über einem NPC kannst du mit dem Befehl lines Text hinzufügen. Das Plugin unterstützt Farbcodes, und wenn PlaceholderAPI installiert ist, auch Variablen wie %player_name% oder %server_online%. Die Höhe des Textes kannst du mit dem Befehl height ändern.
Routen (Paths)
Ein NPC muss nicht zwingend an einem Ort stehen bleiben. Um ihm das Gehen beizubringen, musst du den Aufnahmemodus aktivieren (/znpcs path create <Name>) und die gewünschte Route selbst ablaufen. Nach dem Abschluss musst du /znpcs path exit eingeben. Anschließend wird diese Route einem bestimmten NPC zugewiesen (/znpcs path set <id> <Name>), und dieser beginnt, sie endlos abzulaufen.
Ein wichtiger Hinweis: Die Bewegung ist sehr einfach. ZNPCs verwendet keine Vanilla-Wegfindung (Pathfinder), daher umgehen die Charaktere keine Hindernisse und reagieren nicht auf andere Spieler.
Ausrüstung und Aussehen
Den Charakteren kannst du Rüstung anlegen und ihnen Gegenstände in die Hand geben. Es genügt, den gewünschten Gegenstand zu nehmen und /znpcs equip <id> <Slot> einzugeben (verfügbare Slots: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
Außerdem lässt sich das Verhalten des NPC über den Befehl toggle anpassen: Du kannst ihn dazu bringen, die nächstgelegenen Spieler anzusehen (look), den Skin des betrachtenden Spielers zu spiegeln (mirror) oder ein Leuchten (glow) in der gewählten Farbe hinzuzufügen.
Befehle
Diese Befehle erfordern Administratorrechte (znpcs.admin).
Befehl | Beschreibung | Recht |
| Erstellt einen NPC an deinen Koordinaten | znpcs.admin |
| Löscht einen NPC | znpcs.admin |
| Gibt eine Liste der NPCs und ihrer IDs aus | znpcs.admin |
| Teleportiert den NPC zu dir | znpcs.admin |
| Teleportiert dich zum NPC | znpcs.admin |
| Ändert den Typ eines bestehenden NPC | znpcs.admin |
| Ändert den Skin des Charakters | znpcs.admin |
| Gibt den Gegenstand aus deiner Hand an den NPC | znpcs.admin |
| Ändert den Text über dem NPC | znpcs.admin |
| Ändert die Höhe des Textes (Standard 1) | znpcs.admin |
| Fügt eine Aktion beim Klicken hinzu | znpcs.admin |
| Zeigt eine Liste der Aktionen des NPC (mit ihren IDs) | znpcs.admin |
| Entfernt eine Aktion anhand ihrer ID | znpcs.admin |
| Legt eine Verzögerung für die Ausführung der Aktion fest | znpcs.admin |
| Zeichnet eine neue Route auf | znpcs.admin |
| Beendet den Aufnahmemodus der Route | znpcs.admin |
| Weist dem NPC eine Route zu | znpcs.admin |
| Aktiviert/deaktiviert Optionen (look, holo, mirror) | znpcs.admin |
| Fügt einen Leuchteffekt in der gewählten Farbe hinzu | znpcs.admin |
Aktionstypen für action add:
CMD (führt einen Befehl im Namen des Spielers aus)
CONSOLE (führt einen Befehl über die Konsole aus)
CHAT (der Spieler schreibt eine Nachricht in den Chat)
MESSAGE (sendet eine Nachricht an den Spieler)
SERVER (sendet über BungeeCord an einen anderen Server)
Berechtigungen
Hier ist alles denkbar einfach. Für fast alles wird nur eine einzige Node benötigt:
Node | Was sie gewährt |
znpcs.admin | Vollzugriff auf alle Befehle |
Konfiguration
config.json
Parameter | Wert | Beschreibung |
| 500 | Maximale Anzahl der Punkte (Schritte), die für eine einzelne NPC-Route aufgezeichnet werden können. Ist die Route zu lang, stoppt die Aufzeichnung automatisch, sobald dieses Limit erreicht wird. |
| "DEFAULT" | Algorithmus zur Generierung interner Namen für NPCs. Der Standardwert sorgt für eine korrekte Zuordnung der IDs. |
| TRUE | Richtet den NPC bei seiner Erstellung automatisch genau in der Mitte des Blocks aus. Verhindert ein Verrutschen des Modells zum Blockrand. |
| "-" | Zeichen, das das Plugin verwendet, um Leerzeichen im Text von Befehlen oder bei der Generierung von Bezeichnern zu ersetzen. |
| 600 | Intervall für das automatische Speichern der erstellten Charaktere in der Datei npcs.json (600 Sekunden = 10 Minuten). Schützt vor Datenverlust bei einem plötzlichen Serverabsturz. |
| TRUE | Aktivierung des Debug-Modus. Das Plugin gibt detaillierte technische Informationen und Fehlerprotokolle in der Serverkonsole aus. Auf stabilen Servern wird empfohlen, ihn (false) zu deaktivieren, um die Konsole übersichtlich zu halten. |
| 0.3 | Abstand zwischen den Zeilen des Hologramms (Texts) über dem Kopf des NPC. Ein kleinerer Wert macht den Text gedrängter. |
| 32 | Radius (in Blöcken), innerhalb dessen der Server beginnt, dem Spieler Pakete zum Rendern des NPC-Modells zu senden. Ein niedrigerer Wert spart Ressourcen von Server und Client. |
| FALSE | Unterstützung für die dynamische Farbänderung (RGB-Farbverlauf) des Hologramm-Texts. Das Aktivieren kann zu zusätzlicher Last auf dem Client führen. |
npcs.json
Alle erstellten NPCs werden in der Datei npcs.json gespeichert. Das Plugin generiert sie automatisch, daher solltest du sie besser nicht von Hand bearbeiten. Die einzige Rechtfertigung, in diese Datei einzugreifen, ist, wenn du konfigurierte NPCs auf einen anderen Server übertragen möchtest.
conversations.json
Alle Dialoge werden hier gespeichert.
paths
Verzeichnis, in dem alle aufgezeichneten Routen gespeichert werden.
data.json
Hier werden alle detaillierten Informationen über die erstellten NPCs gespeichert.
Integrationen
Wenn auf dem Server PlaceholderAPI installiert ist, erkennt ZNPCs es automatisch ohne spezielle Erweiterungen. Das ist zum Beispiel nützlich, wenn du über einem NPC einen dynamischen Online-Zähler anzeigen möchtest.
Kompatibilität
Das originale ZNPCs funktioniert nur bis Version 1.21.1 einwandfrei. Für neuere Server (1.21.1 und höher) musst du den Fork ZNPC Plus installieren.
Außerdem läuft das Plugin aufgrund seiner Besonderheiten im Umgang mit Entitäten nicht auf Folia.
Wann sich ZNPCs lohnt
Wenn du am Spawn einen NPC platzieren möchtest, der einfach ein Menü öffnet, ein Startset ausgibt oder Spieler an andere Minispiel-Server weiterleitet, ist ZNPCs eine ausgezeichnete Wahl. Es macht genau das, was es verspricht, und belastet den Server nicht mit unnötiger Funktionalität.
Wenn du jedoch verzweigte Dialoge oder komplexe Quests erstellen möchtest, brauchst du das Ökosystem von Citizens + Denizen. Dafür ist ZNPCs nicht gedacht.
Installation
Eine typische Installation dauert etwa 5 Minuten. Der Ablauf ist gleich; nur Loader und der passende Build unterscheiden sich.
- 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.








