The manual. No guesswork.
Every setting, every gate type, every key. From the first click to the QR code at the hall entrance: look it up instead of hunting for it.
Tip: use Ctrl/Cmd + F to find any keyword on this page.
Quick start#
From an empty field to a flyable course in five minutes, and to a link you can pass around.
- 01Open the editor: go to app.fpvtrackeditor.com in your browser. Nothing to install, no account to create. On first launch, a randomly generated track is already in the scene.
- 02Set the frame: in Settings, choose field size and gate count per type, or pick a field preset such as "Last OG3". Shuffle (
S) turns that into a new course. - 03Fine-tune: click gates, drag them, rotate with
Shift, raise withCtrl. Turn on pass-throughs to check order and entry sides; turn on flight path to see the ideal line. - 04Fly: Autopilot for the camera flight, Fly for your own flight with a radio or keyboard.
- 05Share: Share track opens the dialog with long link, short link, and QR code. Download the code, put it up, done.
First steps#
A desktop-first 3D editor for FPV race tracks, right in your browser, with no install.
The FPV Track Editor pairs a React interface with a Three.js scene. You don’t design the track in a form or on a 2D plan; you work directly in three-dimensional space. The same scene serves as editor, preview, and simulator.
On your first visit, the help opens once with the four basic gestures and the most important shortcuts. After that, you can reach it any time via the help button in the top bar.
Requirements
- A current browser with WebGL: Chrome, Edge, Firefox, or Safari.
- Mouse and keyboard are the recommended way. On touch devices, two-finger move and pinch zoom work, but the editor is explicitly built for desktop.
- For flying yourself, optionally a radio in USB joystick mode. Without a radio, you fly with the keyboard.
- No registration, no installation, no plug-in.
The interface#
Three zones: controls on top, tools on the left, the track in the middle.
Top bar
- Left: app title and beta badge.
- Center: undo and redo, Autopilot, Fly, the pole counter, and the display toggles Show grid, Grid snap (with snap precision), Flight path, Pass-throughs, and Drones.
- Right: the "#fpvooe" badge linking to fpvooe.com, the name of the loaded track, Import JSON, Export JSON, the language switch, and the help button.
Left toolbar
- Shuffle: a new random track from the current configuration.
- Save, Gallery, Official tracks.
- Design: switch themes.
- Settings: gate count, field size, field preset, and backup.
- Share track: long link, short link, and QR code.
3D scene
The track sits in the middle. Click a gate and its editing tools appear right on the object. A subtle "#FPVOOE" watermark sits in the center of the field. If rendering fails, the app shows an error screen with "Try again" instead of the scene.
Create a track#
One click, one suggestion, then the polish.
Shuffle in the toolbar or the S key generates a new random track from the current configuration. The generator keeps at least 3 m between gates, aligns them in 30° steps, and prefers the field edge for the start/finish gate.
Changing the configuration does not regenerate the track by itself. If the current track came from a generation and the configuration no longer matches, an "Apply new course configuration" button appears in Settings. After loading from the gallery or a JSON import there is no generation state, so new values only take effect on the next shuffle.
Settings & field presets#
Gate count, field size, venue, and a backup of your complete setup.
In Settings you set the gate count per type and the field size in meters. A field preset fixes both: "Last OG3", for example, is 10.5 × 22.7 m with four hall pillars. Width and length are then locked, and the pillars appear as obstacles in the scene.
"Reset to defaults" restores the factory settings: Custom, 30 × 15 m. The display options don’t live in Settings but as toggles in the top bar. They only change the display: grid, flight path, pass-throughs, grid snap, and theme travel with export and share link as display preferences, the drones toggle does not.
| Field preset | Dimensions | Special feature |
|---|---|---|
| Custom | 30 × 15 m (default) | Freely adjustable |
| Last OG3 | 10.5 × 22.7 m | Four hall pillars as obstacles |
The 11 gate types#
Every type has its own geometry, pass-through rule, and pole count.
| Gate type | Pass-through | Poles |
|---|---|---|
| Standard gate | Classic frame of two posts and a crossbar, the basis of almost every layout. | 3 |
| Start/finish gate | Standard frame with "Start" lettering on both sides; the generator prefers to place it at the field edge. | 3 |
| h-gate | Lower opening plus a side rail; the rail side is fixed per gate. | 4 |
| Double-h gate | A standard gate and an h-gate stacked: flyable at the bottom, in the middle, and at the top. | 7 |
| Hurdle | A wide, low hurdle at double width; fly over it at any height. | 0 |
| Dive gate | Cube-like frame, open at the bottom; entry from above, exit on a fixed side. | 0 |
| Double gate | Two standard gates stacked vertically. | 6 |
| Ladder gate | Three vertically stacked gates, flown like a ladder. | 9 |
| Flag gate | 2 m mast with a flag plate; counted on the marked side, at any height and distance. | 2 |
| Small flag gate | 1.2 m mast with a smaller plate; the same side rule as the large flag gate. | 1 |
| Tunnel | Octagonal tunnel around 2 m long; the exit side is marked in mirror image. | 0 |
By default, the editor generates 3 standard gates, one each of start/finish, dive, double, flag, small flag, and tunnel, plus 2 h-gates. Double-h, hurdle, and ladder default to 0.
Edit gates#
Select, drag, rotate, raise, right on the object instead of in a panel.
- 01Select: click a gate in the scene.
Shift,Cmd, orCtrlextends the selection. Clicking the ground clears it. - 02Move: hold and drag the gate in the field plane.
- 03Rotate: hold
Shiftand drag sideways. Continuous at 1° per pixel; rotation snaps in 15° steps only while grid snap is active. - 04Height: hold
Ctrl/Controland drag, 0.03 m per pixel. - 05Tools: alternatively, the selection opens tools right on the gate for moving, raising, rotating, inserting, and deleting.
- 06Insert: add new gates before or after a selected gate and choose the type. An existing start/finish gate is greyed out.
- 07Delete: via dialog or
Backspaceand confirm withEnter.
Entry and exit side
With the Pass-throughs toggle on, every opening shows a green entry face and a red exit face. The ⇄ icon flips the pass-through direction; depending on the camera position, only the side facing you is labeled.
Deactivate an opening and change the order
The ✕ at the top right switches an opening off: it turns grey and nearly transparent, loses its pass-through number, and drops out of the flight path, while the gate stays in place. The ↺ in the same spot brings it back. Clicking the pass-through number opens "Change pass-through number"; any number between 1 and the total pass-through count is allowed.
Flight path & ideal line#
A real flight line runs between the gates, not a straight connection.
Turn on Flight path in the top bar. The line between two gates consists of straights and wide arcs with a radius of at least 0.3 m; where there is room, the arc is deliberately wide, up to 2 m. There are no corners or hooks; in tight passages the line gets tighter and still stays flyable. Direction arrows drift slowly along the line in the flight direction.
- 01While no gate is selected, move the mouse over the line. A plus appears right under the pointer.
- 02Click the line to expand two icons. A second click closes them again.
- 03The gate icon opens "Insert gate": the new gate lands exactly on the line, is aligned along it, and is inserted between the two gate anchors in the order.
- 04The yellow dot icon sets a waypoint that you move freely in the field plane. Hold
Ctrl/Controlto raise or lower it.
Every change is an undo step. Waypoints travel with save, JSON export and import, gallery, and share link; the viewer shows the shaped line but not the waypoints themselves.
Autopilot#
A camera flight along the ideal line, before the first pilot starts.
The autopilot flies the ideal line in the configured pass-through order from a first-person perspective. It is available from two gates. The camera uses the same flight model as the race drones: 2 m/s base speed, faster on long straights, slower before tight corners and steep transitions, faster diving than climbing. It banks into the turns and follows the line with a small delay so the flight doesn’t feel like it’s on rails.
- As a guide, only the next opening pulses: green entry side, red exit side, and pass-through number. After each pass-through the marker moves on.
- The ground grid is hidden during the flight, even if "Show grid" is on. The field edge stays visible.
- Start with the autopilot button, stop with "Stop", a second click, or
Escape. At the end of the track the flight stops automatically and restores the editor camera. - No progress bar, no timer, no adjustable speed; the pace comes entirely from the flight model.
Flying yourself#
The same course, a real flight: radio or keyboard, HUD, timing, the built-in simulator.
Fly in the top bar opens the flight setup. It stays locked while the track has no active opening. Two start modes are available: Timed flight with a start signal and lap timing, or Free flight without a clock, laps, or results dialog.
Connect a radio
- A radio in USB joystick mode is detected as soon as you move a stick. The app shows its identifier and four live bars for roll, pitch, yaw, and throttle.
- Mapping runs in four steps, throttle, yaw, roll, pitch, and advances automatically once you push the stick to full deflection.
- Every axis can be inverted. The deadband defaults to 0.02 (range 0 to 0.2). An axis mapped twice blocks the start.
- Calibrate throttle: "Capture bottom" sets 0 %, "Capture top" sets 100 %. The mapping is stored per radio in the browser.
- Without a radio you fly with the keyboard:
W/Sthrottle,A/Dyaw, up/down arrows pitch, left/right arrows roll, in Betaflight directions.
Rates, throttle, and flight mode
- Separate roll/pitch and yaw curves, either Actual (center, max rate, expo) or Betaflight (RC rate, super rate, expo). "Stock rates 70/670/0" restores the default Actual rates.
- Throttle curve with throttle mid (default 0.5), throttle expo (default 0 = linear), and throttle limit (0.25 to 1, default 1).
- ACRO is the default and holds attitude after stick input. ANGLE limits tilt to 50° and self-levels; the last direction is kept when you release yaw.
Start signal and timing
The start signal is four short low tones and one long high tone, 5.45 seconds in total, with a large countdown from 4 to 1. Sticks and clock stay locked until the long tone. After that, the timer first measures the hole shot to the first valid pass-through of the start/finish gate (or the first gate if none exists), then three laps to the hundredth. After lap three, the results dialog shows the total time including the hole shot, the three laps, the hole shot, and the track name.
Only pass-throughs in the right order, through the right opening, and in the right direction count. Flag gates count on the marked side at any height and distance, a hurdle when you fly over its body within its width, the top part of an h-gate on the side where the window sits.
Flying, pause, reset
Ppauses the flight and the lap clock; press again to resume.Rresets the quad and the timing to the start at any time.Escapeends the flight and restores camera, zoom, and selection.- Losing focus or hiding the tab neutralizes the sticks and pauses the flight.
- No touch flight, no crash overlay; an impact does not end the flight.
Flight feel and limits
The simulation models a 35 g tinywhoop: roll and pitch reach the commanded rate in about 13 ms and stop in 17 ms, yaw takes around 17 ms, gravity is 60 %, hover is at about 17 % throttle, top speed around 58 km/h. Ground, gate frames, and hall pillars are solid but don’t end the flight: ground contact is a landing, grazes slow you down, head-on hits throw the quad back at about a third of the approach speed. The field edge is not a wall; you can fly beyond the field and as high as you like.
The HUD shows flight mode and rate profile at the top left, the timer at the top center, two stick crosses for throttle/yaw and pitch/roll at the bottom center, and "Esc to exit" at the bottom right. The ideal line is hidden during the flight, and so is the grid; the next opening pulses. Camera tilt 0 to 45° (default 30°), fullscreen on by default, sound on by default. While flying yourself, the app keeps the screen awake (wake lock), unlike the autopilot.
Design & themes#
Three looks, switchable in an instant, and they travel with the link.
| Theme | Description |
|---|---|
| Minimal Standard | For lower-powered devices: reduced detail, no shadows. |
| Realistic | Sun, shadows, and atmospheric lighting for powerful machines. |
| Night | Gates in strong, deep colors under a starry sky on a near-black, cool hall floor. |
The chosen theme is saved with the track and included when sharing. Recipients see the track in the same look; in the viewer the theme cannot be changed.
Saving & gallery#
Local, named, duplicable, and with ready-made tracks from the repository.
- Save in the toolbar or
Cmd/Ctrl+S. Give the track a name; it lands in your browser’slocalStorage. - Saved tracks are tied to this browser on this device. Clearing browser data removes them, so back up important tracks as JSON too.
- Gallery (
G) shows the name and date of every saved track. There you can load, duplicate, delete, and refresh the list. Loading replaces the current track and asks first if there are unsaved changes. - Official tracks lists the tracks from the repository folder
tracks/. The file name without.jsonis the display name; the list is sorted chronologically, newest first. Each card shows gate count and field size.
Import, export & backup#
Pass a track along, or take your complete setup with you.
JSON for one track
- Export JSON saves the currently loaded track with gates, order, configuration, and theme as a file.
- Import JSON loads a file you exported earlier or got from another pilot and replaces the current track, with a prompt if there are unsaved changes.
- Every file goes through schema validation. Invalid files are rejected and the current track stays unchanged. Older track files are normalized to the current format automatically.
Back up the complete setup
Under Settings → Backup, "Export everything" writes your complete setup to a file named fpv-track-designer-backup-YYYY-MM-DD.json: the gallery including saved tracks, course configuration, venue, pole limit, language, and all flight and radio settings (stick mapping, calibration, rates, mode, camera, sound, fullscreen).
"Import backup" restores exactly that state and replaces all local settings and the gallery; whatever the file does not contain is removed. The page then reloads so language, venue, pole limit, and flight settings take effect right away. Foreign or broken files are rejected with a visible message; individual invalid entries are skipped and counted.
Sharing & the viewer#
No account, no file attachment, just a link and a QR code.
- 01Click "Share track". The "Share track" dialog appears.
- 02The Long link field is there immediately and already works, even if the short link service does not respond.
- 03At the same time, the app tries to create a short link. While that runs, the field reads "Creating short link. The long link can already be used meanwhile." On success: "Short link created."
- 04Once a short link exists, the QR code appears, ready to download as PNG or SVG.
- 05"Copy link" copies the short link, or the long link if there is none, and then shows "Copied!".
What the recipient sees
- A pure view page with no editing features: orbit, move, and zoom as in the editor.
- Track data lives in the URL fragment (
#…) and is not sent to the viewer server when you just look at it. Depending on track size, the whole link is 333 to 459 characters long, about 93 % shorter than before. Older links keep working. - The ground grid is always hidden, the field edge stays visible. The four drones fly by default and can be hidden at the top right.
- An ideal line shaped with waypoints is visible, the waypoints themselves are not.
- Autopilot and Fly work as in the editor; the shared track stays unchanged.
- Download JSON backs up the track, "Edit in track designer" opens it directly in the editor, including field size, theme, and waypoints, and removes the data from the address afterwards.
Pole counter#
Plan material before packing the trailer.
The pole counter in the top bar shows the total number of poles needed and only appears once the track contains gates. A click opens the pole calculation with gate type, quantity, poles per gate, and total, plus a separate "Cannot be built from poles" section for hurdle, dive gate, and tunnel.
Below the table is "Max poles" (default 60). The limit lives only in your browser and travels neither into exports nor share links. If the track exceeds the limit, the badge turns red, the popover reports "Over your limit of … poles." and a one-time notice appears. It warns again only after the track has dropped below the limit in the meantime.
Mouse & touch#
Orbit, pan, zoom, with clear limits.
| Action | Control |
|---|---|
| Rotate view | Hold and drag the left mouse button |
| Move over the track (pan) | Drag the right mouse button or Space + drag the left mouse button |
| Zoom | Scroll the mouse wheel |
| Quick zoom | Drag the middle mouse button |
| Zoom limits | Distance from 2 m to 200 m |
| Tilt | The camera does not tilt below the horizon |
| Mobile devices | Two-finger drag to pan, pinch to zoom |
While the autopilot is running or you are flying yourself, the camera controls are disabled until you stop the flight.
Keyboard shortcuts#
Everything important on the keyboard.
- S
- Shuffle the track (regenerate)
- Cmd+Ctrl+S
- Save the track
- G
- Open the gallery
- Space++ Drag
- Pan the view
- Drag
- Move the gate directly
- Ctrl+Control++ Drag
- Raise or lower the gate
- Shift++ drag sideways
- Rotate the gate directly
- Cmd+Ctrl+Z
- Undo
- Cmd+Ctrl+Y
- Redo
- Backspace
- Delete the selected gate (dialog)
- Enter
- Confirm deletion
- Escape
- Deselect, close dialogs, stop the autopilot
- P
- Pause flying yourself
- R
- Reset flying yourself and the timing
- Escape
- End flying yourself, also in fullscreen
Language#
German is the default; English is one click away.
Use the language icon in the top bar to switch the app between German and English. Your choice is saved and kept for your next visit.
This website follows the same logic: German is the main language, and you can switch to English at the top right at any time, even mid-documentation. The choice is saved for your next visit.
Tips, limits & troubleshooting#
What works especially well, and where the editor deliberately stops.
Tips
- Use grid snap with a matching snap precision to build dead-straight lines: 0.3 m fine, 0.5 m medium, 1.0 m coarse.
- Turn on pass-throughs while you build the order; that way you see right away where a gate faces the wrong way.
- Press Autopilot before you share: the camera flight reveals tight spots and impossible angles faster than any top-down view.
- For race directors: set the pole limit to your actual stock; the badge warns as soon as the build is no longer buildable.
- Back up your complete setup as one file before switching browsers and import it at the destination.
Deliberate limits
- No gate sizes or custom gate types; the dimensions are fixed constants.
- Rotations do not enter the undo history and do not mark the track as changed.
- Leaving or reloading does not ask about unsaved changes.
- Lap times and leaderboards are not saved.
- No touch flight, no crash overlay; impacts do not end the flight.
- Short links need the shortener service. The long link always works.
When something won’t load
- White or black area instead of the scene: check WebGL in the browser, enable hardware acceleration, reload the page.
- Error screen "Something went wrong": press Try again. If the error persists, export the track as JSON before clearing browser storage.
- Shared link shows "Track cannot be loaded": the link is incomplete or damaged. Ask for a fresh link.
- JSON import with no visible reaction: the file was invalid; the error is in the browser console.