CBD - 跨平台浏览器显示

CBD - 跨平台浏览器显示

CBD将Java版串流到任何手机或平板浏览器上，几乎无需设置，为客厅游戏提供真正的多点触控屏控制。

CBD - 跨平台浏览器显示

CBD 是一个轻量级的 Minecraft Java 版模组，可将手机、平板或其他支持浏览器的设备转变为 Minecraft 的无线触屏控制器和显示器。

无需专用的移动应用或外部串流程序，CBD 直接在 Minecraft 内部托管其本地网页界面。通过 Safari、Chrome、Firefox 或其他现代浏览器连接，即可使用移动风格的触屏控制来操控你的 Minecraft 客户端。

无需从应用商店下载、无需侧载、也无需外部串流软件。

[!WARNING] CBD 目前处于早期开发阶段。

各版本之间可能会出现错误、性能问题、特定浏览器问题、功能缺失、控制问题以及破坏性变更。

功能特性

  • 基于浏览器的 Minecraft 串流
  • 支持手机和平板
  • 无需专用移动应用
  • 内置本地网页服务器
  • 二维码连接
  • 多点触控输入支持
  • 移动风格虚拟控制
  • 本地网络串流
  • 支持 Fabric
  • 支持 NeoForge
  • 支持单人游戏
  • 支持多人游戏
  • 保持轻量化设计
  • 无需外部远程桌面或串流软件

制作缘由

CBD 最初只是一个相当简单的个人项目。

我的女朋友通常更喜欢躺在床上用 iPad 玩，而不是坐在桌前的椅子上。由于 Minecraft Java 版确实没有一种简单的方式可以让她在 iPad 上玩，同时仍然使用 PC 上运行的游戏和模组，我想做一个能给她提供这种选择的东西。

CBD 成为了我的解决方案：让 Minecraft 在 PC 上正常运行，但通过浏览器将其串流到 iPad，并配上触屏控制，这样她就可以舒适地躺在床上玩，而无需再购买一份 Minecraft、单独的移动应用或外部串流软件。

这个个人使用场景至今仍是该模组背后的主要理念之一：让玩家不必直接坐在电脑前也能更轻松地玩 Minecraft Java 版。

工作原理

CBD 在 Minecraft 客户端内部运行一个嵌入式串流服务器。

Minecraft 在 PC 上继续正常运行，并处理：

  • 渲染
  • 模组
  • 光影
  • 世界
  • 多人游戏连接
  • 游戏逻辑

CBD 提供一个网页界面，本地网络上的其他设备可以连接到该界面。

你的手机或平板充当远程显示器和触屏控制器，而 Minecraft Java 版则继续在 PC 上运行。

安装方法

  1. 为你的 Minecraft 版本和模组加载器下载对应的 CBD .jar 文件。
  2. 将该文件放入你的 Minecraft mods 文件夹中。
.minecraft/mods
  1. 正常启动 Minecraft。

CBD 专为受支持的 Fabric 和 NeoForge 安装环境设计。

如何连接

1. 启动 Minecraft

安装 CBD 后启动 Minecraft。

2. 打开世界或服务器

正常加入单人世界或多人服务器。

3. 打开 CBD 界面

使用已配置的 CBD 按键绑定打开 CBD 配置界面。

4. 启用 CBD

必须通过界面手动启用 CBD 的串流服务器，其他设备才能连接。

在 CBD 界面中将服务器开启。

启用后，CBD 将启动其本地网页服务器并显示：

  • 本地连接地址
  • 二维码

如果在界面中禁用了 CBD，其他设备将无法连接。

5. 连接你的设备

在手机或平板上：

  1. 连接到与你的 PC 相同的本地网络。
  2. 打开 Safari、Chrome、Firefox 或其他现代浏览器。
  3. 扫描二维码或输入提供的地址。
  4. 打开 CBD 网页界面。
  5. 开始通过触屏界面操控 Minecraft。

无需在移动设备上安装任何 CBD 应用。

触屏控制

CBD 围绕移动风格的控制进行设计，而非简单地将触摸屏当作桌面鼠标来对待。

该界面正在开发中，旨在支持以下操作：

  • 移动
  • 视角转动
  • 跳跃
  • 潜行
  • 疾跑
  • 攻击
  • 使用物品
  • 与方块互动
  • 快捷栏选择
  • 背包访问
  • 其他常见的 Minecraft 控制操作

多点触控支持允许同时进行多个输入，例如边移动边转动视角。

触屏控制系统仍在积极开发中，不同版本之间可能会有重大变化。

支持的设备

CBD 旨在适用于支持现代浏览器的设备，包括：

  • Android 手机
  • Android 平板
  • iPhone
  • iPad
  • 笔记本电脑
  • Chromebook
  • 其他配备现代浏览器的设备

目标浏览器包括：

  • Chrome
  • 基于 Chromium 的浏览器
  • Safari
  • Firefox

浏览器行为可能因操作系统和设备而异。

多人游戏

CBD 运行在 Minecraft 客户端上。

这意味着你正常连接的 Minecraft 服务器无需因为你远程控制游戏而安装 CBD。

你的 PC 正常保持与多人服务器的连接，而 CBD 则单独处理浏览器连接。

服务器规则、权限和限制仍然适用。

性能

将 Minecraft 串流到其他设备需要额外的处理和网络活动。

性能可能取决于：

  • PC 硬件
  • Minecraft 分辨率
  • 游戏帧率
  • Wi-Fi 信号强度
  • 网络拥堵程度
  • 移动设备性能
  • 浏览器性能
  • 已安装的模组
  • 光影
  • 资源包
  • 渲染距离
  • CBD 串流设置

CBD 仍在持续优化中，因此不同版本之间的性能可能会有所变化。

为获得最佳体验，请使用稳定的本地网络。

安全性

CBD 会创建一个本地网页服务器，允许其他设备与你的 Minecraft 客户端通信。

请仅在信任的网络上启用 CBD。

CBD 目前主要预期用于受信任的本地网络，例如家庭 Wi-Fi。

除非你了解所涉及的网络安全风险，否则请避免将 CBD 服务器直接暴露于公共互联网。

开发状态

CBD 目前是早期开发软件。

核心串流和触屏系统仍在开发、测试和优化中。

你应预期遇到：

  • 错误
  • 崩溃
  • 界面变化
  • 触屏控制变化
  • 网络问题
  • 性能问题
  • 特定浏览器问题
  • 兼容性问题
  • 各版本间功能变化
  • 更新后偶发的功能回退

随着开发的继续，某些系统可能会被重写或替换。

如果你在寻找完全成熟的远程游玩体验，可能更适合等待后续版本。

如果你有兴趣在 CBD 开发期间进行测试，我们非常感谢你提交错误报告和反馈。

报告错误

报告问题时，请尽可能提供详细信息。

有用的信息包括：

  • CBD 版本
  • Minecraft 版本
  • 模组加载器
  • 模组加载器版本
  • 操作系统
  • 手机或平板型号
  • 移动操作系统
  • 浏览器及浏览器版本
  • 其他已安装的模组
  • 问题发生时你正在做什么
  • 重现问题的步骤
  • 截图或视频
  • 可用的 Minecraft 日志

详细的报告能够大大简化错误的复现和修复过程。

计划改进

未来可能的改进包括：

  • 更好的触屏控制
  • 自定义控制布局
  • 自定义按钮位置
  • 自定义按钮大小
  • 更好的多点触控处理
  • 改进的背包控制
  • 更好地支持 Minecraft 界面
  • 更好的模组化界面兼容性
  • 改进的串流质量
  • 更低的延迟
  • 串流质量预设
  • 更好的手机布局
  • 更好的平板布局
  • 改进的横屏支持
  • 改进的竖屏支持
  • 更好的浏览器兼容性
  • 改进的二维码连接流程
  • 更多配置选项
  • 连接安全性改进
  • 更好的连接管理
  • 性能改进
  • 稳定性改进

计划中的功能可能会随着开发的继续而变化。

常见问题解答

我需要在手机上安装应用吗？

不需要。 CBD 在你的网页浏览器中运行。

我需要在手机上安装 Minecraft 吗？

不需要。 Minecraft Java 版继续在你的 PC 上运行。

这是 Minecraft 基岩版吗？

不是。 CBD 控制的是运行在你电脑上的 Minecraft Java 版客户端。

Minecraft 服务器需要安装 CBD 吗？

通常不需要。 CBD 在你的客户端上运行，并独立于 Minecraft 多人服务器处理浏览器连接。

我可以使用 iPhone 或 iPad 吗？

CBD 旨在支持基于现代 Safari 的设备，尽管开发期间可能仍会出现特定浏览器的问题。

我可以使用 Android 吗？

可以。 现代 Android 浏览器是 CBD 的目标平台之一。

为什么该模组是闭源的？

CBD 目前闭源主要是因为仍处于早期开发阶段。

该项目的很大一部分涉及网络、浏览器连接、输入处理和 Minecraft 客户端的远程控制。在这些系统仍在设计和测试期间，我希望减少未完成的安全敏感代码被以可能产生不安全构建的方式重用、修改或分发的可能性。

这一点尤为重要，因为 CBD 允许其他设备向 Minecraft 客户端发送输入。被恶意修改或故意恶意的版本可能会带来未经授权的控制、恶意连接或劫持企图等风险。

目前保持项目闭源让我能更好地控制这些系统的实现和分发方式，同时我会致力于身份验证、连接安全性、权限和其他保护措施。

这并不意味着闭源就自动使模组安全。目标只是在 CBD 仍在快速变化期间，降低攻击面和非官方构建的数量。

一旦项目更加稳定且安全模型建立得更好，我可能会重新考虑将 CBD 的部分内容、API 或整个项目开源。

为什么我的手机无法连接？

请确认：

  • CBD 已在 CBD 界面中启用。
  • 你的手机和 PC 连接到同一个网络。
  • 你使用的是 CBD 提供的地址。
  • 你的防火墙没有阻止该连接。
  • CBD 服务器当前正在运行。

为什么串流有延迟？

延迟可能受到你的 PC、Minecraft 设置、Wi-Fi 连接、设备硬件、浏览器、光影、已安装模组以及 CBD 当前优化程度的影响。

为什么有些控制操作不正常？

触屏控制仍在积极开发中。 某些 Minecraft 界面、模组化界面、自定义按键绑定、浏览器和设备可能会有不同表现。

免责声明

CBD 是一个独立的 Minecraft 模组，与 Mojang Studios 或 Microsoft 没有任何关联，也未获得其认可。

CBD 按“原样”提供，不附带任何形式的保证。

无法保证串流性能、设备兼容性、浏览器兼容性、网络可靠性以及模组兼容性，尤其是在早期开发阶段。

用户有责任安全地配置自己的网络。

致谢

由 incold 创建。

CBD 的灵感来源于远程游玩系统、基于浏览器的串流、移动游戏界面，以及让 Minecraft Java 版能够从无法正常运行 Java 客户端的设备上访问的理念。