tapscrollWIKI

Installation

Account anlegen, Server hinzufügen, API-Key einfügen — nach einer Minute sammelst du Metriken.

PulseNode v5.0.2Paper · Spigot1.21 – 1.21.x

  1. Account anlegen

    Registriere dich auf pulsenode.tech mit Discord, Google oder Apple.

    Rechnungsdaten (Name, Adresse, E-Mail) werden abgefragt, weil Rechnungen in Deutschland gesetzlich vorgeschrieben sind — der kostenlose Tarif fragt sie ebenfalls ab, damit ein Upgrade dich später nicht unterbricht.

  2. Server hinzufügen

    Im Dashboard: Server → Server hinzufügen. Gib ihm einen Namen, den du in einem Report wiedererkennst (survival, lobby-1), und kopiere den erzeugten API-Key.

    Der Key identifiziert genau diesen einen Server. Verwende ihn nicht mehrfach — die Metriken würden sich vermischen und jedes Diagramm wäre bedeutungslos.

  3. Jar einspielen

    Lade PulseNode.jar aus dem Dashboard, lege sie in plugins/ und starte den Server einmal, damit die Config erzeugt wird.

    BASH
    scp PulseNode.jar user@server:/home/mc/server/plugins/

  4. Key eintragen

    plugins/PulseNode/config.yml
    api-url: "https://pulsenode.tech"api-key: "DEIN-API-KEY"interval: 30

    Danach neu laden:

    BASH
    /pn reload

  5. Prüfen, ob Daten ankommen

    BASH
    /pn status

    Zeigt den Verbindungszustand und die letzte erfolgreiche Übertragung. Innerhalb einer Minute sollte das Dashboard den ersten Datenpunkt anzeigen.

  6. Discord verbinden (optional)

    Lade den Bot aus dem Dashboard ein und wähle dann den Kanal, der Reports und Alerts bekommen soll. Details auf der Seite Discord.

Spark ebenfalls installieren

Nicht erforderlich, aber dringend empfohlen:

TEXT
https://spark.lucko.me

Ohne Spark sind die CPU-Werte pro Plugin Schätzungen. Mit Spark sind es Messungen — und „welches Plugin frisst deinen Tick" ist das Nützlichste, was ein Report dir sagen kann.

YAML
track-plugins: true

Voraussetzungen

ServersoftwarePaper 1.21+ (Spigot funktioniert, mit weniger Metriken)
Java21
NetzwerkAusgehendes HTTPS zu pulsenode.tech
EmpfohlenSpark, für genaue CPU-Werte pro Plugin

Firewalls

Das Plugin stellt ausschließlich ausgehende HTTPS-Anfragen. Es öffnet keine Ports und nimmt keine eingehenden Verbindungen an. Blockiert dein Hoster ausgehenden Verkehr standardmäßig, gib pulsenode.tech auf Port 443 frei.

Mehrere Server

Füge jeden Server einzeln im Dashboard hinzu und gib jedem seinen eigenen API-Key.

YAML
# lobby/plugins/PulseNode/config.ymlapi-key: "key-fuer-lobby" # survival/plugins/PulseNode/config.ymlapi-key: "key-fuer-survival"

Der kostenlose Tarif deckt einen Server ab, Pro fünf und Business fünfzehn.

Plugin-Update

Server stoppen, Jar ersetzen, starten. Deine config.yml wird nicht überschrieben — neue Optionen greifen auf ihre Standardwerte zurück, bis du sie einträgst. Das Dashboard zeigt ein Abzeichen, wenn eine neuere Plugin-Version verfügbar ist als die, die gerade meldet.

Den Key nicht mitveröffentlichen

Der API-Key autorisiert Schreibzugriffe für diesen Server. Behandle config.yml wie jede andere Datei mit einer Zugangsberechtigung — wenn du dein Serverpaket veröffentlichst oder eine Config für Support teilst, schwärze ihn.