
SyncCraft
将你的服务器与移动设备关联,让玩家基于设备的物理和内部检测体验内容。
查看大图SyncCraft
SyncCraft 将你的手机变成 Minecraft 世界控制器。手机上的每个传感器都映射到游戏中的某个机制——倾斜以改变重力,将摄像头对准天空,摇晃以引发地震。一个人用手机就能为服务器上的所有人控制体验。
该模组附带一个 Android 配套应用和一个内置的 Web 控制面板。所有内容都通过单一端口连接。
功能
传感器
| 手机传感器 | 游戏内效果 |
|---|---|
| 倾斜 / 陀螺仪 | 为玩家和实体改变重力(可分别单独开关)。侧倾以推动,屏幕朝下以进入低重力。摄像机倾斜和玩家模型会随之倾斜。低重力下坠落伤害减少。装饰实体(物品展示框、画、拴绳、盔甲架)不受重力效果影响。 |
| 摄像头 | 投射到天空盒顶部。抬头即可看到真实世界。带有暗角混合的平滑淡入/淡出。 |
| 摇晃 | 地震——摄像机晃动,实体被推动,可选地击碎附近的玻璃和冰块。 |
| 手电筒 | 开 = 所有玩家获得夜视。关 = 移除。 |
| 电池电量 | 高于 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 应用
- 从 synccraft.lukecgg.com 下载配套应用
- 在你的 Android 设备(8.0+)上安装 APK
- 输入你的服务器 IP 和端口(默认 25566)
- 在服务器上运行
/synccraft pair获取 6 位配对码 - 在应用中输入配对码
- 之后的连接无需配对码即可自动配对
Web 面板
- 在浏览器中打开
https://YOUR_SERVER_IP:25566/ - 接受自签名证书警告
- 运行
/synccraft pair并输入配对码 - 在移动浏览器上,陀螺仪、摄像头和麦克风访问需要 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 必须能从你的手机或浏览器访问。如果在远程服务器上,请进行端口转发。
- 该模组是为一个控制器影响所有玩家而设计的——最适合派对游戏、直播或与朋友一起玩。
正在加载版本记录…



正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。