Das Plugin

Für welche Server

Installieren

1. Im Portal die Plattform wählen und herunterladen. Hostname und Geheimnis sind schon im Jar – nichts einzutragen.
2. In den Ordner plugins (Fabric: mods) legen.
3. Server neu starten. Nach etwa einer Minute meldet sich das Plugin im Portal.

Was es tut

• Prüft bei jeder Verbindung eine Signatur des CDN und setzt die echte IP des Spielers – Banns, Logs und Plugins wie LuckPerms sehen die richtige Adresse.
• Lehnt Verbindungen ab, die nicht über das CDN kommen („Bitte verbinde dich über play.ihre-domain.de“), und nimmt nur Verbindungen von den Edges an – wie eine Firewall, ohne dass Sie eine einrichten.
• Meldet jede Minute Spieler, TPS, Version und Lag-Gründe ans Portal; überträgt IP-Banns und Whitelist an die Edges (Paper, Fabric).
• Aktualisiert sich selbst – nur signierte Versionen, aktiv nach dem Neustart.

Befehle im Spiel

/khcdn status                       Zustand des Schutzes
/khcdn stats                        Verbindungen und Abgewiesene (24 h)
/khcdn edges                        Spieler je Edge
/khcdn spieler <Name>               über welchen Edge, Ping, bester Edge
/khcdn wechseln <Spieler> [Edge]    zum besten (oder einem bestimmten) Edge
/khcdn block <Spieler|IP> [Grund]   auf allen Edges sperren
/khcdn unblock <IP>                 Sperre aufheben
/khcdn wartung an [Text] | aus      Wartungsmodus

Auf Servern bis 1.20.4 gibt es keinen Wechsel zum besten Edge (das kann Minecraft erst ab 1.20.5). Die Mods für Forge, Fabric und NeoForge bis 1.20.x haben keine Befehle – Sperren, Wartung und Statistik gehen dort im Kundenportal.

Einstellungen in kernhosting-cdn.properties

only-cdn=true

Nur Verbindungen über das CDN.

only-edges=true

Nur Verbindungen von den Adressen der Edges.

allow-local=true

Lokale Abfragen bleiben erlaubt (z. B. Status im Hosting-Panel).

auto-update=true

Selbst-Update.

report=true

Meldungen ans Portal.

kick-message=…

Eigener Text für abgewiesene Verbindungen.

best-edge=true

Spieler beim Beitreten zum schnellsten Edge schicken (ab 1.5).

Immer der schnellste Edge

Welchen Edge ein Spieler bekommt, entscheidet zuerst das DNS – nach dem Standort seines DNS-Servers. Der liegt nicht immer in der Nähe des Spielers. Ab Plugin 1.5 prüft das Kundenportal beim Beitreten, welcher Edge für diesen Spieler am schnellsten ist: Entfernung zum Spieler plus die gemessene Antwortzeit vom Edge zu Ihrem Server.

Ist ein anderer Edge spürbar schneller (ab etwa 8 ms), schickt das Plugin den Spieler einmal dorthin – mit dem Transfer von Minecraft 1.20.5+. Der Spieler sieht kurz „Verbinde…“, dann ist er wieder da. Ältere Clients und Bedrock-Spieler (Geyser) bleiben, wo sie sind. Einen Eintrag accepts-transfers brauchen Sie nicht. Abschalten: best-edge=false.

Mit /khcdn spieler <Name> sehen Sie, über welchen Edge jemand spielt und welcher der beste wäre; /khcdn wechseln schickt ihn sofort hin.

Neues Geheimnis

Unter Einstellungen → „Neues Geheimnis“ wird das bisherige Plugin sofort ungültig – etwa, wenn jemand Fremdes die Jar-Datei hatte. Danach das Plugin neu herunterladen und tauschen.