Velocity-Proxy für ein Minecraft-Netzwerk einrichten

Warum ein Minecraft-Servernetzwerk, und wie Velocity funktioniert

Mit einem Netzwerk betreibst du verschiedene Spielmodi nebeneinander unter einer Adresse, gibst jedem eigene Plugins und Ressourcen und startest einen Server neu, ohne alle anderen Spieler rauszuwerfen.

Spieler verbinden sich immer nur mit dem Proxy. Der Proxy meldet sie bei Mojang an und leitet sie dann an einen der Backend-Server weiter — normale Paper-Server, auf denen die Welten liegen. Tippt ein Spieler /server survival, verschiebt Velocity ihn ohne Verbindungsabbruch auf ein anderes Backend.

• Der Proxy ist schlank: Er hält keine Welt und braucht daher weit weniger Arbeitsspeicher als ein Spielserver.
• Die Backends laufen im Offline-Modus und verlassen sich darauf, dass der Proxy ihnen sagt, wer jeder Spieler ist. Genau dieses Vertrauen musst du absichern.
• Velocity 4, die aktuelle Version, braucht Java 25 und unterstützt Minecraft von 1.7.2 bis zur neuesten Version.

Velocity installieren

1. Lade Velocity von papermc.io in einen leeren Ordner herunter.
2. Starte es einmal mit Java 25:

java -Xms512M -Xmx512M -jar velocity.jar

Der erste Start erstellt velocity.toml und eine Datei forwarding.secret mit einem zufälligen Secret. Stoppe den Proxy mit end und öffne die Konfiguration.

velocity.toml konfigurieren

Die Einstellungen, auf die es bei einem ersten Netzwerk ankommt:

bind = "0.0.0.0:25565"
motd = "<#09add3>My Network"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "203.0.113.10:25566"
survival = "203.0.113.11:25567"
try = ["lobby"]

• bind — die Adresse und der Port, mit denen sich Spieler verbinden.
• player-info-forwarding-mode — setze ihn auf modern. Standard ist none, wodurch jeder Spieler eine Offline-UUID bekommt; legacy ist das alte BungeeCord-Format und lohnt sich nur für Server mit 1.12 und älter.
• [servers] — ein Name und eine Adresse für jedes Backend. Den Namen verwenden Spieler mit /server.
• try — wohin Spieler beim Login kommen und wohin sie geschickt werden, wenn ein Backend sie kickt.

Forced Hosts unter [forced-hosts] können Spieler anhand der eingegebenen Adresse an ein Backend schicken — zum Beispiel survival.yourserver.com direkt zu Survival.

Paper-Backends für Modern Forwarding einrichten

Nimm auf jedem Paper-Backend drei Änderungen vor und starte neu:

1. server.properties: online-mode=false — die Mojang-Anmeldung übernimmt jetzt der Proxy.
2. spigot.yml: settings.bungeecord: false.
3. config/paper-global.yml:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: 'paste the contents of forwarding.secret here'

online-mode muss hier mit velocity.toml übereinstimmen, und secret muss genau dem Text in der forwarding.secret des Proxys entsprechen. Modern Forwarding funktioniert ab Minecraft 1.13; Spigot-Server unterstützen es nicht, also nutze Paper oder einen Paper-Fork.

Andere Backends: Fabric-Server nutzen den Mod FabricProxy-Lite mit demselben Secret, und Forge-Server über 1.20.2 brauchen ProxyCompatibleForge. BungeeCord-Plugins laufen nicht auf Velocity.

Die Backends absichern

Ein Server im Offline-Modus akzeptiert jeden Spielernamen. Das ist nur sicher, wenn Spieler die Backends nicht am Proxy vorbei erreichen können.

• Modern Forwarding ist dein wichtigster Schutz. Ein Paper-Backend mit aktiviertem Velocity-Forwarding weist jeden ab, der sich direkt verbindet: Ohne die signierten Daten vom Proxy wird der Login mit This server requires you to connect with Velocity abgelehnt.
• Halte das Secret geheim. Wer forwarding.secret hat, kann sich als dein Proxy ausgeben. Veröffentliche es nie und ändere es überall, falls es nach außen gelangt.
• Schütze die Backends wo möglich mit einer Firewall. Die Velocity-Dokumentation sagt klar, dass Modern Forwarding keine Firewall ersetzt. Laufen Proxy und Backends auf derselben Maschine, binde jedes Backend an 127.0.0.1 und trage sie als 127.0.0.1:port ein.
• Betreibe nie ein Backend im Offline-Modus mit deaktiviertem Forwarding. Dann kann jeder als jeder beitreten, auch als Operator.

Ein Velocity-Netzwerk bei HytHost betreiben

Jeder Teil des Netzwerks ist ein eigener Server: einer für den Proxy und je einer pro Backend. Der Proxy braucht wenig Speicher, daher reicht ihm das kleinste Paket; die Backends dimensionierst du nach Welten und Spielern bei Minecraft-Hosting.

1. Mach einen Server zum Proxy. Wähle in seinem Version-Tab Velocity. Das Panel installiert es und setzt bind auf den eigenen Port des Servers. Prüfe, ob im Startup-Tab Java 25 ausgewählt ist.
2. Stelle Modern Forwarding selbst ein. Das Panel schreibt eine einfache velocity.toml mit leerer Serverliste. Setze im Dateimanager player-info-forwarding-mode = "modern" und trage deine Backends unter [servers] mit der Adresse und dem Port ein, die jedes in seinem Panel anzeigt.
3. Konfiguriere jedes Backend wie im Paper-Abschnitt oben, mit der forwarding.secret des Proxys.
4. Richte deine Domain auf den Proxy und gib Spielern nur diese Adresse.

Jedes Backend hat eine eigene öffentliche Adresse, deshalb hält Modern Forwarding direkte Verbindungen fern — lass kein Backend im Offline-Modus mit deaktiviertem Forwarding laufen. Für Rechte im ganzen Netzwerk betreibe LuckPerms auf jedem Server mit einer gemeinsamen MySQL-Datenbank; jedes Paket enthält Datenbanken.