需手动添加并连接支持MC.js协议的WebSocket服务器:先获取ws://或wss://格式地址,再通过开发者控制台注入配置或使用内置服务器菜单设置,注意协议匹配与版本兼容性。

如果您希望在MC.js网页版中实现多人联机,需要手动添加并连接到支持MC.js协议的联机服务器。以下是完成服务器添加与连接的详细操作步骤:
一、确认服务器地址与端口信息
MC.js网页版仅支持特定格式的WebSocket服务器,必须提供有效的ws://或wss://地址及端口号。该地址通常由第三方MC.js服务提供商公开,不可使用传统Java版或Bedrock版服务器地址。
1、访问可信MC.js服务器列表网站,例如mcjs.online或github.com/mc-js/servers,查找标注“Web可用”或“WS支持”的服务器条目。
2、复制对应服务器的完整连接地址,例如ws://play.mcjs.example:8080或wss://secure.mcjs.example:443。
3、核对地址末尾是否包含端口号;若未显示,默认端口为80(ws)或443(wss),但部分服务器需显式指定如:8080或:3000。
二、在MC.js网页版界面输入服务器信息
MC.js网页版不提供自动发现功能,需通过开发者控制台注入配置或使用支持服务器导入的特定构建版本。
1、打开浏览器,访问MC.js官方网页版地址(如mcjs.dev或托管该前端的URL)。
2、按F12打开开发者工具,切换至Console标签页。
3、粘贴并执行以下JavaScript命令(将其中示例地址替换为您获取的真实地址):
window.MCJS_CONFIG = { server: "ws://play.mcjs.example:8080" };
4、刷新页面,此时加载器将优先尝试连接该WebSocket地址。
三、使用预置服务器选择菜单(如界面含该功能)
部分MC.js网页分支版本(如mcjs-legacy-v2.4+)内置下拉式服务器选择器,无需修改代码即可切换目标服务器。
1、在主界面右上角查找齿轮图标或“服务器”文字按钮,点击展开选项。
2、在弹出菜单中选择“自定义服务器”或“添加新服务器”项。
3、在输入框内填写服务器名称(如“社区主服”)和完整WebSocket地址,例如:wss://hub.mcjs-community.org:443。
4、点击“保存”后,该条目将出现在服务器列表中,点击即可发起连接请求。
四、检查跨域与HTTPS限制
现代浏览器禁止非安全上下文(HTTP页面)加载wss://资源,或阻止ws://在HTTPS页面中运行,需确保协议匹配。
1、确认当前MC.js网页版访问地址以https://开头;若为http://,则仅可连接ws://地址,且部分浏览器会直接屏蔽。
2、若页面为HTTPS而服务器地址为ws://,连接将被拒绝;此时必须更换为支持TLS的wss://地址。
3、在Console中观察报错信息:出现“Mixed Content”或“Failed to construct 'WebSocket'"即表明协议不匹配,需修正地址协议类型。
五、验证连接状态与处理常见错误
连接成功前,MC.js前端会在控制台输出连接日志,并在界面底部显示状态提示;失败时将抛出明确错误类型。
1、连接中时,Console可见类似“Connecting to ws://...”的日志;成功后出现“Connected, handshake complete”。
2、若提示“Error: connection timeout”,说明网络无法抵达目标IP与端口,请检测防火墙、代理或服务器是否宕机。
3、若提示“Invalid protocol version”或“Handshake failed”,表明服务器运行的MC.js后端版本与当前网页版不兼容,需更换匹配版本的服务器地址。











