BungeeCord - klasyczny proxy sieciowy Minecraft

Co to jest BungeeCord

BungeeCord to darmowy proxy sieciowy stworzony przez md_5, twórcę Spigot. Powstał w 2012 roku i szybko stał się standardem branżowym. Największe sieci serwerów Minecraft (Hypixel na początku, Mineplex, CubeCraft) zbudowały swoją infrastrukturę właśnie na BungeeCord.

Proxy działa jako pośrednik między graczem a serwerami backendowymi. Gracz łączy się z jednym adresem IP, a BungeeCord kieruje go na odpowiedni serwer - lobby, survival, minigry czy SkyBlock. Przechodzenie między serwerami odbywa się komendą /server lub przez NPC/portale skonfigurowane pluginami.

BungeeCord pobierzesz z oficjalnego CI md_5. Kod źródłowy jest na GitHub SpigotMC.

Jak działa sieć BungeeCord

Architektura sieci BungeeCord składa się z trzech warstw:

• Proxy (BungeeCord) - punkt wejścia, obsługuje połączenia graczy, autoryzację i routing
• Serwery backendowe - instancje Spigot/Paper z trybami gry (lobby, survival, minigry)
• Baza danych - MySQL/Redis do synchronizacji danych między serwerami (opcjonalnie)

Gdy gracz dołącza do sieci, BungeeCord łączy go z domyślnym serwerem (zazwyczaj lobby). Stamtąd gracz przechodzi na inne serwery. BungeeCord utrzymuje połączenie z graczem i przekazuje pakiety do aktualnego serwera backendowego. Z perspektywy gracza wygląda to jak teleportacja - nie musi się rozłączać i łączyć ponownie.

Konfiguracja

Po pierwszym uruchomieniu BungeeCord tworzy plik config.yml. Kluczowe sekcje:

# Adres proxy
host: 0.0.0.0:25565

# Przekazywanie IP graczy do serwerów backendowych
ip_forward: true

# Lista serwerów
servers:
  lobby:
    motd: "Lobby"
    address: 127.0.0.1:25566
    restricted: false
  survival:
    motd: "Survival"
    address: 127.0.0.1:25567
    restricted: false

# Priorytety połączeń
listeners:
  - priorities:
      - lobby
      - survival
    max_players: 500
    tab_list: GLOBAL_PING

Na każdym serwerze backendowym (Spigot/Paper) musisz ustawić w spigot.yml:

settings:
  bungeecord: true

Bez tego serwery nie będą poprawnie rozpoznawać UUID i skinów graczy przekazywanych przez BungeeCord.

Bezpieczeństwo

BungeeCord ma poważne ograniczenie bezpieczeństwa: protokół IP forwarding nie jest kryptograficznie podpisany. Oznacza to, że jeśli atakujący połączy się bezpośrednio z serwerem backendowym (omijając proxy), może podszywać się pod dowolnego gracza, w tym admina.

Aby zabezpieczyć sieć BungeeCord:

• Firewall jest obowiązkowy - zablokuj porty serwerów backendowych (25566, 25567 itd.) dla zewnętrznych IP. Tylko proxy powinno mieć do nich dostęp
• Ustaw online-mode: true na proxy - BungeeCord weryfikuje konta Mojang, serwery backendowe ustawione na online-mode: false ufają proxy
• Rozważ migrację na Velocity - Velocity oferuje modern forwarding z podpisem HMAC, co eliminuje ten problem

Popularne pluginy

BungeeCord ma ogromny ekosystem pluginów. Najpopularniejsze dla sieci serwerów:

• LuckPerms - uprawnienia synchronizowane przez bazę danych między serwerami
• ViaVersion - obsługa wielu wersji klientów na jednym proxy
• PremiumVanish - ukrywanie admina na całej sieci
• SkinsRestorer - zarządzanie skinami na proxy
• Tebex (Buycraft) - sklep z donacjami zintegrowany z siecią
• FastLogin - automatyczne logowanie graczy premium

Pluginy BungeeCord instalujesz w folderze plugins/ w katalogu proxy. Pluginy Spigot/Paper nie działają na BungeeCord i odwrotnie - to dwa osobne ekosystemy.

Waterfall - fork BungeeCord

Waterfall był forkiem BungeeCord stworzonym przez zespół PaperMC, dodającym poprawki wydajności i kompatybilności. Jednak od 2023 roku Waterfall nie jest już aktywnie rozwijany - zespół PaperMC rekomenduje migrację na Velocity.

Dla nowych sieci serwerów jednoznacznie zalecamy Velocity. BungeeCord nadal działa dobrze na istniejących sieciach, ale nie oferuje nowoczesnych zabezpieczeń. Jeśli planujesz budowę nowej sieci, zacznij od Velocity - zaoszczędzisz sobie późniejszej migracji.

Powiązane poradniki: Velocity (nowoczesna alternatywa), jak stworzyć serwer, LuckPerms na proxy.