Minecraft-Server mit KiroCloud verknüpfen

Die Verbindung zwischen deinem Minecraft-Server, KiroCloud und deinem Discord-Server ermöglicht eine nahtlose Community-Verwaltung. Mit KiroCloud synchronisierst du Spielerränge automatisch mit Discord-Rollen, verwaltest Whitelists, führst In-Game-Verifikationen durch und sendest RCON-Befehle direkt über das Web-Dashboard.

1. RCON-Einrichtung auf dem Minecraft-Server

RCON (Remote Console) ist das Standard-Protokoll, mit dem KiroCloud Befehle an deinen Minecraft-Server übermittelt (z. B. für Verifizierungscodes, Rang-Updates oder Whitelisting).

Schritt 1: server.properties anpassen

Öffne die Datei server.properties im Hauptverzeichnis deines Minecraft-Servers und setze folgende Werte:

enable-rcon=true
rcon.port=25575
rcon.password=DEIN_SICHERES_RCON_PASSWORT
broadcast-rcon-to-ops=false

!WARNING Verwende ein langes, zufällig generiertes Passwort für rcon.password. Der RCON-Port (25575) muss in deiner Firewall bzw. deinem Router (Port-Forwarding) für TCP-Verbindungen freigegeben sein.

Schritt 2: Server in KiroCloud eintragen

1. Navigiere im KiroCloud Dashboard zu Minecraft > Serververwaltung (oder /admin/minecraft).
2. Klicke auf "Server hinzufügen".
3. Gib folgende Verbindungsdaten ein:
   • Server-Name: z. B. CityBuild-01
   • Host / IP: Die öffentliche IP-Adresse oder Domain deines Minecraft-Servers.
   • RCON-Port: Der in server.properties definierte Port (Standard: 25575).
   • RCON-Passwort: Das vergebene Passwort.
   • Server-Typ: Wähle Hauptserver (Main) für den primären Verifikations-Server.
4. Klicke auf "Verbindung testen" und anschließend auf "Speichern".

2. KiroConnector Plugin & API-Token

Für erweiterte Funktionen wie Live-Chat-Bridge, TPS-Telemetrie und Spieler-Inventar-Abfragen installierst du unser leichtgewichtiges Connector-Plugin.

1. Lade die aktuelle Version von KiroConnector.jar im KiroCloud Dashboard herunter.
2. Lege die Datei in den /plugins/-Ordner deines Spigot-, Paper- oder Purpur-Servers.
3. Starte den Server neu, damit die Konfigurationsdatei generiert wird.
4. Öffne plugins/KiroConnector/config.yml und trage deinen Server-Token ein:

server-token: "kiro_srv_dein_geheimer_token"
sync-interval-seconds: 15
debug: false

3. Account-Verifikation (Discord <-> Minecraft)

KiroCloud bietet einen sicheren und benutzerfreundlichen Verifikationsprozess, um Discord-Accounts mit Minecraft-Spielernamen zu verknüpfen.

Der Verifikationsablauf:

1. Ablauf starten: Ein Spieler klickt im Discord auf den Button "Minecraft-Account verknüpfen" oder nutzt den Slash-Command /verify minecraft <username>.
2. Namen eingeben: Ein Modal öffnet sich, in dem der Spieler seinen Minecraft-Namen (z. B. Steve) eingibt.
3. Code via RCON senden: KiroCloud generiert einen zufälligen 6-stelligen Zahlencode (10 Minuten gültig) und sendet ihn per In-Game-Nachricht (tellraw) direkt an den Spieler:

   ["",{"text":"[KiroCloud] ","color":"gold","bold":true},{"text":"Dein Verifizierungscode ist: ","color":"gray"},{"text":"482910","color":"green","bold":true}]
   

4. Code eingeben: Der Spieler klickt im Discord auf "Code eingeben", trägt die 6 Ziffern ein und bestätigt.
5. Erfolgreiche Verknüpfung: Der Account wird in der Datenbank verknüpft, das Profilbild wird mit dem Minecraft-Skin aktualisiert und die konfigurierten Discord-Rollen werden vergeben.

!NOTE Der Spieler muss sich während der Verifikation auf dem Server befinden, um den In-Game-Code empfangen zu können.

4. Rang- & Rollen-Synchronisation

Mit der Rang-Synchronisation spiegelst du Discord-Rollen und Minecraft-Rechtegruppen (z. B. via LuckPerms) automatisch wider:

• Discord zu Minecraft (In-Game Ränge): Wenn ein Nutzer auf Discord eine bestimmte Rolle erhält (z. B. @VIP oder @Supporter), führt KiroCloud via RCON automatisch den Befehl lp user <player> parent add vip aus.
• Minecraft zu Discord: In-Game gekaufte oder vergebene Ränge können umgekehrt entsprechende Discord-Rollen zuweisen.
• Booster-Belohnungen: Discord-Server-Booster erhalten automatisch In-Game-Vorteile (z. B. Kosmetika, Geld oder temporäre VIP-Ränge).
• Nickname-Synchronisation: Der Discord-Server-Nickname des Nutzers kann automatisch auf seinen Minecraft-Namen gesetzt werden.

5. Whitelist-Verwaltung & Zugangskontrolle

Schütze deinen Server vor Fremdzugriffen durch automatisiertes Whitelisting:

• Discord-Only Modus: Nur Mitglieder deines Discord-Servers, die ihren Account erfolgreich verifiziert haben, werden automatisch per whitelist add <player> auf die Server-Whitelist gesetzt.
• Auto-Revoke bei Server-Austritt: Verlässt ein Mitglied deinen Discord-Server oder wird gesperrt, entfernt KiroCloud den Spieler sofort von der Whitelist und führt bei Bedarf einen In-Game-Kick durch.

6. Fehlerbehebung & Troubleshooting