A LichtFeld Studio plugin for first-person walk-mode navigation of 3D Gaussian Splat scenes. Movement is horizontal and height-locked to a configurable floor level so you stay on the ground plane.
| Key | Action |
|---|---|
← |
Turn to left (yaw around world Y) |
→ |
Turn to right (yaw around world Y) |
↑ |
Move forward (horizontal, floor-locked) |
↓ |
Move backward (horizontal, floor-locked) |
Q |
Tilt head down (pitch) |
E |
Tilt head up (pitch) |
All bindings are active when the viewport has focus - [You will need to click your mouse cursor in the main view].
Pitch is clamped to ±80° so the camera cannot flip over.
Keys can be set in the plugin FPN_Settings.json file.
Not on the Market place yet so if you want to try it : Paste https://github.com/bgofish/LFS_FPNav_Plugin into the Plugin.Installer from within LichtFeld Studio.
If you want to use it everytime: set to [Load on Startup] (Grid view required)
- Open a scene with a loaded Gaussian splat.
- Click inside the 3D viewport to give it focus - this is important to "link to the view"
- Open the FP Nav panel (main panel tabs).
- Optionally move the camera to your desired eye height and press Set Floor to Eye Y to lock the floor at that level.
- Use
←/→to turn,↑/↓to move forwards/backwards,Q/Eto look down/up. - Press Set [Home] to bookmark a position and Goto [Home] to return.
- There are 6 other custom view slots that will have a tick beside them when set
- Both [Home] & [V1 to V6] are saved in the FPN_settings.json file so are able to be copied across projects
- The settings buttons are repeated at the bottom for convenience.
- view creation buttons can be locked to avoid accidental overwriting
- numpad views - can be 'automatically' or manually set (Auto currently only works for models with a 0,0,0 centroid).
All settings are adjusted live in the FP Nav panel and saved manually
to FPN_settings.json in the plugin folder:
Important - there is a current BUG that the settings are being ignored on load so press: Settings [Load] to load your settings !
| Setting | Default | Description |
|---|---|---|
| Movement step | 0.25 m |
World units moved per forward/backward key press |
| Turn step | 5.0° |
Degrees rotated per left/right key press |
| Tilt step | 3.0° |
Degrees pitched per Q/E key press |
| Floor Y | 0.0 |
Camera Y is clamped to this value during movement |
| Key bindings | see above | Customisable if needed (Stored as GLFW key codes) |
<plugin_folder>/fp_navigation/FPN_settings.json
MIT — free to use, modify, and redistribute.