Minecraft-Plugin Citizens

🔌 Über Citizens

Citizens ist ein Minecraft-Plugin, das ein vollständiges System zum Erstellen und Verwalten von serverseitigen NPCs bereitstellt. Es unterstützt viele NPC-Typen (spielerähnlich, Mobs, Händler, Wachen, Statuen) und bietet eine API, damit andere Plugins und eigener Code Verhaltensweisen, Traits und Integrationen hinzufügen können.

🎯 Zweck

Citizens löst den Bedarf an persistenten, konfigurierbaren Nicht-Spieler-Charakteren auf einem Server: NPCs können als interaktive Händler, geskriptete Figuren, Wachen, die Wegpunkten folgen, Informationsstände oder dekorative Statuen dienen. Das Plugin wird sowohl von Serverbesitzern genutzt, um Gameplay-Funktionen aufzubauen, als auch von Entwicklern, um über die Citizens API Funktionen zu erweitern.

⚙️ Funktionen

• NPCs mit In-Game-Befehlen erstellen und entfernen.
• Mehrere NPC-Typen (Spieler, Mob-basiert, Dorfbewohner usw.).
• NPCs Befehle oder geskriptete Aktionen zuweisen (Klick-/Auslöser, Befehlsanhänge).
• Wegpunkte und Patrouillenverhalten für bewegliche NPCs.
• Traits und Editoren, um Verhalten und Aussehen von NPCs anzupassen.
• Vorlagen und Persistenz, damit NPCs Neustarts überstehen.
• Entwickler-API für Add-ons, Traits und Integrationen.

🧩 Für wen es ist

• Serverbesitzer, die interaktive NPCs für Shops, Guides oder Deko möchten.
• Plugin-Entwickler, die eine NPC-API für Integrationen oder Minispiele benötigen.
• Community-Server, die dekorative oder funktionale Nicht-Spieler-Charaktere brauchen.

🏗️ Beispielanwendungen

• Ein Survival-Server nutzt NPC-Händler, um Gegenstände ohne Economy-Plugins zu handeln.
• Ein RPG-Server skriptet NPCs, um Quests und Dialoge bereitzustellen.
• Ein Admin platziert patrouillierende Wachen-NPCs, die Wegpunkten durch eine Stadt folgen.
• Entwickler hängen benutzerdefinierte Traits an NPCs für Minigame-Interaktionen an.

⌨️ Befehle

(Hinweis: /npc bietet viele Unterbefehle und feinere Berechtigungsstufen für bestimmte Funktionen; die vollständige Befehlsliste findest du in der Plugin-Dokumentation.)

🔐 Berechtigungen

(Es gibt viele zusätzliche Berechtigungseinträge für bestimmte Befehle und Traits; die Berechtigungsreferenz des Plugins listet sie ausführlich auf.)

⚙️ Installation

📥 Einrichtung

• Lade die offizielle Citizens-Plugin-JAR aus der offiziellen Distribution des Projekts herunter (Plugin-Katalog oder Projekt-Downloads).
• Lege die JAR in das Verzeichnis plugins/ deines Servers auf einem Spigot- oder Paper-kompatiblen Server.
• Starte den Server neu und prüfe die Konsole, um zu bestätigen, dass Citizens geladen wurde und seine Datenverzeichnisse erstellt hat.

📦 Abhängigkeiten

• Standardmäßig sind keine externen Pflichtabhängigkeiten angegeben. Citizens wird häufig durch optionale Add-ons erweitert (Add-ons von Drittanbietern oder andere Plugins), aber für den Grundbetrieb ist keines davon erforderlich.

🧠 Technische Hinweise

• Citizens stellt eine Entwickler-API bereit, damit andere Plugins Traits erstellen, mit NPCs interagieren und NPC-Ereignisse einbinden können.
• Das Plugin speichert NPC-Daten persistent, sodass NPCs nach Neustarts erhalten bleiben, und unterstützt Traits/Editoren für Anpassungen zur Laufzeit.
• Die offizielle Dokumentation und ein Community-Wiki behandeln Befehle, Berechtigungen, Traits, Editoren und Integrationspunkte.

🤝 Wann dieses Plugin nützlich ist

Wenn du langlebige, skriptbare NPCs und eine API brauchst, um Nicht-Spieler-Charaktere in Gameplay oder Serversysteme einzubinden, bietet Citizens die zentrale NPC-Verwaltung, Persistenz und die Erweiterungspunkte, die sowohl Serveradministratoren als auch Plugin-Entwickler benötigen.