SyncCraft
SyncCraft 将你的手机变为 Minecraft 世界的控制器。手机上的每个传感器都映射到游戏中的某个功能——倾斜以改变重力,将摄像头指向天空,摇晃引发地震。一个人只需一部手机,即可控制服务器上所有人的体验。
该模组附带一个 Android 配套应用和内置的 Web 控制面板。所有连接均通过单一端口进行。
下载 Android 配套应用
功能
传感器
| 手机传感器 |
游戏内效果 |
| 倾斜 / 陀螺仪 |
改变玩家和实体的重力(可独立切换)。侧倾以推动,屏幕朝下则降低重力。相机倾斜与玩家模型倾斜同步。低重力环境下坠落伤害减少。装饰性实体(物品展示框、画作、拴绳、盔甲架)不受重力影响。 |
| 摄像头 |
流式传输至天穹天花板。抬头即可看到真实世界。平滑淡入/淡出并带有暗角混合效果。 |
| 摇晃 |
地震效果——相机晃动,实体被推离,可选择震碎附近的玻璃和冰。 |
| 手电筒 |
开启 = 所有玩家获得夜视效果。关闭 = 移除效果。 |
| 电池电量 |
高于 20% = 晴天。低于 20% = 下雨。低于 5% = 雷暴。 |
| 环境光 |
房间亮度映射为游戏时间。黑暗房间 = 午夜,明亮房间 = 正午。 |
| proximity (接近) |
手机屏幕朝下或放在口袋中 = 所有玩家进入隐身状态并潜行。 |
| 气压计 |
携带手机行走时,实体出现轻微的高度浮动。 |
| 充电状态 |
插入充电器 = 所有玩家获得生命恢复 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 应用可提供最完整的体验。网页面板在陀螺仪、摄像头、麦克风和地图控制方面表现良好,但无法访问电池、手电筒、通知、免打扰或省电模式等系统级功能。
注意事项
- 端口 25566 必须能从你的手机或浏览器访问。如果你在远程服务器上,请进行端口转发。
- 该模组设计为单个控制器影响所有玩家——最适合派对游戏、直播或与朋友一起游玩。
SyncCraft
SyncCraft turns your phone into a Minecraft world controller. Every sensor on your phone maps to something in the game — tilt to shift gravity, point your camera at the sky, shake to cause earthquakes. One person with a phone controls the experience for everyone on the server.
The mod comes with an Android companion app and a built-in web control panel. Everything connects over a single port.
Download the Android Companion App
Features
Sensors
| Phone Sensor |
In-Game Effect |
| Tilt / Gyroscope |
Shifts gravity for players and entities (independently toggleable). Tilt sideways to push, face-down for low gravity. Camera lean and player model tilt to match. Fall damage reduced in low-g. Decoration entities (item frames, paintings, leads, armor stands) are protected from gravity effects. |
| Camera |
Streams to the skybox ceiling. Look up and see the real world. Smooth fade-in/out with vignette blending. |
| Shake |
Earthquake — camera shakes, entities pushed, optionally shatters nearby glass and ice. |
| Flashlight |
On = Night Vision for all players. Off = removed. |
| Battery Level |
Above 20% = clear. Below 20% = rain. Below 5% = thunderstorm. |
| Ambient Light |
Room brightness maps to time of day. Dark room = midnight, bright room = noon. |
| Proximity |
Phone face-down or in pocket = all players go invisible and sneak. |
| Barometer |
Walking with phone causes subtle altitude bobbing on entities. |
| Charging |
Plugged in = Regeneration I for all players. |
| Microphone |
Voice plays from the sky with echo and spatial audio. Muffled underground. |
| Do Not Disturb |
Mutes all player chat server-wide. |
| Notifications |
Spawns a temporary glowing silverfish near each player. |
| Screenshot |
Flashbang effect on all clients + auto-saves an in-game screenshot. |
| Power Save |
Caps all clients to 15 FPS with an on-screen indicator. |
Grab Hand — Drag players around the world from the map view. Picked-up players float above terrain and receive Slow Falling on release.
World View — A live minimap streams to your phone or browser showing terrain, player positions, health, food, XP, weather, and time.
Requirements
- Minecraft 1.21.6 through 1.21.11 (Fabric) WIP
- Fabric Loader 0.18.5+
- Fabric API (matching your MC version)
- Java 21+
- All players need the mod installed (server + client)
Setup
Installation
Place the SyncCraft .jar and Fabric API into the mods/ folder on the server and all clients.
Server
The mod automatically starts a WebSocket + HTTP server on port 25566. No extra setup needed.
Connection
Android App
- Download the companion app from synccraft.lukecgg.com
- Install the APK on your Android device (8.0+)
- Enter your server IP and port (default 25566)
- Run
/synccraft pair on the server to get a 6-digit code
- Enter the code in the app
- Future connections auto-pair without a code
Web Panel
- Open
https://YOUR_SERVER_IP:25566/ in a browser
- Accept the self-signed certificate warning
- Run
/synccraft pair and enter the code
- HTTPS is required for gyro, camera, and mic access on mobile browsers
Usage
Toggle sensors, camera, and mic from the app dashboard or web panel. The Android app runs as a foreground service and keeps streaming with the screen locked.
Commands
All commands require operator permissions (level 2).
| Command |
Description |
/synccraft pair |
Generate a 6-digit pairing code (60 second expiry) |
/synccraft disconnect |
Disconnect the paired device |
/synccraft status |
Show connection and feature status |
/synccraft reload |
Reload config from disk |
/synccraft config <feature> <true/false> |
Toggle a feature |
Toggleable features: gravity, gravity_players, gravity_entities, skybox, darkness, flashlight, shake, battery, ambient, proximity
Configuration
All settings live in config/synccraft.json on the server.
| Setting |
Default |
Description |
websocketPort |
25566 |
Connection port |
gravityEnabled |
true |
Master gravity toggle |
gravityPlayersEnabled |
true |
Gravity effects on players (camera tilt, push, low-g) |
gravityEntitiesEnabled |
true |
Gravity effects on non-player entities (mobs, items, etc.) |
gravitySensitivity |
1.0 |
Tilt force multiplier |
shakeThreshold |
1.5 |
Minimum shake intensity |
shakeBreaksBlocks |
false |
Earthquakes break glass/ice |
batteryDuskThreshold |
20 |
Battery % that triggers rain |
pairCodeExpirySeconds |
60 |
Pairing code lifetime |
Every sensor feature can be toggled individually through the config or /synccraft config.
Networking
- Single port handles HTTP, HTTPS, and WebSocket connections
- Self-signed SSL certificate generated automatically
- Device trust system — pair once with a code, auto-reconnect after that
- One controller at a time with device takeover support
- Rate limiting and idle timeouts built in
- All effects revert cleanly when the phone disconnects
Platform Comparison
| Feature |
Android App |
Web Browser |
| Tilt / Gyroscope |
Yes |
Yes (HTTPS required) |
| Camera |
Yes |
Yes (HTTPS required) |
| Shake |
Yes |
Yes |
| Flashlight |
Yes |
Yes |
| Battery Level |
Yes |
No |
| Ambient Light |
Yes |
Yes |
| Proximity |
Yes |
No |
| Barometer |
Yes |
No |
| Charging |
Yes |
No |
| Microphone |
Yes |
Yes (HTTPS required) |
| Do Not Disturb |
Yes |
No |
| Notifications |
Yes |
No |
| Screenshot |
Yes |
No |
| Power Save |
Yes |
No |
| Grab Hand |
Yes |
Yes |
| World View |
Yes |
Yes |
| Background Streaming |
Yes (foreground service) |
No (tab must stay open) |
The Android app provides the fullest experience. The web panel works well for gyroscope, camera, mic, and map controls but cannot access system-level features like battery, flashlight, notifications, DND, or power save mode.
Notes
- Port 25566 must be reachable from your phone or browser. Forward it if you're on a remote server.
- The mod is built for one controller affecting all players — best suited for party games, streams, or playing with friends.
评论 0
登录后参与评分
还没有评论,来抢沙发吧