Citizens

Erstelle NPCs (Nichtspielercharaktere), die wie Spieler aussehen, mit Dialogen, Laufwegen und Quest-Integration. Die Grundlage von RPG-Servern.

RPG und NPCs SpigotPaperPurpur

Über Citizens

Citizens ist ein Plugin zum Erstellen und Verwalten von NPCs (Nicht-Spieler-Charakteren) auf einem Minecraft-Server. NPCs sehen aus wie echte Spieler (mit jedem Skin, den du magst), werden aber vom Server gesteuert. Sie können an einer Stelle stehen, festgelegte Wege entlanglaufen, Gespräche führen, mit Spielern handeln und eine Rolle in Quests spielen. Citizens ist die Grundlage von RPG- und MMO-Servern. NPCs können verschiedene Rollen haben: Händler (verkauft und kauft Items), Wache (greift feindliche Mobs an), Führer (leitet Spieler entlang einer Route) oder Questgeber (verteilt Quests).

Das Plugin ist modular. Citizens allein bietet dir das Erstellen von NPCs und Laufwege. Denizen (ein separates Plugin) ergänzt fortgeschrittene Skripte, Dialoge und Quest-Mechaniken. Citizens lässt sich außerdem mit Sentinel (NPCs als Wachen oder Kämpfer) und BetonQuest (ein Quest-System) verbinden.

Citizens ist eines der wichtigsten RPG-Plugins, die du für deinen Minecraft-Server in Betracht ziehen solltest. Es unterstützt Minecraft 1.8.8 - 1.21.x und läuft auf Spigot, Paper und Purpur.

Funktionen von Citizens

Das sind die wichtigsten Funktionen, die Citizens deinem Server hinzufügt. Du kannst jede davon in der Konfigurationsdatei des Plugins einstellen.

NPCs mit beliebigem Skin
Laufwege (Wegpunkte)
Denizen-Integration (Dialoge)
Verschiedene NPC-Typen (Händler, Wache)
Sentinel (Kampf-NPCs)
Unterstützt über 20 Entitätstypen

Befehle von Citizens

Das sind die 6 wichtigsten Befehle von Citizens. Die vollständige Liste findest du in der offiziellen Dokumentation. Denk daran, dass du jeden Befehl über ein Permission-System (zum Beispiel LuckPerms) sperren oder erlauben kannst.

Befehl	Beschreibung	Permission
`/npc create [Name]`	Erstellt einen neuen NPC	`citizens.npc.create`
`/npc skin [Spieler]`	Gibt dem NPC den Skin eines Spieleraccounts	`citizens.npc.skin`
`/npc select`	Wählt einen NPC aus (Rechtsklick darauf)	`citizens.npc.select`
`/npc remove`	Entfernt den ausgewählten NPC	`citizens.npc.remove`
`/npc tphere`	Teleportiert den NPC zu dir	`citizens.npc.tphere`
`/npc lookclose`	Lässt den NPC den nächsten Spieler ansehen	`citizens.npc.lookclose`

Tipp: Nutze die Tab-Vervollständigung in der Serverkonsole (die Tab-Taste), um zu sehen, welche Argumente ein Befehl annimmt. Auf einem Server mit LuckPerms vergibst du Permissions an Gruppen, nicht an einzelne Spieler.

Permissions

Mit dem Permission-System steuerst du, wer welche Funktion von Citizens nutzen darf. Du vergibst Permissions über ein Rang-Plugin wie LuckPerms (/lp group [Gruppe] permission set [Node] true). Die Spalte „Standard-OP“ zeigt, ob Server-Operatoren die Permission ohne jede Konfiguration haben.

Permission-Node	Beschreibung	Standard-OP
`citizens.npc.create`	NPCs erstellen	Ja
`citizens.npc.edit`	NPCs bearbeiten	Ja
`citizens.npc.remove`	NPCs entfernen	Ja

Konfiguration von Citizens

Beim ersten Start erzeugt Citizens eine Konfigurationsdatei im Ordner plugins/Citizens/. Unten siehst du die wichtigsten Optionen mit Kommentaren. Die vollständige Liste der Einstellungen steht in der offiziellen Dokumentation.

# Citizens config.yml
npc:
  default:
    look-close:
      enabled: false       # Standardmäßig sehen NPCs Spieler nicht an
      range: 5             # Blickreichweite
    pathfinding:
      enabled: true
      attack-range: 1.75   # Angriffsreichweite von Wachen
  max-npcs-per-player: 10  # NPC-Limit pro Spieler

Speichere die Datei nach dem Ändern der Konfiguration und nutze einen Reload-Befehl (zum Beispiel /reload oder den plugineigenen Reload-Befehl). Wenn das Plugin die Änderungen nach einem Reload nicht übernimmt, starte den Server neu: Stoppe ihn mit /stop und starte ihn erneut.

YAML verzeiht keine Fehler. Ein einziges falsches Leerzeichen oder ein Tab kann die ganze Datei kaputt machen. Benutze einen Editor mit Syntaxhervorhebung (VS Code, Notepad++) und prüfe die Datei auf yamllint.com, bevor du sie auf den Server hochlädst.

So installierst du Citizens

Lade Citizens von der offiziellen Website herunter. Achte darauf, dass die Version zu deiner Minecraft-Version passt (1.8.8 - 1.21.x).
Kopiere die heruntergeladene .jar-Datei in den Ordner plugins/ im Verzeichnis deines Servers.
Stoppe den Server mit /stop und starte ihn erneut. Benutze bei der ersten Installation nicht /reload.
Sieh in die Serverkonsole. Wenn Citizens richtig geladen wurde, siehst du eine Meldung mit der Version des Plugins. Bei einem Fehler prüfe, ob du alle Abhängigkeiten installiert hast.
Konfiguriere das Plugin, indem du plugins/Citizens/config.yml (oder die entsprechende Datei) bearbeitest. Nutze nach Änderungen den Reload-Befehl.

Server-Kompatibilität: Citizens läuft auf Spigot, Paper und Purpur. Wir empfehlen Paper als Server-Engine: Es hat eine bessere Leistung und mehr APIs als Spigot.

Alternativen zu Citizens

Citizens ist nicht das einzige Plugin seiner Kategorie. Unten findest du Alternativen, die einen Blick wert sind, wenn du etwas anderes suchst oder Citizens deine Anforderungen nicht erfüllt.

FancyNPCs

Eine leichtere Alternative mit minimalistischem Ansatz zum Erstellen von NPCs.

ZNPCsPlus

Ein modernes, paketbasiertes NPC-Plugin, das ohne ProtocolLib funktioniert.

Häufige Fragen zu Citizens

Wie installiere ich Citizens?

Lade Citizens vom offiziellen CI-Server herunter. Lege die .jar-Datei in plugins/ und starte den Server neu. NPCs erstellst du mit dem Befehl /npc create [Name]. Für Dialoge und Quests installierst du Denizen oder BetonQuest. Eine ausführliche Anleitung mit Abhängigkeiten und Konfiguration findest du oben im Abschnitt zur Installation.

Auf welchen Server-Engines läuft Citizens?

Citizens läuft auf: Spigot, Paper, Purpur. Wir empfehlen Paper als Engine: Für die meisten Server bietet es die beste Balance zwischen Leistung und Plugin-Kompatibilität. Mehr zu Server-Engines kannst du in unserem Vergleich nachlesen.

Ist Citizens kostenlos?

Citizens ist auf der offiziellen Website erhältlich. Die Lizenzdetails findest du auf der Download-Seite.

Citizens funktioniert nicht. Was soll ich tun?

Sieh dir die Datei logs/latest.log im Verzeichnis deines Servers an. Die häufigsten Fehlerursachen sind: (1) eine fehlende Abhängigkeit, (2) eine inkompatible Minecraft-Version (prüfe, ob deine Serverversion innerhalb von 1.8.8 - 1.21.x liegt), (3) ein Fehler in der config.yml (prüfe die YAML-Formatierung), (4) ein Konflikt mit einem anderen Plugin, das dasselbe macht.

Kann ich Citizens auf einem Bedrock-Server nutzen?

Nein. Citizens ist ein Plugin für die Java Edition und läuft auf Spigot/Paper/Purpur-Servern. Die Bedrock Edition nutzt ein anderes System (Behavior Packs). Wenn du Java- und Bedrock-Spieler auf einem Server haben willst, schau dir Geyser an.