The Command & Systems Codex

Exhaustive Triad Reference for All GOESnet Commands, Cockpit Systems, Controls & CLI Flags

21 GOESnet Commands 35 Integrated Systems 6 Native CLI Utilities Strict Triad Breakdown
The Three Standard Questions

Every entry in this codex answers three precise architectural questions: What it does (operational synopsis, flags, arguments, and visual effects), How it works (internal execution trace through C++20 routines, file descriptors, math formulas, and hardware registers), and Why it works (determinism guarantees, design safety boundaries, and engineering rationale).


📡 GOESnet Terminal Commands & Celestial Queries (21 Commands)

Commands executed via Bulkhead Screen 0 and 1 using the retro 21-column pager console, interfacing with STARMAP.BIN and GUIDE.BIN.

Command Synopsis Summary
CLRCLRClears the terminal output buffer and resets screen paging
HELPHELP [topic]Displays built-in documentation and command syntax assistance
PARPAR <object>[:range]Displays physical parameters and orbital properties of stars and planets
WHEREWHERE <object>Queries parent celestial body and system coordinates
STST <object>[:range]Sets ship navigation guidance lock on remote star or local planet
DLDL <object>[:range]Lists planetary system dependencies and notes count
CATCAT <object>[:range]Opens the celestial guide and reads explorer annotations
CASTCAST <object> <text>Appends an immutable exploration note to a celestial guide entry
REPREP <obj> <idx> <text>Replaces an existing guide record owned by the player
DELEDELE <object>[:range]Deletes an exploration note and reclaims index entries
SLSL [range]Performs a stellar proximity search and lists nearby stars
PRIPRI <object>[:range]Exports formatted celestial guide records to the host filesystem
CLEANCLEANDefragments STARMAP.BIN and erases deletion tombstones
INBOXINBOX [CHECK|CK|<file>]Imports and validates external community starmap packets (.nsm/.json)
OUTBOXOUTBOX [JSON|BIN|NSM]Exports player discoveries to shareable packet archives
GALLERYGALLERYIndexes all captured photographic reconnaissance images
VIEWVIEW [image_id]Renders and exports a specific photo gallery image
LOGLOG [EXPORT]Displays travel logbook summary or exports Markdown/JSON journals
NAMENAME <object> <label>Assigns a permanent custom designation to a star or planet
BMBM [LIST|ADD|GOTO|DEL|CLEAR]Manages personal celestial bookmarks and surface waypoints
MOVIEMOVIE [LIST|PLAY|EXPORT]Controls Moviemaker decks, playback preview, and video rendering

CLR : Clear Output Buffer

📡 GOESnet Terminal Sync Action: clear_output
SYNOPSIS: CLR
What It Does

Clears the entire text display buffer of Bulkhead Screen 1, resetting the scroll offset and returning the pager cursor to the top.

How It Works

Dispatches GoesCommand::clear. The terminal state resets its 147-cell visible window memory to spaces and returns GoesResultAction::clear_output.

Why It Works

Prevents long search results from cluttering subsequent parameter readouts, maintaining clean cockpit visibility.

HELP : Command Documentation

📡 GOESnet Terminal Sync 21-Column Pager
SYNOPSIS: HELP [topic]
What It Does

Displays an alphabetical index of all available GOESnet commands or detailed multi-line instructions for a specified topic.

How It Works

Parses optional topic argument. Formats output lines into exact 21-character rows wrapped with decorative &&&&&&&&&&&&&&&&&&&&& dividers.

Why It Works

Self-documenting terminal ensures explorers can operate ship systems without referring to external manuals during flight.

PAR : Celestial Parameters

📡 GOESnet Terminal Sync Starmap Query
SYNOPSIS: PAR <object>[:range]
What It Does

Retrieves astrophysical parameters for a named star or planet, including coordinates, mass, temperature, radius, and orbit index.

How It Works
  1. Resolves <object> against STARMAP.BIN index and active flight logs.
  2. Derives star coordinates ($x, y, z$) within specified light-year search range (default 100).
  3. Calls star_properties() or system_properties() to compute procedural astrophysics.
Why It Works

Ensures that celestial telemetry displayed on screen matches the procedural simulation physics exactly.

WHERE : Location & Parent Body

📡 GOESnet Terminal Sync Hierarchy Search
SYNOPSIS: WHERE <object>
What It Does

Locates the parent star and planetary system holding a named moon or planetary body.

How It Works

Inspects the target's StarmapRecord kind. If a planet, subtracts its orbital ordinal offset to resolve the host star ID, returning the primary star's name and galactic coordinates.

Why It Works

Prevents explorers from getting stranded when given an isolated planetary designation without stellar context.

ST : Set Navigation Target

📡 GOESnet Terminal Sync Action: set_remote_target / set_local_target
SYNOPSIS: ST <object>[:range]
What It Does

Locks the Stardrifter's autopilot and navigation HUD onto the specified celestial destination across interstellar or interplanetary space.

How It Works

Resolves coordinates and injects guidance vector into EngineState. Sets GoesResultAction::set_remote_target for stars or GoesResultAction::set_local_target with planet index.

Why It Works

Direct bridge between terminal text commands and active 3D flight HUD steering.

DL : Planetary Dependencies

📡 GOESnet Terminal Sync Index Count
SYNOPSIS: DL <object>[:range]
What It Does

Lists sub-bodies in a solar system and reports the count of recorded exploration notes attached to each planet.

How It Works

Queries GUIDE.BIN records corresponding to the object's ID, tallying total annotations and printing a planetary summary.

Why It Works

Allows explorers to assess which worlds have been heavily surveyed versus virgin untouched planets.

CAT : Read Celestial Guide

📡 GOESnet Terminal Sync Guide Reader
SYNOPSIS: CAT <object>[:range]
What It Does

Displays all recorded field notes, geological journals, and explorer logs attached to a celestial body.

How It Works

Opens GUIDE.BIN in read-only mode, extracts 147-byte text blocks matching the celestial ID, and formats them for the screen pager.

Why It Works

Delivers the core narrative magic of Noctis: reading historical journals penned by travelers across two decades.

CAST : Record Field Note

📡 GOESnet Terminal Sync Action: catalog_changed
SYNOPSIS: CAST <object> <text>
What It Does

Appends your personal field observations and notes to a named planet or star in GUIDE.BIN.

How It Works

Validates text length, constructs a new GuideRecord with timestamp and pilot ID, and appends the entry to GUIDE.BIN.

Why It Works

Every traveler leaves an indelible mark on the universe without overwriting procedural generation seeds.

REP : Replace Guide Record

📡 GOESnet Terminal Sync Action: catalog_changed
SYNOPSIS: REP <object> <record_idx> <text>
What It Does

Replaces the text of an existing exploration note previously authored by your ship.

How It Works

Verifies ownership of the record at record_idx and rewrites the payload while rejecting any attempts to modify protected records.

Why It Works

Permits typo corrections and survey updates while enforcing authorship protection.

DELE : Delete Guide Record

📡 GOESnet Terminal Sync Action: catalog_changed
SYNOPSIS: DELE <object>[:range]
What It Does

Removes an exploration note from GUIDE.BIN.

How It Works

Marks the record as inactive with a tombstone marker for compaction during subsequent CLEAN cycles.

Why It Works

Fast non-blocking deletion without risking disk corruption.

SL : Stellar Proximity Search

📡 GOESnet Terminal Sync Proximity Search
SYNOPSIS: SL [range]
What It Does

Scans the local galactic sector and lists all nearby stars within the specified light-year radius (default 100 LY).

How It Works

Iterates cubic sector coordinates surrounding the ship's current position, tests star existence via galaxy_star_at(), and formats names and distances.

Why It Works

Essential navigational radar when exploring uncharted sectors far from known trade lanes.

PRI : Export Guide Records

📡 GOESnet Terminal Sync Action: export_created
SYNOPSIS: PRI <object>[:range]
What It Does

Exports all guide entries for the target object into a clean plaintext file in your exports directory.

How It Works

Dumps guide strings to export/<object>.txt or initiates a browser file download on web builds.

Why It Works

Allows external reading, archiving, and analysis of vast planetary survey records.

CLEAN : Compact Starmap Database

📡 GOESnet Terminal Sync Action: catalog_changed
SYNOPSIS: CLEAN
What It Does

Defragments STARMAP.BIN, erases deletion tombstones, reclaims disk space, and rebuilds spatial search indexes.

How It Works

Invokes compact_starmap() in [`src/goesnet_commands.cpp`](file:///home/gordonk/.gemini/antigravity/worktrees/public-builds/write_noctis_iv_docs/src/goesnet_commands.cpp), rewriting active records atomically and reporting reclaimed bytes.

Why It Works

Ensures that long campaigns with frequent renamings never degrade catalog read performance.

INBOX : Import Starmap Packet

📡 GOESnet Terminal Sync Action: catalog_changed
SYNOPSIS: INBOX [CHECK|CK|<file>]
What It Does

Inspects, validates, and merges external community starmap packets (.nsm or .json) into your local catalog.

How It Works
  1. If CHECK is passed, performs a non-destructive dry run reporting collision counts.
  2. Verifies packet CRC32 and validates bounding limits.
  3. Applies conflict resolution: skips canonical bodies and merges non-conflicting labels atomically.
Why It Works

Enables asynchronous community cartography without central servers.

OUTBOX : Export Discoveries

📡 GOESnet Terminal Sync Action: export_created
SYNOPSIS: OUTBOX [JSON|BIN|NSM]
What It Does

Exports all custom celestial names and field notes authored on your ship into shareable packet files.

How It Works

Collects non-default records, computes CRC32 checksum, and writes data/outbox.nsm and data/outbox.json.

Why It Works

Simple one-command export for sharing starmap packets with other players.

VIEW : Render Gallery Image

📡 GOESnet Terminal Sync Action: open_image
SYNOPSIS: VIEW [image_id]
What It Does

Opens a high-resolution viewer for the specified reconnaissance photograph and exports it to your host machine.

How It Works

Loads image buffer and triggers GoesResultAction::open_image, displaying the photo in the cockpit viewer or initiating browser download.

Why It Works

Seamless review of planetary photographs from within the terminal environment.

LOG : Flight Logbook

📡 GOESnet Terminal Sync Action: export_created
SYNOPSIS: LOG [EXPORT]
What It Does

Displays an executive flight logbook summary or exports full travel chronicles to Markdown and JSON.

How It Works

Queries active_flight_log(). When called with EXPORT, writes flight_log.md and flight_log.json to disk.

Why It Works

Automated journaling ensures every historic arrival and landing is permanently memorialized.

NAME : Celestial Designation

📡 GOESnet Terminal Sync Action: catalog_changed
SYNOPSIS: NAME <object> <label>
What It Does

Assigns a permanent custom designation to an unnamed star, planet, or moon in STARMAP.BIN.

How It Works
  1. Sanitizes label text (uppercase alphanumeric [A-Z0-9 _], max 20 chars).
  2. Verifies target is not a protected canonical body (e.g. Fenia, Sol).
  3. Updates or appends a StarmapRecord atomically.
Why It Works

Gives explorers naming rights over newly charted worlds while protecting established stellar landmarks.

BM : Bookmarks & Waypoints

📡 GOESnet Terminal Sync Action: set_remote_target
SYNOPSIS: BM [LIST|ADD|GOTO|DEL|CLEAR]
What It Does

Manages personal bookmarks for star systems, orbits, and planetary surface GPS locations.

How It Works

Saves entries to bookmarks.ini. BM GOTO <id> automatically locks guidance computers onto the saved coordinates.

Why It Works

Eliminates the need to memorize 10-digit stellar coordinates when returning to favorite worlds.

MOVIE : Moviemaker Control

📡 GOESnet Terminal Sync Action: open_movie
SYNOPSIS: MOVIE [LIST|PLAY <deck>|EXPORT <deck>]
What It Does

Inspects recorded Moviemaker reels, launches in-cockpit CRT projection preview, or exports reels to video.

How It Works

Scans movies/ directory. PLAY launches the projector player; EXPORT triggers background FFmpeg encoding.

Why It Works

Brings full cinematography controls directly into the command terminal.


đŸ•šī¸ Cockpit Flight Controls & Shipboard Navigation (8 Systems)

Central Onboard Manager

đŸ•šī¸ Cockpit Flight HUD Navigation
CONTROLS: Pages: [5] [R] [P] [X] | Rows: [6] [7] [8] [9]
What It Does

Selects flight modes, navigation arrays, system preferences, or turns the glass display off.

How It Works

Selected via eye tracking or hotkeys. Row keys 6–9 execute visible commands.

Why It Works

Streamlined ergonomic control over complex shipboard avionics.

Bulkhead Screen Focus

đŸ•šī¸ Cockpit Flight Console Terminals
CONTROLS: Look & Click RMB on Wall Screens 0, 1, 2
What It Does

Switches focus to GOES input (0), output buffer (1), or planetary landing atlas (2).

How It Works

Adjusts cockpit camera orientation and transfers keyboard focus to terminal input buffers.

Why It Works

Physical spatial layout enhances immersion compared to flat 2D menus.

Flight HUD & Sliding Data Sheets

đŸ•šī¸ Cockpit FlightTelemetry Overlay
CONTROLS: Arrow Keys cycle targets | Data sheets update automatically
What It Does

Displays remote stellar targets, local planetary orbits, and environment data sheets.

How It Works

Renders vector reticles, apparent magnitude indicators, and velocity vectors directly onto window glass.

Why It Works

Crucial flight data remains in the pilot's line of sight during manual maneuvers.

Vimana Sub-Light Flight Mode

đŸ•šī¸ Cockpit FlightPropulsion
CONTROLS: Central Manager [5] -> Row [7] (Vimana)
What It Does

Accelerates the Stardrifter across planetary distances toward selected orbital bodies.

How It Works

Smoothly integrates sub-light acceleration curves, shifting cockpit star streaks and orbital distances.

Why It Works

Provides breathtaking visual transitions from deep space into planetary orbit.

Interstellar Hyperjump Drive

đŸ•šī¸ Cockpit FlightHyperspace
CONTROLS: Central Manager [5] -> Row [6] (Remote Target Jump)
What It Does

Executes an instantaneous hyperjump across light-years to a locked stellar target.

How It Works

Consumes one Lithium fuel charge, calculates target sector coordinates, and generates target star systems.

Why It Works

Instantaneous jumps make crossing an infinite procedural galaxy enjoyable and frictionless.

Cabin Illumination

đŸ•šī¸ Cockpit FlightAmbiance
CONTROLS: [+] Increase Brightness | [-] Decrease Brightness
What It Does

Adjusts cockpit lighting from pitch black to bright cabin ambiance.

How It Works

Scales ambient light shader uniforms applied to cockpit bulkhead textures.

Why It Works

Dimming cabin lights eliminates glass reflections when viewing faint stellar nebulae.

Cupola Airlock & Roof Hatch

đŸ•šī¸ Cockpit FlightEVA Observation
CONTROLS: [Up Arrow] Exit to Roof | Proximity Doors to Re-enter | [S]/[T] Roof Speed
What It Does

Exits the cabin to stand on top of the ship's exterior hull in space.

How It Works

Transitions player state to roof geometry; toggling roof speed removes presentation pacing delays.

Why It Works

Delivers an awe-inspiring, unobstructed 360-degree panorama of the cosmos.

Cockpit Quick-Jump Hotkey

đŸ•šī¸ Cockpit FlightErgonomics
CONTROLS: Press [J] in Cockpit
What It Does

Instantly centers the camera on Bulkhead Screen 1 with the bookmark command BM_ ready.

How It Works

Bypasses manual camera rotation, pre-filling the console command buffer with BM .

Why It Works

Streamlines frequent waypoint management between orbital hops.


đŸĒ Planetary Surface Mobility & EVA Systems (7 Systems)

Locomotion & Speed Gears

đŸĒ Surface EVALocomotion
CONTROLS: Mouse steering | Keys [0] through [9] (Speed gears) | LMB (Run/Swim)
What It Does

Provides variable walking speeds across terrain, running, and swimming in planetary oceans.

How It Works

Number keys set continuous forward velocity coefficients; LMB engages sprinting and buoyant swimming physics.

Why It Works

Enables effortless long-distance hiking across massive planetary landscapes.

Mouselook Mode Cycling

đŸĒ Surface EVACamera Control
CONTROLS: Press [Down Arrow] to cycle modes
What It Does

Cycles between Movement Mouse, Free Mouselook, and Inverted-Y Mouselook.

How It Works

Updates camera pitch/yaw delta handlers in [`src/input.cpp`](file:///home/gordonk/.gemini/antigravity/worktrees/public-builds/write_noctis_iv_docs/src/input.cpp); preference persists in `current.niv`.

Why It Works

Accommodates diverse player preferences and modern flight simulator conventions.

Jump & Jetpack Dynamics

đŸĒ Surface EVAMobility
CONTROLS: [J] Jump | [Space] Jetpack Thrust | [C] Release/Cutoff
What It Does

Allows leaping over obstacles and sustained jetpack flight across canyons and mountains.

How It Works

Applies vertical impulse vectors; repeated taps provide ascending thrust countered by planetary gravity.

Why It Works

Crucial for exploring rugged alien topography and ascending steep crater walls.

Explorer's Visor HUD

đŸĒ Surface EVANavigation
CONTROLS: Automatic surface overlay | [Page Up]/[Page Down] Anti-radiation visor
What It Does

Projects a 360° cardinal compass tape, digital heading, and GPS coordinates (lat, lon, elevation).

How It Works

Calculates player spherical coordinates relative to planetary radius, rendering telemetry in real time.

Why It Works

Prevents loss of orientation on boundless procedural worlds.

Lander Return Beacon (LDR)

đŸĒ Surface EVAHoming Beacon
TELEMETRY: [LDR] 8-Way Arrow & Vector Range (e.g. [^] 142M or DOCKED)
What It Does

Guides the explorer back to the landed capsule from kilometers away.

How It Works

Computes spherical surface vector between current player position and capsule touchdown site.

Why It Works

Guarantees safe returns to the ship even during violent dust storms and nighttime expeditions.

Surface GPS Waypoint Drop

đŸĒ Surface EVACartography
CONTROLS: Press [J] on Planetary Surface
What It Does

Records a persistent GPS bookmark at your exact surface coordinates.

How It Works

Appends planetary ID, latitude, longitude, and elevation into bookmarks.ini.

Why It Works

Allows marking rare geological formations, alien ruins, and scenic viewpoints for future visits.

Halogen Suit Torch

đŸĒ Surface EVALighting
CONTROLS: [L] or [F] Toggle Torch
What It Does

Projects an authentic forward spotlight beam from the helmet to illuminate dark planetary ground.

How It Works

Applies perspective inverse-square distance attenuation, 4200K halogen blackbody tint, and `tanh` highlight compression.

Why It Works

Eliminates washed-out ground textures and flat horizon glow, preserving eerie nocturnal ambiance.


📷 Photography & Reconnaissance Suite (5 Systems)

Standard Annotated Snapshot

📷 PhotographySnapshots
CONTROLS: [M] or [*] (Space & Surface)
What It Does

Captures an annotated photograph with location, star classification, and target telemetry burned onto the border.

How It Works

Renders active frame buffer and burns text overlays before saving to data/images/NNNNNNNN.BMP.

Why It Works

Preserves full astronomical context for archival scientific logs.

Raw Snapshot

📷 PhotographyClean Art
CONTROLS: [B] or [Delete] (Space & Surface)
What It Does

Captures a pristine photograph with all telemetry, reticles, and border text suppressed.

How It Works

Captures clean 3D scene buffers directly before UI composite passes.

Why It Works

Ideal for capturing wallpaper-worthy cosmic landscapes.

Panoramic 3-Frame Snapshot

📷 PhotographyWide Angle
CONTROLS: [N] or [/] (Surface Only)
What It Does

Sweeps the camera across 3 consecutive frames, capturing a wide panoramic vista with telemetry.

How It Works

Rotates view yaw in 3 calibrated arcs, rendering individual frames into temporary buffers before stitching.

Why It Works

Captures the colossal scale of planetary horizon curves and mountain chains.

Raw Panoramic Snapshot

📷 PhotographyClean Wide
CONTROLS: [V] or [.] (Surface Only)
What It Does

Captures a seamless 3-frame panoramic panorama without HUD text or telemetry.

How It Works

Combines 3 clean view passes into a unified panoramic wide-angle image file.

Why It Works

Produces stunning unobstructed landscape photographs.


đŸŽŦ Moviemaker & Production Suite (5 Systems)

Moviemaker Panel (F3)

đŸŽŦ MoviemakerCinematography
CONTROLS: [F3] Toggle Panel | [Enter] Start/Stop | [P] Pause/Resume
What It Does

Opens the in-game movie recording studio interface in space and on planetary surfaces.

How It Works

Initializes the movie_capture subsystem, displaying active deck, cadence, and frame counters.

Why It Works

Unified interface for frame-accurate game cinematography.

Deck Selection

đŸŽŦ MoviemakerReels
CONTROLS: [Ctrl] + [+] / [-] Cycle Deck 001 through 999
What It Does

Selects the target recording reel; occupied decks are protected against accidental overwriting.

How It Works

Inspects movies/DDD/ directory paths, advancing to the next available empty deck.

Why It Works

Prevents loss of previously recorded footage.

Simulation Frame Cadence

đŸŽŦ MoviemakerTiming
CONTROLS: [+] / [-] Adjust Cadence (1 to 999 frames)
What It Does

Sets how many simulation ticks elapse between each captured movie frame.

How It Works

Ties recording directly to simulation updates rather than variable rendering refresh rates.

Why It Works

Guarantees smooth time-lapse or real-time videos free of frame drops.

In-Cockpit Bulkhead CRT Projector

đŸŽŦ MoviemakerPlayback
CONTROLS: [V] or [Space] Play Deck | Left/Right Step | [L] Loop
What It Does

Projects recorded movie decks directly onto the cabin display screen for review.

How It Works

Streams sequential BMP frames with draggable timeline scrubbers and adjustable 6–60 FPS playback.

Why It Works

Allows in-universe screening of expedition recordings.

Modern Video Export (MP4 & WebM)

đŸŽŦ MoviemakerEncoding
CONTROLS: [X] Export Selected Deck
What It Does

Encodes image sequences to compressed MP4 or WebM video files with one click.

How It Works

Launches asynchronous background FFmpeg workers on desktop or canvas blob download on Web.

Why It Works

Zero external video conversion tools required.


đŸŽ›ī¸ Display & Shader Engine (6 Systems)

HUD Text Overlay

đŸŽ›ī¸ Display & ShadersOverlay
CONTROLS: [F2] -> [T] HUD Text Toggle
What It Does

Toggles cockpit instrument text and reticles on or off.

How It Works

Sets draw_hud boolean in display pipeline, suppressing HUD text rasterization passes.

Why It Works

Allows cinematic immersion when observing celestial horizons.

Visor Lens Flares

đŸŽ›ī¸ Display & ShadersOptics
CONTROLS: [F2] -> [F] Cycle Lens Flare Modes
What It Does

Cycles between Always On, Visor Only, and Always Off.

How It Works

Modulates chromatic lens flare shader passes across bright solar disks.

Why It Works

Lets players choose between cinematic flare intensity or realistic dark sky viewing.

Border Display Mode

đŸŽ›ī¸ Display & ShadersFraming
CONTROLS: [F2] -> [B] Seamless Border Toggle
What It Does

Toggles between classic framed letterbox and modern borderless viewport filling.

How It Works

Dynamically recomputes viewport aspect ratio scaling matrix in Raylib display backend.

Why It Works

Adapts cleanly to modern ultrawide and 16:9 displays.

Timewarp Multiplier

đŸŽ›ī¸ Display & ShadersSimulation Speed
CONTROLS: [F2] Menu: [ [ ] Decrease | [ ] ] Increase (1x to 16x)
What It Does

Accelerates planetary rotations and orbital movements.

How It Works

Multiplies delta simulation time ticks applied to planetary orbit calculations.

Why It Works

Allows watching solar sunsets and moon transits unfold in seconds.

Resolution & Scale2X Modes

đŸŽ›ī¸ Display & ShadersUpscaling
CONTROLS: [F2] -> [A]: [R] Internal Resolution | [U] Upscale Filters
What It Does

Selects internal rendering resolution (320x200 up to 1280x800) and Scale2X/bilinear filters.

How It Works

Allocates sized texture render targets and applies Scale2X pattern matching algorithms.

Why It Works

Maintains crisp pixel-art geometry on modern 4K monitors.

CRT & Sub-Pixel Shaders

đŸŽ›ī¸ Display & ShadersPost-Processing
CONTROLS: [F2] -> [A]: [C] CRT Shader | [G] Sub-Pixel Fidelity
What It Does

Emulates retro CRT scanlines and enables sub-pixel celestial coordinate rendering.

How It Works

Applies fragment shader scanline curves and sub-pixel float rounding in star rasterization.

Why It Works

Eliminates star shimmering while preserving genuine 1990s cathode-ray aesthetic.


🔊 Acoustics & Audio Mixer (4 Systems)

6-Channel Studio Mixer

🔊 Audio & AcousticsMixer
CONTROLS: [F2] -> [Tab] Audio Menu | Arrow Keys adjust volume (0-100%)
What It Does

Controls individual levels for Master, Music, Cabin, Propulsion, Weather, and Foley channels.

How It Works

Adjusts miniaudio sub-bus gain multipliers; values persist in audio_settings.ini.

Why It Works

Custom audio balancing for personal preference and recording streams.

Generative Audio Modes

🔊 Audio & AcousticsSynthesizer
CONTROLS: [F2] -> [Tab] -> [G] Cycle Audio Modes
What It Does

Cycles between GENERATIVE procedural synth, RECORDED music playlist, HYBRID, and OFF.

How It Works

Enables or disables procedural 4-voice audio callbacks in [`src/audio.cpp`](file:///home/gordonk/.gemini/antigravity/worktrees/public-builds/write_noctis_iv_docs/src/audio.cpp).

Why It Works

Choose between dynamic real-time synthesis and classic soundtrack albums.

Instant Mute Toggle

🔊 Audio & AcousticsHotkeys
CONTROLS: [F9] or [Ctrl] + [M]
What It Does

Instantly mutes all sound output without changing slider positions.

How It Works

Sets master output gain to 0.0 with soft anti-pop limiter ramping.

Why It Works

Convenient one-key silence when stepping away from the terminal.

Music Track Skip

🔊 Audio & AcousticsSoundtrack
CONTROLS: [N] Next Track | [P] Previous Track
What It Does

Cycles through recorded ambient soundtrack tracks in data/music/.

How It Works

Signals music_player stream to advance or rewind track file pointers.

Why It Works

Effortless control over recorded expedition music.


đŸ’ģ Command-Line Interface (CLI) Utilities (6 Utilities)

--omega-drive & --standard-drive

đŸ’ģ CLI UtilitiesEngine Flag
SYNOPSIS: ./nivlr --omega-drive | ./nivlr --standard-drive
What It Does

Equips infinite hyperjump fuel or restores conventional Lithium power (120 charges).

How It Works

Modifies the fuel state integer in current.niv safely without corrupting save bytes.

Why It Works

Eliminates hex-editing save files to experience the legendary Omega Drive.

--reset-data

đŸ’ģ CLI UtilitiesMaintenance
SYNOPSIS: ./nivlr --reset-data
What It Does

Atomically wipes all save states and logs, restoring pristine seed catalog files.

How It Works

Unlinks user save states and restores clean seed copies of STARMAP.BIN and GUIDE.BIN.

Why It Works

Safe, one-command fresh start without manually deleting user data folders.

--export-starmap

đŸ’ģ CLI UtilitiesCartography
SYNOPSIS: ./nivlr --export-starmap [PATH]
What It Does

Exports all player discoveries headlessly from the command line into an .nsm packet.

How It Works

Runs export_starmap_packet() and terminates immediately with exit code 0.

Why It Works

Automated CI starmap backups and script integration.

--import-starmap

đŸ’ģ CLI UtilitiesCartography
SYNOPSIS: ./nivlr --import-starmap <PATH>
What It Does

Imports and merges an external starmap packet headlessly without launching the game.

How It Works

Validates CRC32 checksums, applies collision resolution, and updates catalogs atomically.

Why It Works

Allows automated catalog synchronization across local network clusters.

--validate-starmap

đŸ’ģ CLI UtilitiesIntegrity
SYNOPSIS: ./nivlr --validate-starmap <PATH>
What It Does

Verifies the integrity of a starmap packet without applying modifications.

How It Works

Parses binary structures and outputs detailed reports on valid, corrupted, or colliding records.

Why It Works

Guarantees safe inspection of untrusted community packets before installation.

--export-movie

đŸ’ģ CLI UtilitiesVideo Encoding
SYNOPSIS: ./nivlr --export-movie <deck> [--export-fps 30] [--export-out path.mp4]
What It Does

Encodes a recorded Moviemaker reel to MP4 video headlessly from the terminal.

How It Works

Reads movies/DDD/ BMP files and streams them into FFmpeg libx264 encoders.

Why It Works

Batch video rendering pipelines for content creators and astronomers.