SyncCraft

SyncCraft

将你的服务器与移动设备关联,让玩家基于设备的物理和内部检测体验内容。

游戏机制

SyncCraft

SyncCraft 将你的手机变成 Minecraft 世界控制器。手机上的每个传感器都映射到游戏中的某个机制——倾斜以改变重力,将摄像头对准天空,摇晃以引发地震。一个人用手机就能为服务器上的所有人控制体验。



该模组附带一个 Android 配套应用和一个内置的 Web 控制面板。所有内容都通过单一端口连接。

下载 Android 配套应用


功能

传感器

手机传感器 游戏内效果
倾斜 / 陀螺仪 为玩家和实体改变重力(可分别单独开关)。侧倾以推动,屏幕朝下以进入低重力。摄像机倾斜和玩家模型会随之倾斜。低重力下坠落伤害减少。装饰实体(物品展示框、画、拴绳、盔甲架)不受重力效果影响。
摄像头 投射到天空盒顶部。抬头即可看到真实世界。带有暗角混合的平滑淡入/淡出。
摇晃 地震——摄像机晃动,实体被推动,可选地击碎附近的玻璃和冰块。
手电筒 开 = 所有玩家获得夜视。关 = 移除。
电池电量 高于 20% = 晴天。低于 20% = 下雨。低于 5% = 雷暴。
环境光 房间亮度映射到一天中的时间。暗房间 = 午夜,亮房间 = 正午。
距离传感器 手机屏幕朝下或放入口袋 = 所有玩家隐身并潜行。
气压计 带着手机行走会使实体产生细微的高度起伏。
充电 插入电源 = 所有玩家获得生命恢复 I。
麦克风 声音从天空传来,带有回声和空间音频。在地下时声音沉闷。
勿扰模式 静音服务器范围内所有玩家聊天。
通知 在每个玩家附近生成一只临时的发光蠹虫。
截图 对所有客户端产生闪光弹效果 + 自动保存一张游戏内截图。
省电模式 将所有客户端帧率限制为 15 FPS,并显示屏幕指示器。

抓取之手 —— 从地图视图拖动玩家在世界中移动。被拾起的玩家漂浮在地形上方,松开后获得缓降效果。

世界视图 —— 实时小地图流式传输到你的手机或浏览器,显示地形、玩家位置、生命值、饥饿值、经验值、天气和时间。


需求

  • Minecraft 1.21.6 至 1.21.11(Fabric)开发中
  • Fabric Loader 0.18.5+
  • Fabric API(与你使用的 MC 版本匹配)
  • Java 21+
  • 所有玩家都需要安装该模组(服务端 + 客户端)

设置

安装

将 SyncCraft 的 .jar 和 Fabric API 放入服务端和所有客户端的 mods/ 文件夹中。

服务端

模组会自动在端口 25566 上启动 WebSocket + HTTP 服务器。无需额外设置。

连接

Android 应用

  1. 从 synccraft.lukecgg.com 下载配套应用
  2. 在你的 Android 设备(8.0+)上安装 APK
  3. 输入你的服务器 IP 和端口(默认 25566)
  4. 在服务器上运行 /synccraft pair 获取 6 位配对码
  5. 在应用中输入配对码
  6. 之后的连接无需配对码即可自动配对

Web 面板

  1. 在浏览器中打开 https://YOUR_SERVER_IP:25566/
  2. 接受自签名证书警告
  3. 运行 /synccraft pair 并输入配对码
  4. 在移动浏览器上,陀螺仪、摄像头和麦克风访问需要 HTTPS

使用

从应用仪表盘或 Web 面板切换传感器、摄像头和麦克风。Android 应用作为前台服务运行,锁屏时仍可持续传输。


命令

所有命令都需要管理员权限(等级 2)。

命令 描述
/synccraft pair 生成 6 位配对码(60 秒过期)
/synccraft disconnect 断开已配对的设备
/synccraft status 显示连接和功能状态
/synccraft reload 从磁盘重新加载配置
/synccraft config <feature> <true/false> 切换某个功能

可切换的功能:gravity、gravity_players、gravity_entities、skybox、darkness、flashlight、shake、battery、ambient、proximity


配置

所有设置位于服务端的 config/synccraft.json 中。

设置 默认值 描述
websocketPort 25566 连接端口
gravityEnabled true 重力总开关
gravityPlayersEnabled true 对玩家的重力效果(摄像机倾斜、推动、低重力)
gravityEntitiesEnabled true 对非玩家实体(生物、物品等)的重力效果
gravitySensitivity 1.0 倾斜力度倍率
shakeThreshold 1.5 最低摇晃强度
shakeBreaksBlocks false 地震是否破坏玻璃/冰块
batteryDuskThreshold 20 触发下雨的电池电量百分比
pairCodeExpirySeconds 60 配对码有效期

每个传感器功能都可以通过配置或 /synccraft config 单独切换。


网络

  • 单一端口处理 HTTP、HTTPS 和 WebSocket 连接
  • 自动生成自签名 SSL 证书
  • 设备信任系统——用配对码配对一次,之后自动重连
  • 一次一个控制器,支持设备接管
  • 内置速率限制和空闲超时
  • 手机断开连接时所有效果会干净地恢复

平台对比

功能 Android 应用 Web 浏览器
倾斜 / 陀螺仪 是 是(需要 HTTPS)
摄像头 是 是(需要 HTTPS)
摇晃 是 是
手电筒 是 是
电池电量 是 否
环境光 是 是
距离传感器 是 否
气压计 是 否
充电 是 否
麦克风 是 是(需要 HTTPS)
勿扰模式 是 否
通知 是 否
截图 是 否
省电模式 是 否
抓取之手 是 是
世界视图 是 是
后台传输 是(前台服务) 否(标签页必须保持打开)

Android 应用提供最完整的体验。Web 面板适用于陀螺仪、摄像头、麦克风和地图控制,但无法访问电池、手电筒、通知、勿扰模式或省电模式等系统级功能。


注意事项

  • 端口 25566 必须能从你的手机或浏览器访问。如果在远程服务器上,请进行端口转发。
  • 该模组是为一个控制器影响所有玩家而设计的——最适合派对游戏、直播或与朋友一起玩。