libfpv

FPV drone in any game

Real Betaflight firmware, your own radio, and the games you already love. libfpv drops a true-to-life quadcopter into Mario, GTA, Portal and more. Free and open source.

100%
open source & free
BF 2025.12
real Betaflight firmware
1 kHz
simulation loop
5
games and counting

Compatible games

5 games. One real quad.

The same libfpv drone, with the same Betaflight tune, flies in every one of them. Each mod hooks the game's own world: its collisions, its people, its weather and its police.

PCsm64ex portBrowserPlayable

Super Mario 64

Mario has a drone now

Mario deploys a quad and stays behind as the pilot. Fly through the Mushroom Kingdom at real scale, through goggles that get noisier the further you go.

  • Press F7 to launch the drone, and F to get back to Mario
  • Fly through coins, stars, keys and 1-ups to collect them
  • Knock out Goombas, Koopas and Bob-ombs by ramming them
  • Every level has its own wind; lava and flames burn your props
  • Analog goggle feed: snow, torn lines and colour loss with range
WindowsPlayable

GTA IV

Liberty City from above

Press F7 and Niko launches a quad from the street in front of him. Dive between skyscrapers, chase traffic, then put Niko right where you landed.

  • Collides with buildings, cars, peds and props via the engine's physics
  • A fast hit ragdolls a ped, dents a car or shoves a prop
  • Full GPS OSD with a home arrow pointing back to Niko
  • Clean view for recording: HUD, OSD and subtitles off on a switch
WindowsmodloaderPlayable

GTA San Andreas

The city treats the drone as CJ

CJ throws a quad into the air and stands there with a radio in his hands. Gangs, peds and the police react to the drone as if it were him.

  • Get a wanted level and the cops come for the drone and shoot at it
  • Storms blow hard, helicopters push you down, explosions shove you
  • Leave the drone hovering and walk or drive as CJ, then fly back
  • Streaming and traffic follow the drone wherever you fly
macOSApple SiliconreVCPlayable

GTA Vice City

Native on Apple Silicon Macs

A plugin for the macOS recompilation of Vice City. Tommy launches a quad from the ground and the neon city opens up below it. Self-contained: nothing else to install.

  • The drone picks up pickups and flies through doors into interiors
  • The police notice it, and Tommy stays at his spot as the pilot
  • Uses the game's own sounds for launches, crashes and camera switches
  • "Move Tommy here" lands him and his car right under the drone
WindowsmacOSApple Siliconsource-recompPlayable

Portal 2

The drone is the portal gun

Solve Aperture's test chambers by quad. Fire portals from the camera, dive into a floor portal and come out of a wall with all your momentum.

  • Hook a cube under the drone on a winch line and lower it onto a button
  • Turrets shoot at the drone, lasers burn its props, goo drowns it
  • Faith plates launch it and excursion funnels carry it
  • Co-op: a friend flies while you walk around as Chell

Your game next?

Every game here is a mod built on libfpv, and the list keeps growing. Patrons get a place in the priority queue for picking which game gets a drone next, and they play it first.

Watch the flights

Short clips from every game.

New mods, new tricks, and a lot of crashes into famous buildings. Short videos of libfpv in games go up on YouTube, Instagram and TikTok first.

What you get

It flies like the real thing. Because it is.

Every libfpv mod ships with a full FPV simulator inside. Press F8 in any game to open the overlay: radio setup, rates, tuning, OSD, camera, the Betaflight CLI.

Betaflight in the loop

Not a lookalike: the real Betaflight 2025.12 runs inside the game through SimITL. Rates, modes, filters, arming and turtle mode behave as on your quad. Connect Betaflight Configurator, or paste a diff all from your real drone.

Your radio, your gamepad

Plug in your transmitter in USB joystick mode. A setup wizard maps arm, angle, beeper, turtle and air mode. Gamepad and keyboard work too.

Wind that fights back

The game's weather becomes real wind: gustier up high, calm behind buildings, helicopter downwash and blast waves. Betaflight has to hold the quad against it.

A real goggle feed

Fisheye lens, uptilt, and a 5.8 GHz link budget: snow, sparkles, torn lines and colour loss with range, walls and crashes. Digital links break up and freeze.

Physics presets

From a BetaFPV Air65 tiny whoop to a 7" long-range cruiser. Frame, motors, props, battery, VTX and camera are presets, with real cameras like the Caddx Ratel 2 and HDZero Nano 90.

Full OSD with GPS

Betaflight's own MAX7456 fonts, analog or HD. Speed, altitude, vario, distance and a home arrow pointing back to your character.

Motor sound

Synthesized motors and beeper, quieter far away and behind walls, with Doppler and echoes.

Portals, pushes and cargo

Fly through linked portals with your momentum, get launched by pads, and carry things under the drone with their weight.

Fly from a link

A game with source available can ship its mod as a web page: game and libfpv compiled to WebAssembly, radio included. Nothing to install.

Open source

Made in the open, for the modding community.

libfpv is 100% open source and free. FPV pilots get to fly through the worlds they grew up with, and modders get a ready drone instead of writing a flight model from scratch. Read the code, file an issue, send a pull request, or build a mod of your own.

libfpv stays free

The simulator itself is 100% open source and free, and it will stay that way. No paywall, no locked features.

Every line on GitHub

The library and its patches to Betaflight and SimITL are public. So are all of today's game mods.

GPL-3.0, with MIT parts

The library is GPL-3.0-or-later. The C API header, client code, renderers and examples are also MIT, so an integration can use any license, open or closed.

Open to every integration

A plain C API, documented inline, loads from any engine or mod loader. Bring a drone to your favourite game, and share it however you like.

For modders

Give your favourite game a drone.

libfpv has no renderer of its own and a plain C API, so it loads from any engine or mod loader. The game supplies collision and draws the result; libfpv does everything else.

Your radio

Transmitter, gamepad or keyboard, read through an embedded SDL3.

libfpv

Betaflight + physics on its own 1 kHz thread, colliding with the game's world.

The game

Gets the drone's pose, cameras, OSD and sound, and draws the frame.

your_mod.c
fpv_global_config cfg;
fpv_global_config_defaults(&cfg);
cfg.data_dir = "<writable folder>";
cfg.coords = fpv_coords_preset(FPV_COORDS_Y_UP_RIGHT_HANDED, 1.0f);
fpv_global_init(&cfg);                        // once

fpv_static_surfaces_load(&level_mesh, 1);     // world collision
fpv_drone *d;
fpv_drone_create(NULL, &d);                   // spawn

// every frame
fpv_drone_tick(d, dt, &frame);
// place the camera at frame.camera, draw the drone at
// frame.position / frame.rotation, then draw the OSD and overlay

fpv_global_terminate();                       // on unload / exit

Support the project

Keep the props spinning.

libfpv is a 100% open source and free project, built by one developer. If it made you smile, put your quad through a Liberty City window, or saved your mod weeks of work, consider chipping in.

Monthly

Become a patron

  • The Kamikaze version of the mods

    Bomb switches and safety features, detonation on impact or on a button, and different views of the explosion.

    Not designed for military use.

  • Early access to new FPV mods

    Fly the drone mods for other games before anyone else.

  • The priority queue

    Your say comes first when the next game to mod is picked.

  • More games, better drone

    Your contribution helps libfpv thrive and get integrated into more video games.

Subscribe on Patreon
One time

Buy a set of props

Not into subscriptions? A single donation through PayPal goes straight into development time and new games.

  • No account on Patreon needed
  • Any amount helps
  • Goes straight into new mods
libfpv itself stays free and open source no matter what. Support pays for development time, not for access to the simulator.