BlackAnnin’s Drone

中文简介

一架会自己飞的航拍无人机。

主要功能：

• 自主跟随与智能寻路——自动跟随玩家飞行：绕过障碍、穿过门洞、开启铁门，受阻时自动脱困；高速移动（疾跑、鞘翅、创造飞行及其他模组飞行）实时跟随，大幅升降时镜头持续对准玩家；玩家退出游戏后原地留驻，回来后恢复跟随与推流；
• Spout2 实时推流——机载画面以原版渲染管线渲染，实时输出至 OBS，玩家自身视角与 HUD 不受任何影响，适用于直播与录屏；推流画面可叠加 CLEAN / PRO 两种风格的 OSD（REC、准星、遥测、航向刻度带、人工地平线等），玩家自己的屏幕不显示；
• 手动驾驶与自动运镜——通过无人机遥控器或快捷键进入手动模式，支持键盘三轴移动与鼠标/摇杆视角控制；「自动运镜」按钮可在环绕、追尾、正前方、侧跟四种机位间自动轮换拍摄，半径、速度、高度与镜头时长均可配置；
• 高度可靠性——无人机免疫火焰、摔落与生物伤害，不会被击落或误伤，仅可由所有者回收。

v0.7.1 全面支持 Iris 光影：玩家画面和无人机画面都带完整的光影效果——已实测通过 Iris 1.8.14 + Sodium 0.8.13 + Complementary Reimagined / Euphoria Patches 的组合，推流画面中同样带光影，且不影响玩家自身视角。推流帧率可在配置中调整（开启光影时建议降低），OBS 侧会保持上一帧画面。

• 需要 Minecraft 1.21.1 + NeoForge 21.1.25x
• 推流需安装 obs-spout2-plugin

English

An aerial drone that flies itself.

Key features:

• Autonomous following with smart pathfinding — the drone follows the player automatically, navigating around obstacles, passing through doors and freeing itself when stuck; it keeps up in real time at high speeds (sprinting, elytra, creative or mod-added flight) with the camera staying aimed at the player during large climbs and falls; it stays in the world when you log off and resumes following and streaming when you return;
• Real-time Spout2 streaming — the camera feed is rendered with the vanilla pipeline and output to OBS in real time while the player’s own view and HUD remain completely unaffected, for streaming and recording; the streamed frame can carry a CLEAN or PRO style OSD (REC indicator, reticle, telemetry, heading ribbon, artificial horizon and more), never shown on the player’s own screen;
• Manual control and cinematic mode — enter manual mode with the Drone Remote or a hotkey for keyboard-based three-axis movement and mouse/stick view control; the Cinematic button cycles the drone through orbit, chase, front and tracking camera positions, with configurable radius, speed, height and shot duration;
• High reliability — the drone is immune to fire, fall damage and mob attacks, cannot be shot down, and can only be retrieved by its owner.

v0.7.1 brings full Iris shader support: both the player’s view and the drone feed carry the complete shader look — validated with Iris 1.8.14 + Sodium 0.8.13 + Complementary Reimagined / Euphoria Patches, streaming with shaders on and never touching the player’s own view. The stream frame rate is configurable (lower it while shaders are on), and OBS simply holds the last frame between updates.

• Requires Minecraft 1.21.1 + NeoForge 21.1.25x
• For streaming, install obs-spout2-plugin