Starship ships with a default keyboard layout that mirrors the original N64 controller and exposes a full in-game Input Editor — powered by libultraship — so every binding can be remapped to suit your playstyle without editing any files by hand.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/HarbourMasters/Starship/llms.txt
Use this file to discover all available pages before exploring further.
Default Keyboard Layout
The table below shows how each N64 button maps to the keyboard out of the box.| N64 Button | Keyboard Key |
|---|---|
| A | X |
| B | C |
| Z | Z |
| Start | Space |
| Analog stick | W A S D |
| C buttons | Arrow keys |
| D-Pad | T F G H |
The keyboard layout is a starting point. All bindings — including analog stick directions and C buttons — can be remapped freely through the Input Editor.
Keyboard Shortcuts
The following global shortcuts are active at all times, regardless of the current menu state.| Key | Action |
|---|---|
| F1 | Toggle the menu bar |
| F4 | Reset the game to boot state |
| F11 | Toggle fullscreen |
| Tab | Toggle alternate asset pack |
Controller Support
Starship uses libultraship’s SDL2-based controller input layer, which means any gamepad recognised by SDL2 — including Xbox, PlayStation, and Switch Pro controllers — works out of the box. The default SDL2 button mapping is:| N64 Button | SDL2 Gamepad Input |
|---|---|
| A | South button (A / Cross) |
| B | West button (X / Square) |
| Start | Start / Menu |
| C-Left | Right trigger (axis) |
| C-Down | Left trigger (axis) |
| C-Up | Right stick up |
| C-Right | Right stick right |
| R | Right shoulder |
| Z | Left shoulder |
| D-Pad | D-Pad (all four directions) |
Remapping Inputs with the Input Editor
The Input Editor window lets you remap every N64 button to any keyboard key, gamepad button, or analog axis.Opening the Input Editor
- Press F1 to show the menu bar.
- Navigate to Settings → Controller.
- Select Controller Mapping to open the Input Editor window.
Using the Input Editor
- Each N64 button row shows the currently bound keyboard key or controller input.
- Click the binding field for any button and press the desired key or move the desired axis to reassign it.
- Bindings are saved automatically to
starship.cfg.jsonand persist across sessions.
Controller Navigation
When Menubar Controller Navigation is enabled (gControlNav), the D-pad navigates menu bar items, A selects, and X grabs focus on the menu bar.
Invert Y Axis
The Invert Y Axis option (gInvertYAxis) can be toggled from Settings → Controller to invert the vertical axis used for vehicle control.