MCTOOLBOX
MC ToolboxMC TOOLBOX

服务器与文件

BungeeCord Config 生成器

与 SpigotMC BungeeCord 配置指南一致的入门 config.yml：listeners、servers、online_mode、ip_forward、permissions 和 forced hosts。生产前请审查。

Listener

全局设置

使用 ip_forward true，将每个后端 Spigot/Paper 的 online-mode 设置为 false，并在后端配置中启用 BungeeCord 模式。请参阅 Spigot wiki：BungeeCord 配置指南和 IP 转发。

后端服务器

生成的 config.yml

# 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

如何使用BungeeCord配置生成器

此工具为您的代理服务器创建一个入门BungeeCord config.yml文件。首先，在“绑定地址”字段中输入您服务器的公共IP或域名，或将其保留为0.0.0.0以监听所有接口。将“服务器端口”设置为25565（Minecraft默认端口），除非您有特定原因要更改它。生成器将生成一个干净、带注释的配置，您可以下载并放入BungeeCord文件夹中。

“在线模式”开关至关重要。如果您的后端服务器（如Spigot或Paper）处于在线模式，请保持此选项为true。如果您运行的是破解版或离线服务器，请将其设置为false。对于具有多个后端服务器的网络，请启用“IP转发”，并在每个后端服务器的config.yml中将“BungeeCord”设置为true。这确保玩家IP和UUID被正确传递。生成器在监听器部分包含了必要的“ip_forward”设置。

使用“服务器”部分定义您的后端服务器。对于每个服务器，输入名称（如“lobby”或“survival”）、地址（例如“localhost:25566”），并可选择将其设置为MOTD或受限。生成器将使用您的条目创建一个“servers”映射。请记住，“listeners”->“forced_hosts”下列出的第一个服务器将是默认后备服务器。您还可以设置“priorities”来控制玩家首先加入哪个服务器。

“强制主机”功能允许您根据玩家连接时使用的主机名将玩家路由到不同的服务器。例如，您可以将“play.example.com”强制到“lobby”服务器，将“build.example.com”强制到“creative”。在生成器中，添加这些主机名并选择目标服务器。这对于具有多个子域的网络非常有用。生成的配置将在每个监听器下包含一个“forced_hosts”映射。

版本差异很重要。BungeeCord（现在是Waterfall或Velocity）已经发展，但核心config.yml结构仍然相似。此生成器输出与BungeeCord 1.8-1.20+兼容的配置。如果您使用Waterfall，配置几乎相同。对于Velocity，您需要不同的配置格式，因此此工具不适用。始终在暂存环境中测试生成的配置，然后再用于生产。下载文件，替换现有的config.yml，然后重新启动代理。

常见问题

BungeeCord和Waterfall有什么区别？

BungeeCord是md_5的原始代理软件。Waterfall是BungeeCord的一个分支，具有性能改进和更好的安全补丁。两者使用相同的config.yml格式，因此生成的文件适用于两者。但是，对于现代服务器，建议使用Waterfall，因为它积极维护并兼容更新的Minecraft版本。

如何正确设置IP转发？

在生成的配置中，在监听器下设置“ip_forward: true”。然后，在每个后端服务器（Spigot/Paper）上，打开它们的config.yml并设置“bungeecord: true”（对于Velocity，设置“settings.velocity”）。此外，确保后端服务器上的“online-mode”设置为false，因为代理处理身份验证。如果您使用Paper，如果您使用Velocity，可能需要设置“settings.velocity”并带有密钥，但对于BungeeCord，只需设置“bungeecord: true”。

我可以将此生成器用于单个服务器吗？

是的，可以。如果您只有一个后端服务器，请在“服务器”部分设置一个条目，例如“lobby”，地址为“localhost:25566”。然后将监听器的“priorities”设置为该服务器。代理将把所有玩家转发到该服务器。如果您想稍后添加更多服务器而不更改面向玩家的地址，这很有用。

“forced_hosts”是做什么的，如何使用？

强制主机允许您根据玩家连接时使用的主机名将玩家路由到不同的服务器。例如，如果您有两个域，“play.example.com”和“build.example.com”，您可以将“play.example.com”强制到“lobby”服务器，将“build.example.com”强制到“creative”服务器。在生成器中，添加这些主机名并选择目标服务器。生成的配置将在每个监听器下包含一个“forced_hosts”映射。

为什么我的MOTD不显示？

MOTD在“listeners”部分的“motd”下设置。确保您已在生成器中输入它。此外，确保您的服务器列表ping已启用（监听器中的“ping”选项）。如果您使用带有颜色代码的自定义MOTD，请使用分节符（§）或与号（&）加颜色代码，但请注意生成器可能不会转义它们。通过从Minecraft客户端ping服务器来测试MOTD。