MCTOOLBOX
MC ToolboxMC TOOLBOX

Server e file

Generatore di Configurazione BungeeCord

config.yml iniziale allineato con la Guida alla Configurazione BungeeCord di SpigotMC: listeners, servers, online_mode, ip_forward, permissions e forced hosts. Rivedere prima della produzione.

Listener

Impostazioni globali

Con ip_forward true, imposta ogni backend Spigot/Paper online-mode=false e abilita la modalità BungeeCord nella configurazione del backend. Vedi wiki Spigot: BungeeCord Configuration Guide e IP Forwarding.

Server backend

config.yml generato

# BungeeCord config.yml starter - based on SpigotMC BungeeCord Configuration Guide
# Backend Spigot/Paper servers should use online-mode=false when ip_forward is true.
# Also set bungeecord: true (Paper: settings.bungeecord / spigot.yml paper settings).
server_connect_timeout: 5000
remote_ping_cache: -1
forge_support: false
player_limit: -1
permissions:
  default:
  - bungeecord.command.server
  - bungeecord.command.list
  admin:
  - bungeecord.command.alert
  - bungeecord.command.end
  - bungeecord.command.ip
  - bungeecord.command.reload
timeout: 30000
log_commands: false
network_compression_threshold: 256
online_mode: true
disabled_commands: []
servers:
  lobby:
    motd: '&1Just another BungeeCord - Forced Host'
    address: 'localhost:25566'
    restricted: false
listeners:
- query_port: 25577
  motd: '&1A BungeeCord Server'
  tab_list: GLOBAL_PING
  query_enabled: false
  proxy_protocol: false
  forced_hosts:
    pvp.example.com: pvp
  ping_passthrough: false
  priorities:
    - lobby
  bind_local_address: true
  host: '0.0.0.0:25577'
  max_players: 1
  tab_size: 60
  force_default_server: false
ip_forward: true
remote_ping_timeout: 5000
prevent_proxy_connections: false
groups: {}
connection_throttle: 4000
stats: 00000000-0000-4000-8000-000000000000
connection_throttle_limit: 3
log_pings: true

Come Usare il Generatore di Config BungeeCord

Questo strumento crea un file config.yml iniziale per il tuo server proxy BungeeCord. Inizia inserendo l'IP pubblico o il dominio del tuo server nel campo 'Bind Address', oppure lascialo come 0.0.0.0 per ascoltare su tutte le interfacce. Imposta la 'Server Port' su 25565 (la porta predefinita di Minecraft) a meno che tu non abbia un motivo specifico per cambiarla. Il generatore produrrà una config pulita e commentata che puoi scaricare e inserire nella tua cartella BungeeCord.

Il toggle 'Online Mode' è fondamentale. Se i tuoi server backend (come Spigot o Paper) sono in modalità online, mantienilo su true. Se stai eseguendo un server cracked o offline, impostalo su false. Per reti con più server backend, abilita 'IP Forwarding' e imposta 'BungeeCord' su true nel config.yml di ogni server backend. Questo garantisce che gli IP e gli UUID dei giocatori vengano passati correttamente. Il generatore include l'impostazione necessaria 'ip_forward' nella sezione listener.

Usa la sezione 'Servers' per definire i tuoi server backend. Per ogni server, inserisci un nome (come 'lobby' o 'survival'), l'indirizzo (es. 'localhost:25566') e opzionalmente impostalo come MOTD o ristretto. Il generatore creerà una mappa 'servers' con le tue voci. Ricorda che il primo server elencato sotto 'listeners' -> 'forced_hosts' sarà il server di fallback predefinito. Puoi anche impostare 'priorities' per controllare a quale server i giocatori si uniscono per primi.

La funzione 'Forced Hosts' ti consente di instradare i giocatori verso server diversi in base al nome host che usano per connettersi. Ad esempio, puoi forzare 'play.example.com' ad andare al server 'lobby' e 'build.example.com' a 'creative'. Nel generatore, aggiungi questi nomi host e seleziona il server di destinazione. Questo è utile per reti con più sottodomini. La config generata includerà una mappa 'forced_hosts' sotto ogni listener.

Le differenze di versione contano. BungeeCord (ora Waterfall o Velocity) si è evoluto, ma la struttura di base del config.yml rimane simile. Questo generatore produce una config compatibile con BungeeCord 1.8-1.20+. Se usi Waterfall, la config è quasi identica. Per Velocity, avrai bisogno di un formato di config diverso, quindi questo strumento non è adatto. Testa sempre la config generata in un ambiente di staging prima della produzione. Scarica il file, sostituisci il tuo config.yml esistente e riavvia il proxy.

Domande Comuni

Qual è la differenza tra BungeeCord e Waterfall?

BungeeCord è il software proxy originale di md_5. Waterfall è un fork di BungeeCord con miglioramenti delle prestazioni e patch di sicurezza migliori. Entrambi usano lo stesso formato config.yml, quindi il file generato funziona con entrambi. Tuttavia, Waterfall è consigliato per i server moderni grazie alla sua manutenzione attiva e alla compatibilità con le versioni più recenti di Minecraft.

Come configuro correttamente l'IP forwarding?

Nella config generata, imposta 'ip_forward: true' sotto il listener. Poi, su ogni server backend (Spigot/Paper), apri il loro config.yml e imposta 'bungeecord: true' (o 'settings.velocity' per Velocity). Inoltre, assicurati che 'online-mode' sia impostato su false sui server backend, perché il proxy gestisce l'autenticazione. Se usi Paper, potresti dover impostare 'settings.velocity' con una chiave segreta se usi Velocity, ma per BungeeCord basta impostare 'bungeecord: true'.

Posso usare questo generatore per un singolo server?

Sì, puoi. Se hai un solo server backend, imposta la sezione 'Servers' con una singola voce, ad esempio 'lobby' con indirizzo 'localhost:25566'. Poi imposta le 'priorities' del listener su quel server. Il proxy inoltrerà tutti i giocatori a quel singolo server. Questo è utile se vuoi aggiungere più server in seguito senza cambiare l'indirizzo visibile ai giocatori.

Cosa fa 'forced_hosts' e come lo uso?

Gli host forzati ti consentono di instradare i giocatori verso server diversi in base al nome host che usano per connettersi. Ad esempio, se hai due domini, 'play.example.com' e 'build.example.com', puoi forzare 'play.example.com' al server 'lobby' e 'build.example.com' al server 'creative'. Nel generatore, aggiungi questi nomi host e seleziona il server di destinazione. La config generata includerà una mappa 'forced_hosts' sotto ogni listener.

Perché il mio MOTD non viene visualizzato?

Il MOTD è impostato nella sezione 'listeners' sotto 'motd'. Assicurati di averlo inserito nel generatore. Inoltre, verifica che il ping della lista server sia abilitato (l'opzione 'ping' nel listener). Se stai usando un MOTD personalizzato con codici colore, usa il simbolo di sezione (§) o la e commerciale (&) con un codice colore, ma nota che il generatore potrebbe non escaparli. Testa il MOTD facendo ping al server dal client Minecraft.