BungeeCord : proxy Minecraft

BungeeCord est un proxy Minecraft qui permet de regrouper plusieurs serveurs (lobby, survival, etc.) sous une seule adresse et de router les joueurs. Ce guide décrit l’installation, la config.yml (listeners, servers), la configuration des backends (online_mode=false, IP forward) et le démarrage. Pour une alternative plus récente et performante : velocity-mc.

Prérequis

• Java 8+ (17 recommandé)
• Accès aux fichiers du proxy et des serveurs backend (panel ou SSH)
• Au moins 2 serveurs : BungeeCord (entrée) et un ou plusieurs backends

BungeeCord vs Velocity

• BungeeCord : ancien, très répandu, online_mode=false obligatoire sur les backends.
• Velocity : plus performant, modern forwarding avec online-mode=true sur les backends, support 1.7–1.21+. Voir velocity-mc.

Installation

1. Télécharger BungeeCord depuis ci.md-5.net/job/BungeeCord (ou spigotmc.org) : le JAR du dernier build.
2. Créer un dossier dédié, y placer BungeeCord.jar.
3. Premier lancement :
   java -Xms512M -Xmx512M -jar BungeeCord.jar
   Cela génère config.yml et eula si nécessaire. Arrêter le proxy, éditer config.yml.

config.yml

listeners

Un listener définit l’adresse et le port d’écoute, le MOTD et les serveurs par défaut / de fallback :

listeners:
  - host: 0.0.0.0:25565
    motd: 'Mon réseau'
    max_players: 100
    tab_list: GLOBAL_PING
    force_default_server: false
    default_server: lobby
    fallback_server: lobby
    priorities:
      - lobby
      - survival

• host : 0.0.0.0:25565 pour écouter sur toutes les IP, port 25565.
• default_server / fallback_server : noms dans la section servers.
• priorities : ordre de choix du serveur (selon les plugins ou la logique de BungeeCord).

servers

Liste des backends (adresse:port) :

servers:
  lobby:
    address: 127.0.0.1:25566
    restricted: false
  survival:
    address: 127.0.0.1:25567
    restricted: false

• address : IP et port du serveur Minecraft (Spigot, Paper, etc.). En local : 127.0.0.1:25566.
• restricted : si true, seuls les joueurs avec permission peuvent y accéder (selon les plugins).

ip_forward

Pour que les backends reçoivent la vraie IP des joueurs (et évitent les duplications de pseudo), BungeeCord envoie des infos (« IP forward »). Sur Spigot/Paper, il faut activer le support BungeeCord :

Dans spigot.yml :

settings:
  bungeecord: true

Et dans server.properties des backends :

online-mode=false

Attention : avec online-mode=false, les backends ne vérifient plus les comptes Mojang. Seul BungeeCord (en online-mode=true par défaut, côté proxy) assure l’auth. Ne pas exposer les ports des backends (25566, 25567) sur Internet.

Démarrage

Ordre :

1. Démarrer les backends (lobby, survival) avec online-mode=false et bungeecord: true.
2. Démarrer BungeeCord :
   java -Xms512M -Xmx512M -jar BungeeCord.jar

Port 25565 à ouvrir dans le pare-feu et chez l’hébergeur. Les ports des backends restent internes.

Dépannage

Bonnes pratiques

• Ne pas exposer les ports des backends.
• Utiliser Velocity et le modern forwarding si vous partez de zéro : velocity-mc.
• Pour les mods sur les backends : mods-minecraft ; pour ViaVersion : setup-viaversion.

Ressources

• BungeeCord – Wiki Spigot
• BungeeCord – GitHub

Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.