
# --------------------------------
# Geyser 配置文件
#
# 这是一个在 Minecraft: Java 版与 Minecraft: 基岩版间的桥梁。
#
# GitHub 地址: https://github.com/GeyserMC/Geyser
# Discord 地址: https://discord.geysermc.org/
# --------------------------------
bedrock:
# 基岩版玩家连接时的配置信息
address: 0.0.0.0
# 设置监听的地址
# 使用 0.0.0.0 为不限制,任何地址均可连接。
port: 19132
# 设置监听玩家连接的端口
# 允许值: [1, 65535]
clone-remote-port: false
# 是否克隆远程端口
# 仅插件版 Geyser 服务端可用。
# 允许值:
# 是: true
# 否: false
motd1: "Geyser"
motd2: "Another Geyser server."
# 设置基岩版 MOTD 显示信息
# 在 passthrough-motd 配置项设为 true 时无效
# 若二者均为空,则会显示 Geyser。
server-name: "Geyser"
# 设置服务器名称
compression-level: 6
# 设置数据压缩等级,设为 -1 以禁用此功能。
# 等级越高,CPU 占用率将越高,反之流量消耗越快,请自行权衡。
# 允许值: [-1, 9]
enable-proxy-protocol: false
# 是否允许 proxy-protocol
# 即是否启用代理的 proxy-protocol 功能,以获取访问者真实 IP。
# 允许值:
# 是: true
# 否: false
proxy-protocol-whitelisted-ips: [ "127.0.0.1", "172.18.0.0/16" ]
# 设置允许使用代理连接的 IP 地址,仅在 enable-proxy-protocol 配置项设为 true 时有效。
# IP 地址和子网地址均可使用。
# 删除此项配置,以禁用该功能。
remote:
# 连接到 Java 版服务端的配置信息
address: auto
# 设置 Java 版服务端的 IP 地址。
# 允许值:
# 本地主机 (127.0.0.1): auto
# 自定义 IP 地址: (自定义地址)
port: 25565
# 设置 Java 版服务端的监听端口。
# 对于插件版,若 address 配置项为 auto,则监听端口将自动设置。
# 允许值: [1, 65535]
auth-type: online
# 设置玩家进入服务器时的验证方式。
# 允许值:
# 正版登录: online
# 离线登录: offline
# Floodgate 插件: floodgate
allow-password-authentication: true
# 是否允许使用密码进行登录验证,仅在 auth-type 配置项设为 online 时有效。
# 允许值:
# 是: true
# 否: false
use-proxy-protocol: false
# 是否使用 proxy-protocol
# 仅在支持 proxy-protocol 的服务端中有效,如 BungeeCord。
# 允许值:
# 是: true
# 否: false
forward-hostname: false
# 是否将使用基岩版客户端进入服务器的玩家的主机名用于连接 Java 版服务端
# 允许值:
# 是: true
# 否: false
# 以下是全局配置项
floodgate-key-file: key.pem
# 设置 Floodgate 密钥文件
# 未使用 Floodgate 时,请保留默认值。
saved-user-logins:
- ThisExampleUsernameShouldBeLongEnoughToNeverBeAnXboxUsername
- ThisOtherExampleUsernameShouldAlsoBeLongEnough
# 设置用于正版验证的 token。
# 如上方所示,应填写两个足够长的字符串,并确保其不会是一个 Xbox 用户名。
# 相关缓存保存在 saved-refresh-tokens.json 文件中。
pending-authentication-timeout: 120
# 设置在用户通过 Geyser 登录 Microsoft 账号时的最长等待时间,单位为秒。
# 允许值: [1, ∞]
command-suggestions: true
# 是否启用命令建议功能
# 允许值:
# 是: true
# 否: false
passthrough-motd: false
# 是否将 Java 版服务端的 MOTD 信息同步至基岩版
# 允许值:
# 是: true
# 否: false
passthrough-protocol-name: false
# 是否将 Java 版服务端的协议名称同步至基岩版
# 允许值:
# 是: true
# 否: false
passthrough-player-counts: false
# 是否将 Java 版服务端的在线玩家数和玩家数上限同步至基岩版
# 允许值:
# 是: true
# 否: false
legacy-ping-passthrough: false
# 是否启用传统的 ping 同步模式
# 除非 MOTD 信息或在线玩家数未正确显示,否则没有启用此功能的必要。
# 此功能在 Geyser 独立版中无效。
# 允许值:
# 是: true
# 否: false
ping-passthrough-interval: 3
# 设置 ping Java 版服务端的频率,单位为秒。
# 仅适用于 Geyser 独立版或将 legacy-ping-passthrough 配置项设为 true 的情况。
# 允许值: [1, ∞]
forward-player-ping: false
# 是否将玩家的 ping 请求转发至 Java 版服务端
# 启用后将使基岩版玩家获得更准确的 ping,但可能使玩家更易连接超时。
# 允许值:
# 是: true
# 否: false
max-players: 100
# 设置显示的最大在线玩家数。
# 仅用于显示,并不会真正限制在线玩家数。
# 允许值: [1, ∞]
debug-mode: false
# 是否启用调试模式
# 启用后,调试信息将被发送至控制台。
# 允许值:
# 是: true
# 否: false
# Allow third party capes to be visible. Currently allowing:
# OptiFine capes, LabyMod capes, 5Zig capes and MinecraftCapes
allow-third-party-capes: true
# 是否允许使用第三方披风
# 目前支持 OptiFine 披风、LabyMod 披风、5Zig 披风及 Minecraft 披风。
# 允许值:
# 是: true
# 否: false
allow-third-party-ears: false
# 是否允许第三方 deadmau5 监听器可见
# 目前支持 Minecraft 披风。
# 允许值:
# 是: true
# 否: false
show-cooldown: title
# 设置是否、如何为基岩版玩家显示一个假的攻击冷却指针。
# 允许值:
# 显示到标题处: title
# 显示到活动栏处: actionbar
# 不启用此功能: false
show-coordinates: true
# 是否允许显示坐标
# 允许值:
# 是: true
# 否: false
disable-bedrock-scaffolding: false
# 是否禁止基岩版玩家使用脚手架的方式搭桥
# 允许值:
# 是: true
# 否: false
always-quick-change-armor: false
# 是否允许基岩版玩家将正在手持的盔甲穿戴到盔甲栏
# 允许值:
# 是: true
# 否: false
emote-offhand-workaround: "disabled"
# 是否启用表情副手解决方案
# 启用后,当基岩版玩家发送表情时,其主、副手中的物品将如 Java 版一样呼唤。
# 允许值:
# 已禁用: disabled
# 无表情: no-emotes
# 交换物品: emotes-and-offhand
# default-locale: en_us
# 设置默认语言环境
# 这决定了当服务端中已有的语言不包括客户端请求使用的语言时,将使用的语言类型。
cache-images: 0
# 设置从网络下载的图像保存在缓存中的最长天数,单位为天。
# 设为 0 以禁用此功能。
# 允许值: [1, ∞]
allow-custom-skulls: true
# 是否允许自定义生物头颅
# 在早期或低配设备中保持允许,可能会导致性能下降。
# 允许值:
# 是: true
# 否: false
add-non-bedrock-items: true
# 是否在基岩版中添加非基岩版物品
# 目前仅对 Java 版的熔炉矿车生效。禁用此功能后,Java 版的熔炉矿车在基岩版中将被转换为漏斗矿车。
# 更改此配置项后,必须重启 Geyser 服务端以应用。
# 允许值:
# 是: true
# 否: false
above-bedrock-nether-building: false
# 是否禁用基岩版在下界 Y127 以上位置禁止建造方块的功能
# 启用后,Geyser 将通过把下界的维度 ID 改为末地的维度 ID 以实现此功能。
# 相应的,此时的下界将只能使用红色的迷雾,而不能在每个生物群系中有不同迷雾。
# 允许值:
# 是: true
# 否: false
force-resource-packs: true
# 是否强制加载 Java 服务端中的资源包
# 允许值:
# 是: true
# 否: false
xbox-achievements-enabled: false
# 是否解锁 Xbox 进度 (成就)
# 解锁后,将禁用所有成功在基岩版中运行的命令。
# 允许值:
# 是: true
# 否: false
metrics:
# metrics 配置项
# bStats 是一个用于追踪服务器运行状况 (如在线人数) 的平台。
# 前往 https://bstats.org/plugin/server-implementation/GeyserMC 查看更多信息。
enabled: true
# 是否启用 mertics
# 允许值:
# 是: true
# 否: false
uuid: 72780cd2-5033-4d42-a329-30845a70f646
# 设置服务器的 UUID。
# 请勿修改此配置项。
# 以下是高级选项
# 在修改前,请确认您清楚自己在做什么。
scoreboard-packet-threshold: 20
# 设置计分板数据包每秒的数量。
# 允许值: [4, 20]
enable-proxy-connections: false
# 是否允许来自 ProxyPass 和 Waterdog 的连接
# 更多信息见 https://www.spigotmc.org/wiki/firewall-guide/
# 允许值:
# 是: true
# 否: false
mtu: 1400
# 设置 MTU 值。
# 允许值: [0, 1492]
use-direct-connection: true
# 是否直接连接至 Java 服务端,而不是创建 TCP 连接
# 只应在数据包或网络无法正常与 Geyser 正常工作时禁用此功能。
# 若在插件版本中启用,则将忽略 Java 版服务端地址及监听端口配置项。
# 若在插件版本中禁用,则性能将会下降,同时延迟将会增加。
# 允许值:
# 是: true
# 否: false
config-version: 4
# 设置配置文件版本
# 允许值: [0, ∞]