Skip to main content

Unterstützte Software

Unterstützte NPC-Anbieter

Verwende /scnpcs create für einen neuen NPC. Nutze /scnpcs link, wenn der NPC bereits in Citizens, FancyNpcs, MythicMobs oder ZNPCsPlus existiert. Du benötigst mindestens einen unterstützten Anbieter. Das NPCs-Plugin deaktiviert sich beim Start, wenn es keinen findet.
NPC-Definitionen, Anbieterdaten und Weltobjekte müssen zusammenbleiben. Am einfachsten betreibst du das Plugin auf einer persistenten Lobby.Für eine temporäre Servergruppe konfigurierst du die NPCs auf einem persistenten Staging-Server. Stoppe ihn sauber und kopiere anschließend die Welt, plugins/simplecloud-npc/ und die Anbieterdaten ins Gruppen-Template. Kopiere keine laufende Welt ins Template.

Plugin installieren

1

Plugins installieren

Lade das NPCs-Plugin von GitHub und einen unterstützten NPC-Anbieter herunter. Lege beide JAR-Dateien im Ordner plugins/ des Paper-Server-Templates ab.Die Standard-Templates enthalten simplecloud-api bereits. Füge es bei einem eigenen Template über die Einstellung Plugins des Ziels oder über die CLI hinzu.
2

NPC für ein Ziel erstellen

Starte den Server und stelle dich an die gewünschte Position. Wähle eine eindeutige ID und den Namen einer bestehenden SimpleCloud-Gruppe oder eines persistenten Servers. Führe für die Gruppe Lobby diesen Befehl aus:
Sind mehrere Anbieter installiert, die NPCs erstellen können, gib den Anbieter an:
3

Ergebnis prüfen

Führe /scnpcs info lobby-selector aus. Der Status sollte complete sein und der NPC ein zweizeiliges Hologramm haben. Ein Rechtsklick verbindet dich mit dem verfügbaren Lobby-Server, auf dem die wenigsten Spieler sind.

Bestehenden NPC verknüpfen

Verwende die native Referenz des Anbieters, wenn der NPC bereits existiert:
Der Befehl erstellt die SimpleCloud-ID lobby-selector, verknüpft den Citizens-NPC 12 und setzt Lobby als Ziel. Die Referenz unterscheidet sich je nach Anbieter; nutze die Befehlsvorschläge, um einen installierten Anbieter und NPC auszuwählen. Das Anbieter-Plugin verwaltet verknüpfte NPCs weiterhin. /scnpcs unlink lobby-selector entfernt nur die SimpleCloud-Konfiguration und das Hologramm.

Standardverhalten

Ein neuer oder verknüpfter NPC erhält:
  • ein Hologramm default mit Zielname und Spielerzahl
  • ein Hologramm maintenance, das das Ziel als nicht verfügbar anzeigt
  • eine Rechtsklick-Aktion, die im Status default mit dem Ziel verbindet
  • eine Rechtsklick-Nachricht im Status maintenance
Bei einer Gruppe wählt die Verbindungsaktion den AVAILABLE-Server mit den wenigsten Spielern. Bei einem persistenten Server verwendet sie dessen Registrierungsnamen auf dem Proxy.

Befehle

Der Hauptbefehl ist als /simplecloudnpcs, /scnpcs und /scnpc verfügbar.
Wenn SimpleCloud den NPC erstellt hat, löscht /scnpcs delete auch den NPC beim Anbieter. Verwende /scnpcs unlink, wenn du ihn behalten möchtest.

Ziele ändern

Ein NPC kann mehrere Ziele nacheinander prüfen und das erste mit einem verfügbaren Server verwenden.
Ein NPC muss mindestens ein Ziel behalten. Bei Gruppen und persistenten Servern wird die Groß- und Kleinschreibung nicht beachtet. Ein Name ist ungültig, wenn er beide Ressourcentypen bezeichnet.

Hologramm bearbeiten

Der Joinstate wählt das Hologramm-Layout aus. Verwende default für den Normalbetrieb und maintenance, wenn die Eigenschaft joinstate des Ziels auf maintenance steht.
Zeilennummern beginnen bei 1. /scnpcs help hologram zeigt die Befehle zum Aktivieren, Deaktivieren, Hinzufügen, Ändern und Entfernen.

Zielplatzhalter

Klickaktionen konfigurieren

Aktionen gelten jeweils für eine Interaktion und einen Joinstate. Unterstützt werden RIGHT_CLICK, LEFT_CLICK, SHIFT_RIGHT_CLICK und SHIFT_LEFT_CLICK. Diese Befehle behalten die Standardaktion zum Verbinden bei und ergänzen Rückmeldungen für den Spieler:
Das Plugin kann außerdem einen Spielerbefehl ausführen, den Spieler teleportieren, einen Titel anzeigen, ihn zu einem auf dem Proxy registrierten Server senden oder an eine externe Adresse übertragen. Die genauen Befehlsformen stehen unter /scnpcs help action. execute-command unterstützt <playername> und <playeruuid> im konfigurierten Befehl.

Berechtigungen

Fehlerbehebung

Installiere Citizens, FancyNpcs, MythicMobs oder ZNPCsPlus auf demselben Paper-Server und starte ihn neu. In der Konsole erscheint die Liste der verfügbaren Anbieter.
Mehrere installierte Anbieter können NPCs erstellen. Ergänze den Befehl um citizens, fancynpcs oder znpcsplus.
Prüfe, ob die Gruppe oder der persistente Server existiert. Verwenden beide Ressourcentypen denselben Namen, musst du einen davon vor dem Erstellen oder Verknüpfen umbenennen.
Führe /scnpcs info <id> aus und behebe einen unvollständigen Status. Für eine Gruppe muss mindestens ein Server den Status AVAILABLE haben. Ein persistenter Server muss aktiv und auf dem Proxy registriert sein.
SimpleCloud-NPC mit zweizeiligem Statushologramm