kieran/fpv-freecam
1
0
Fork 0
Code Issues Pull requests Projects Releases 4 Packages Wiki Activity Actions
No description
27 commits 3 branches 4 tags 6.3 MiB
  • Java 98.4%
  • Nix 1.3%
  • Shell 0.3%
Find a file
Exact
kieran 5f78b7919c
Some checks failed
CI / Fabric 26.1 (push) Successful in 1m59s
Details
CI / Fabric 26.3 (push) Successful in 1m41s
Details
CI / NeoForge 1.21.1 (push) Successful in 2m16s
Details
CI / Fabric 1.21.11 (push) Failing after 52s
Details
CI / Fabric 26.2 (push) Failing after 51s
Details
Add Fabric 26.3 support and fix controller config input
2026-09-17 16:32:28 -04:00
.forgejo/workflows Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
.ok-planner Add ok-planner scaffolding and five-inch flight simulation spec 2026-07-25 13:01:24 -07:00
branding Import fixed FPV Freecam with Forgejo CI/CD 2026-07-14 13:51:57 -07:00
common Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
fabric-1.21.11 Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
fabric-26.1 Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
fabric-26.2 Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
fabric-26.3 Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
gradle/wrapper Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
neoforge-1.21.1 Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
.editorconfig Import fixed FPV Freecam with Forgejo CI/CD 2026-07-14 13:51:57 -07:00
.gitignore Import fixed FPV Freecam with Forgejo CI/CD 2026-07-14 13:51:57 -07:00
AGENTS.md Import fixed FPV Freecam with Forgejo CI/CD 2026-07-14 13:51:57 -07:00
build.gradle Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
CHANGELOG.md Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
CONTRIBUTING.md Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
flake.lock Import fixed FPV Freecam with Forgejo CI/CD 2026-07-14 13:51:57 -07:00
flake.nix Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
gradle.properties Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
gradlew Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
gradlew.bat Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
launch-all-clients.sh Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
LICENSE Import fixed FPV Freecam with Forgejo CI/CD 2026-07-14 13:51:57 -07:00
README.md Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
settings.gradle Add Fabric 26.3 support and fix controller config input 2026-09-17 16:32:28 -04:00
shell.nix Import fixed FPV Freecam with Forgejo CI/CD 2026-07-14 13:51:57 -07:00

README.md

100% client side fpv sim that you can use on any server that allows Freecam.

Note: It is not very accurate to real life (no shit) but I am working on making it better.

Please go to the Discord server for feedback and bug reports.

Supported versions

Fabric: Minecraft 1.21.11, 26.1, 26.2, and 26.3. NeoForge: Minecraft 1.21.1. Use the jar built for your Minecraft version.

For Fabric 26.3, install Fabric Loader 0.19.5 or newer, Fabric API 0.160.6+26.3 or newer for 26.3, Mod Menu 21.0.0-beta.1, and YACL 3.9.6+26.3-fabric. That YACL download is listed under snapshots; its bundled metadata accepts 26.3.

Minecraft 26.3 uses SDL for input. Existing gamepad button IDs and trigger calibration ranges stay the same. If a controller's name or mapping changes, select it again and check its bindings in the Controller page before flying.

Features

  • Client-only fixed-step FPV simulation (240 Hz) with acro-only rates
  • Betaflight-style RC rate / super rate / expo
  • Throttle curve, optional 3D Mode, motor lag, anisotropic drag, battery sag, and descent wash
  • Separate controller actions for Arm, Disarm, and Reset-to-Player
  • Crash model with EXIT_TO_PLAYER, QUICK_REARM, CHECKPOINT_RESPAWN, and NO_COLLISION
  • Four setup pages: Controller, Rates, Craft, Realism & Crash
  • Axis/button capture, calibration, invert options, and deadzone tuning
  • In-flight camera angle adjustment (optional)
  • Global active-flight exit triggers: Esc, movement keybind press, and optional damage edge detection

In-Game Setup

  1. Open the setup screen from Mod Menu.
  2. Controller page: select controller, bind Arm/Disarm/Reset, bind axes, set deadzone/invert.
  3. Rates page: tune roll/pitch/yaw RC/super/expo.
  4. Craft page: tune camera angle, throttle curve, 3D Mode, thrust, drag, and response; Mass changes rotational inertia, so a lighter craft snaps into rotations harder. Throttle Mid is the stick position that hovers, and Thrust To Weight sets the punch above it.
  5. Realism & Crash page: tune sag/wash, choose crash reset mode, and toggle Exit To Player On Damage.
  6. Active control behavior:
    • Arm enters FPV when inactive, and re-arms motors while detached when currently disarmed.
    • Disarm cuts motors but keeps the detached camera active; momentum and rotation continue naturally.
    • Reset exits back to the player camera.