NPCs

Überblick

Das SimpleCloud NPC Plugin fügt NPCs aus unterstützten NPC-Plugins SimpleCloud-Aktionen, Hologramme und Feedback-Optionen hinzu. Du erstellst den NPC in deinem NPC-System und verwendest danach /scnpc apply <id>, damit SimpleCloud Interaktionen für diesen NPC verwaltet.

Dieses Plugin benötigt ein unterstütztes NPC-Plugin auf dem Server. Ein Standalone-Namespace-Modul existiert im Repository, wird vom aktuellen Paper Plugin aber nicht geladen.

Unterstützte Software

Servertyp	Plugin-Unterstützung
Paper & Forks	Ja
Spigot	Nein

Unterstützte NPC-Plugins

Plugin	Status	Hinweise
Citizens	Unterstützt	Links- und Rechtsklick
FancyNpcs	Unterstützt	Nutzt FancyNpcs-Namen als IDs
MythicMobs	Unterstützt	Rechtsklick
PlayerNPC	Unterstützt	Nutzt PlayerNPC-IDs

Schnellstart

Lade das SimpleCloud NPC Plugin von GitHub herunter.
Installiere ein unterstütztes NPC-Plugin.
Stelle sicher, dass das simplecloud-api Plugin auf dem Server installiert ist.
Lege die Plugins im plugins/-Ordner deines Server-Templates ab.
Starte den Server.
Erstelle einen NPC mit deinem NPC-Plugin.
Führe /scnpc apply <id> aus, um eine SimpleCloud-Konfiguration für ihn zu erstellen.

Befehle

Der Befehl ist als /simplecloudnpc, /scnpc und /cloudnpc verfügbar.

Befehl	Beschreibung
`/scnpc`	Hilfe anzeigen
`/scnpc apply <id>`	SimpleCloud-Konfiguration für einen existierenden NPC erstellen
`/scnpc <id>`	Hilfe für einen NPC anzeigen
`/scnpc <id> setHologramGroup <name>`	Gruppe für Hologramm-Platzhalter setzen
`/scnpc <id> setOption <key> <value>`	Globale Player-Feedback-Option setzen
`/scnpc <id> getOption <key>`	Globalen Optionswert anzeigen
`/scnpc <id> removeOption <key>`	Globale Option entfernen
`/scnpc openInventory <name>`	Konfiguriertes SimpleCloud-NPC-Inventar öffnen
`/scnpc createInventory <name> <groupName>`	Inventar für eine Gruppe erstellen
`/scnpc <id> interact <interaction>`	Interaktionsdetails anzeigen
`/scnpc <id> interact <interaction> setAction <action>`	Aktion für eine Interaktion setzen
`/scnpc <id> interact <interaction> setOption <key> <value>`	Interaktionsoption setzen
`/scnpc <id> interact <interaction> getOption <key>`	Interaktionsoption anzeigen
`/scnpc <id> interact <interaction> removeOption <key>`	Interaktionsoption entfernen

Berechtigungen

Berechtigung	Beschreibung
`simplecloud.command.npc`	Alle NPC-Befehle verwenden

Interaktionen

Die Standard-Interaktionen sind:

RIGHT_CLICK
LEFT_CLICK

Ein Namespace kann weniger Interaktionen anbieten. MythicMobs unterstützt aktuell nur RIGHT_CLICK.

Aktionen

Aktion	Erforderliche Optionen	Beschreibung
`RUN_COMMAND`	`command.name`	Führt einen Befehl als Spieler aus
`RUN_CONSOLE_COMMAND`	`command.name`	Führt einen Befehl als Konsole aus
`CONNECT_TO_SERVER`	`server.name`	Sendet den Spieler zu einem Proxy-registrierten Server
`TRANSFER_TO_SERVER`	`server.ip`, `server.port`	Transferiert den Spieler zu einem externen Server
`QUICK_JOIN`	`group.name`	Findet einen Server in einer Gruppe und sendet den Spieler dorthin
`OPEN_INVENTORY`	`inventory.name`	Öffnet ein konfiguriertes Inventar

RUN_COMMAND und RUN_CONSOLE_COMMAND unterstützen <playername> und <playeruuid> in command.name.

Quick-Join-Optionen

Option	Standard	Beschreibung
`group.name`	Erforderlich	Gruppe, die durchsucht wird
`server.name.pattern`	`<group_name>-<numerical_id>`	Servername, der an den Proxy übergeben wird
`filter.player.count`	`LEAST`	`LEAST` oder `MOST` für die Spielerauswahl
`filter.server.state`	`AVAILABLE`	Erforderlicher Serverstatus
`message.failed.server.finder`	Leer	Optionale Nachricht, wenn kein Server passt

Feedback-Optionen

Feedback-Optionen können global auf dem NPC oder auf einer Interaktion gesetzt werden. Sie laufen zusätzlich zur Interaktionsaktion.

Option	Beschreibung
`send.message`	Chatnachricht senden
`send.actionbar`	Actionbar-Nachricht senden
`send.title`	Titel anzeigen
`send.subtitle`	Untertitel anzeigen
`play.sound`	Adventure-Sound-Key abspielen
`sound.volume`	Lautstärke, Standard `3F`
`sound.pitch`	Pitch, Standard `2F`
`sound.source`	Soundquelle, Standard `master`

NPC-Konfiguration

Die erzeugte NPC-Konfiguration speichert Hologramme, Interaktionen und globale Optionen.

version: "3"
id: "0"

hologramConfiguration:
  placeholderGroupName: "lobby"
  holograms:
    - startHeight: 2.073
      joinState: ""
      lores:
        - text: "<#38bdf8><bold><group_name>"
          billboard: CENTER
          alignment: CENTER
        - text: "waiting for <#a3a3a3><group_player_count:available> players"
          billboard: CENTER
          alignment: CENTER

actions:
  - playerInteraction: LEFT_CLICK
    action: QUICK_JOIN
    options:
      group.name: lobby
      filter.player.count: LEAST
      filter.server.state: AVAILABLE
      server.name.pattern: "<group_name>-<numerical_id>"

  - playerInteraction: RIGHT_CLICK
    action: TRANSFER_TO_SERVER
    options:
      server.ip: demo-server.com
      server.port: "25565"

options:
  send.message: "<#38bdf8>Choose a server"
  play.sound: block.chest.open
  sound.pitch: "2F"
  sound.volume: "3F"
  sound.source: master

Hologramm-Platzhalter

placeholderGroupName referenziert die Gruppe, die für Hologramm-Platzhalter verwendet wird. Beispiele:

Gruppenplatzhalter: <group_name>
Gruppen-Spielerzahl: <group_player_count:available>

Introduction

Setup

Configuration

Plugins

Überblick

Unterstützte Software

Unterstützte NPC-Plugins

Schnellstart

Befehle

Berechtigungen

Interaktionen

Aktionen

Quick-Join-Optionen

Feedback-Optionen

NPC-Konfiguration

Hologramm-Platzhalter

​Überblick

​Unterstützte Software

​Unterstützte NPC-Plugins

​Schnellstart

​Befehle

​Berechtigungen

​Interaktionen

​Aktionen

​Quick-Join-Optionen

​Feedback-Optionen

​NPC-Konfiguration

​Hologramm-Platzhalter

Überblick

Unterstützte Software

Unterstützte NPC-Plugins

Schnellstart

Befehle

Berechtigungen

Interaktionen

Aktionen

Quick-Join-Optionen

Feedback-Optionen

NPC-Konfiguration

Hologramm-Platzhalter