Repo ↗ · Source README ↗ · Markdown & license bundle

Image reference (original game): Minecraft: Java Edition · original-game artwork, provided by IGDB. Image rights remain with their respective owners. This illustrates the referenced original game, not the actual visuals of this rewrite or mod.

Source maintainer: Svahnen · Revision: 1b7c076dbae5 · Catalogued: 2026-10-12

Source license: MIT · LICENSE · Article: Source README (format adapted)

The source README follows, with formatting adapted for this site and images replaced by source links. Feature, completion and testing claims belong to its authors and have not been independently playtested here. The Traditional Chinese translation was prepared with AI assistance.

FPVcraft

Fly a real-feeling FPV racing drone in Minecraft — with your own RC transmitter.

README link

▶ Watch the full demo video (1080p)

FPVcraft is a Fabric mod for Minecraft 1.21.1 that adds an FPV quadcopter driven by a full physics flight model,
not a flying camera. Thrust comes from motors and propellers, the battery sags under load, drag depends on the drone’s attitude,
and acro mode behaves like a real flight controller. Plug in your EdgeTX/OpenTX radio and fly your Minecraft worlds
the way you fly real quads.

Features

  • Real acro physics: rigid-body quadcopter model with motor/prop thrust, battery voltage sag, per-direction
    aerodynamic drag, ground effect, prop wash and crash physics. Acro, Angle and 3D modes.
  • Your radio, your rates: any USB-joystick transmitter (EdgeTX/OpenTX) or gamepad. A calibration wizard for
    stick modes 1-4, AETR/TAER presets, live two-stick preview. Betaflight, Actual, KISS, Raceflight and Quickrate rates, throttle mid/expo.
  • Four drones: 5" race, 5" freestyle, 3" micro and 7" long-range presets.
  • FPV view with OSD: camera uptilt, throttle, speed, battery and stick display. Press F5 for chase and front cameras.
  • Fly anywhere: chunks load around the drone, so you can fly as far as you like. Your body waits safely where you took off.
  • Multiplayer: everyone with the mod sees each other’s drones and the pilots left standing at home.
    The pilot is never harmed while flying. The drone is part of the world: mobs chase it, explosions, lava and fire destroy it,
    water slows it down, and it triggers pressure plates and tripwires.
  • Drone sound: layered motor sound that follows the RPM of each motor, plus wind, flips and crashes. Every sound is synthesized
    from scratch.
  • Engine-agnostic core: the flight model is a standalone C++ library with a plain C API (fpvcore), so other games can use it too.

Install

  1. Install Fabric Loader for Minecraft 1.21.1 and download Fabric API.
  2. Download fpvcraft-<version>.jar from the Releases page. One jar works on Windows and Linux (x86_64).
  3. Put both jars into your mods/ folder (or add them to a Fabric 1.21.1 instance in Prism, XMCL, etc.).
  4. For multiplayer, install the mod on the server and on every client.

Fly

Key Action
G Launch the drone and enter FPV. Press again to land and return to your body
K Controller setup and calibration
F5 Cycle camera: FPV, chase, front
H Reset the drone in front of you
, Next drone preset
Keyboard W/S throttle, A/D yaw, arrows pitch/roll, Z arm, X flight mode

Arm with the throttle all the way down, then throttle up (hover is just below centre stick). Commands: /fpv preset, /fpv rates,
/fpv fov, /fpv uptilt, /fpv battery, and more. See docs/MINECRAFT.md.

Radio setup: set your transmitter’s USB mode to Joystick (HID), plug it in before starting Minecraft, press K and run the wizard.
If Steam is running, disable Steam Input for the radio. Otherwise Steam turns the sticks into mouse and keyboard.

Build from source

Needs a C++17 compiler, CMake, podman (for the portable Linux library) and JDK 21. See docs/BUILDING.md.

cmake -S . -B build && cmake --build build -j8 && ctest --test-dir build    # library + tests
cd adapters/minecraft-fabric && ./scripts/build-native.sh && ./gradlew build # mod jar

Documentation

License

Code: MIT. Sounds: CC0. Third-party notices: NOTICE. Details: docs/LEGAL.md.

FPVcraft is an unofficial fan project. It is not an official Minecraft product and is not approved by or associated with Mojang or Microsoft.

License and provenance

The README and its translation retain MIT terms. Changes comprise translation, links and formatting. Editable Markdown, the original README, LICENSE and NOTICE files are included in the linked bundle. This grants no rights to the original games, their assets or trademarks.

LICENSE

MIT License

Copyright (c) 2026 FPVcraft contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

NOTICE

FPVcraft / fpv-core: code is MIT (LICENSE); bundled sounds are CC0 (adapters/minecraft-fabric/src/main/resources/assets/fpvcore/CREDITS.txt).

Third-party components:
  third_party/nlohmann/json.hpp   JSON for Modern C++ 3.11.3, MIT (third_party/nlohmann/LICENSE.MIT)
  third_party/doctest/doctest.h   doctest, MIT (third_party/doctest/LICENSE.txt)
  adapters/minecraft-fabric/gradle/wrapper, gradlew, gradlew.bat   Gradle wrapper, Apache License 2.0

Minecraft is a trademark of Mojang AB. This project is not affiliated with or endorsed by Mojang or Microsoft.