ServerRoamAnmeldenEintragenServer eintragen

Votifier einrichten

ServerRoam reicht jeden Vote mit Spielernamen an den Votifier deines Servers weiter, damit ein Vote-Listener-Plugin deine Belohnung ausführen kann. So richtest du das ein.

Was du brauchst

Einen Minecraft-Server, der hier gelistet ist, einen Votifier, der Verbindungen aus dem Internet annimmt (empfohlen ist NuVotifier, das beide Protokolle kann), und ein Plugin, das Spieler für Votes belohnt. Votifier selbst empfängt nur den Vote; die Belohnung übernimmt das Plugin, mit dem du es kombinierst.

Ist dein Server noch nicht gelistet, trag ihn zuerst ein. Für Serverbetreiber zeigt den ganzen Weg vom Eintrag bis zum Badge.

1. Server beanspruchen

Öffne die Seite deines Servers und wähl Diesen Server beanspruchen, dann Code holen. Du bekommst einen kurzen Code wie serverroam-4f9k2x.

Setz den Code irgendwo ins MOTD (motd in der server.properties) und starte den Server neu oder lade ihn neu. Minecraft-Server werden alle 5 Minuten geprüft. Sobald der Code auftaucht, aktualisiert sich die Seite von selbst und dein Eintrag ist verifiziert. Entfern den Code danach wieder aus dem MOTD.

server.properties
motd=Example SMP serverroam-4f9k2x

Der Anspruch ist an den Browser gebunden, in dem du ihn gestartet hast. Verlierst du den Zugang, beanspruch den Server erneut: Der neue Anspruch ersetzt den alten samt seinen Belohnungseinstellungen.

2. Votifier-Ziel hinzufügen

Such auf der Verwaltungsseite (/minecraft/<slug>/manage, erreichbar über denselben Link Diesen Server beanspruchen auf der Seite deines Servers) Vote-Belohnungen, dann Votifier, und füll drei Felder aus:

Votifier-Host: der Hostname oder die IPv4-Adresse, unter der dein Votifier erreichbar ist, ohne Port. Vorbelegt ist die Adresse deines Servers. Er muss auf eine öffentliche IPv4-Adresse auflösen; reine IPv6-Hosts und private Netze werden abgelehnt.

Port: der TCP-Port deines Votifier, 8192, falls du ihn nicht geändert hast. Ports von 1024 bis 65535 werden akzeptiert.

Token oder öffentlicher Schlüssel: füg eines von beiden ein, die Art wird von selbst erkannt. Speichern.

Ein gespeichertes Secret wird verschlüsselt abgelegt und nie wieder angezeigt. Lass das Feld bei späteren Speichervorgängen leer, um es zu behalten, oder füg ein neues ein, um es zu ersetzen. Ausschalten entfernt das Ziel.

Token oder öffentlicher Schlüssel

Ein Token nutzt Protokoll 2 von NuVotifier: Der Vote wird mit dem Token signiert und dein Server bestätigt ihn, du siehst also, ob er angekommen ist. Kopier ihn aus der Votifier-Konfiguration unter tokens, meist plugins/Votifier/config.yml.

config.yml
host: 0.0.0.0
port: 8192

tokens:
  default: <your token>

Ein öffentlicher Schlüssel nutzt Protokoll 1, das klassisches Votifier und NuVotifier beide annehmen. Füg den Inhalt der Datei unten ein, einen 2048-Bit-RSA-Schlüssel, mit oder ohne BEGIN- und END-Zeilen. Protokoll 1 antwortet nicht, ein Vote kann also nur als gesendet gemeldet werden, nicht als zugestellt. Nimm einen Token, wenn dein Votifier ihn unterstützt.

Öffentlicher Schlüssel
plugins/Votifier/rsa/public.key

Votifier muss auf dem eingegebenen Host und Port lauschen, und sein Port muss aus dem Internet erreichbar sein (Firewall, Hosting-Panel). Wir verbinden uns nur mit einer öffentlichen IPv4-Adresse und senden nichts, bevor sich dein Server als Votifier gemeldet hat.

3. Test-Vote senden

Ist das Ziel gespeichert, gib neben Test-Vote senden einen Spielernamen ein und sende ihn. Das Ergebnis der letzten Zustellung steht unter dem Button:

Zugestellt: Dein Votifier hat den Vote bestätigt (nur mit Token). Gesendet: Der Vote wurde gesendet, Protokoll 1 bestätigt nicht. Keine Verbindung: Prüf Host, Port und Firewall. Kein Votifier: Dieser Port hat nicht als Votifier geantwortet. Abgelehnt: Token oder öffentlicher Schlüssel stimmen nicht. Keine Bestätigung: Votifier hat nicht geantwortet, sieh in die Konsole deines Servers.

Ein Test-Vote nimmt denselben Weg wie ein echter, dein Vote-Listener führt also die Belohnung für diesen Namen aus: Nimm deinen eigenen. Er zählt nicht als Vote im Eintrag, wird nur einmal versucht und du kannst alle 20 Sekunden einen senden.

Was dein Server empfängt

Ein normaler Votifier-Vote: serviceName ist ServerRoam, username ist der Spielername genau wie eingegeben, address ist der eigene Host von ServerRoam (nie die IP-Adresse des Voters) und timestamp ist der Zeitpunkt des Votes.

Namen sind Java-Namen (2 bis 16 Buchstaben, Ziffern oder Unterstriche), optional mit einem vorangestellten . oder * für Bedrock-Spieler, die über Geyser beitreten. Ein Voter, der den Namen leer lässt, zählt trotzdem als Vote, löst aber keine Belohnung aus.

Grenzen und Garantien

Jeder Spielername bekommt eine Belohnung pro Server und UTC-Tag. Ein zweiter Vote mit demselben Namen an dem Tag wird beim Abstimmen abgelehnt, dein Server sieht ihn also nie.

Ein Vote wird höchstens einmal zugestellt. Kam überhaupt keine Verbindung zu deinem Votifier zustande, wird es nach einer Minute und zehn Minuten später noch einmal versucht. Darüber hinaus wird nie wiederholt, auch nicht bei einem Vote, den dein Votifier erhalten, aber nicht bestätigt hat, weil er schon belohnt worden sein kann. Ein Server, der länger offline bleibt, verpasst die Votes dazwischen.

Nimm einen Webhook, wenn du ein eigenes Setup betreibst oder auf deiner Seite Duplikate verwerfen willst.