您指的是 GeyserMC(间歇泉插件/服务) 的相关命令与配置!以下是专为 跨平台互通(Java版+基岩版) 整理的 核心操作大全:
🔧 一、GeyserMC 核心配置命令(修改 config.yml
)
配置文件路径:
- 独立服务端 →
/config.yml
- 插件版(Spigot/Bukkit等) →
/plugins/Geyser/config.yml
⚙️ 常用配置参数速查表
参数 | 默认值 | 作用 | 推荐值 |
---|---|---|---|
bedrock.address | 0.0.0.0 | 基岩版监听的IP(服务器本机IP) | 无需修改 |
bedrock.port | 19132 | 基岩版连接端口(基岩玩家需填此端口) | 可改为 25565 (防屏蔽) |
remote.address | auto | Java服务器地址(同局域网填内网IP;公网填域名/IP) | 127.0.0.1 (同机运行) |
remote.port | 25565 | Java服务器端口(需与server.properties一致) | 确认Java端口一致 |
auth-type | online | 认证模式:online (正版验证)offline (盗版)floodgate (基岩免验证) | floodgate (跨平台必备) |
command-suggestions | true | 是否向基岩玩家显示命令提示 | 按需启用 |
show-coordinates | true | 基岩玩家是否显示坐标(Java版默认隐藏) | 强烈建议开启 |
🔄 配置修改示例
# 启用基岩版免验证(需配合Floodgate插件)
auth-type: floodgate
# 修改基岩连接端口(避免被运营商屏蔽)
bedrock:
port: 25566
# 指定Java服务器地址(若Geyser与Java服务不在同一机器)
remote:
address: "mc.yourserver.com"
port: 25565
🛠️ 二、GeyserMC 运行时管理命令
1. 控制台命令(服务端/后台输入)
命令 | 功能 |
---|---|
geyser reload | 重载配置文件(无需重启服务) |
geyser shutdown | 安全关闭Geyser服务 |
geyser connections | 查看当前连接的基岩玩家 |
geyser dump | 生成调试报告(排查问题时使用) |
2. 游戏内管理员命令(OP权限)
命令 | 功能 |
---|---|
/geyser help | 查看Geyser命令帮助 |
/geyser reload | 重载配置(需OP权限) |
/geyser version | 查看Geyser版本信息 |
❓ 三、高频问题解决方案
🔴 基岩玩家无法连接
- 检查点1:确认
bedrock.port
未被防火墙拦截(云服务器需放行UDP端口)。 - 检查点2:若使用
floodgate
模式,必须安装 Floodgate插件。 - 检查点3:
remote.address
若为公网IP,确保域名已解析。
🔴 基岩玩家显示“无效的会话”
# 将 config.yml 中以下参数改为:
auth-type: floodgate # 基岩免验证
enable-proxy-connections: true # 允许代理连接
🔴 基岩版看到方块/贴图错误
- 安装 Geyser-SkinManager 修复皮肤与材质。
- 在基岩客户端启用“官方材质包”(设置 → 全局资源 → 启用)。
💎 总结:GeyserMC 必做配置清单
- 端口修改:
bedrock.port
改为非19132
(如25566
)避免屏蔽。 - 认证模式:设置
auth-type: floodgate
+ 安装Floodgate实现基岩免验证。 - 坐标显示:确保
show-coordinates: true
(基岩玩家生存必备)。 - 连接检测:基岩版地址填 服务器IP:Geyser端口(如
12.34.56.78:25566
)。
⚠️ 注意:Geyser独立运行时需与Java服务端在同一网络,跨物理机需正确配置
remote.address
。
✅ 成功标志:基岩玩家在服务器列表中看到 “[Geyser] Java服务器名” 即表示连通!