C:\NOCTIS\OM\HANDBOOK.TXT STARDDRIFTER OPERATING HANDBOOK — EDITION 3.2.0
NOCTIS IV OM / POH
NIV-OM / POH 00 / COVER

NOCTIS IV / OPEN MOVEMENT

NOCTIS IV OM

A quiet galaxy, running natively.

Noctis IV OM is the 2000 space-exploration classic, brought forward as a native game. It pairs the feature set of Noctis IV Plus with the native C++ foundation of Noctis IV LR: a deterministic galaxy, a living ship, and no DOSBox between you and the dark.

WINDOWSLINUXWEBASSEMBLYNO ACCOUNTNO DOSBOX

GENERAL AVAILABILITY3.2.0

A ringed planet and its star seen from orbit in Noctis IV OM.
PLATE 01 ORBITAL SURVEY / RING SYSTEM 717 × 448

Independent community hybrid. Original Noctis IV by Alessandro Ghignola, 2000. Built from Noctis IV Plus and Noctis IV LR, with their contributors and licenses preserved. Credits.

THE_QUIET.TXT 01 / ORIGINS & THE LOOP

THE QUIET

No one is coming to tell you what to do.

§ 1.0

A vast, procedural galaxy, an analogue starship, and the next coordinate. You read the instruments, pick a point of light, and set out into the dark to see what awaits.

When Alessandro Ghignola released Noctis IV in 2000, he built something singular: a space simulator with billions of stars generated deterministically from pure mathematical coordinates. You awaken as a Felysian stardrifter aboard a living biological vessel, free to wander anywhere across the cosmos.

The exploration loop is contemplative, atmospheric, and quiet. Read the stellar spectral class and distance. Engage the sub-light Vimana drive across the void. Deploy the planetary capsule down into an alien atmosphere, walk across an untouched horizon, and leave an entry in the starmap for the next explorer.

Noctis IV OM revives this experience for modern hardware. It unites the expanded features of Noctis IV Plus (panoramas, Moviemaker, celestial catalogs) with the native C++20 architecture of Noctis IV LR—running seamlessly on modern desktop systems and directly in the browser.

The galaxy is computed, not stored. The same coordinate can produce the same world again.

Pure exploration. A quiet, contemplative journey where your curiosity is the only navigation marker.

  1. READ

    Star class, distance, atmosphere, gravity.

  2. CHOOSE

    Lock a target in GOESnet.

  3. CROSS

    Vimana sub-light, or a lithium jump.

  4. LAND

    Capsule down. Pick a site.

  5. RECORD

    Name the world. Leave a note.

FIRST_FLIGHT.TXT 02 / COLD START TO FELYSIA

FIRST FLIGHT

A first flight that actually works.

§ 2.0

Noctis does not put a marker on the next objective. The ship is the interface. This is the shortest reliable route from a cold launch to standing on Felysia.

  1. Walk the cabin

    WASD moves; the mouse looks. The central console is the flight computer. The right-hand bulkhead holds the GOESnet terminal and the planetary atlas. F1 brings up the in-cockpit reminder.

  2. Lock the home system

    At the GOESnet console, type HELP for the syntax if you need it, then ST BALASTRACKONASTREYA. That locks the Felysian home system as your remote target.

  3. Cross the dark

    At the central console, press 5 for flight control, then 7 to engage the Vimana drive. The distance counter is the only progress bar you get.

  4. Choose a world

    In the destination system, open the planetary list on the left terminal. Press 5, then 8 for local approach. Read gravity, pressure, and atmosphere before you commit.

  5. Land

    Press 5, then 9 for the surface capsule. In the atlas, move the landing reticle with the arrow keys and press Enter.

  6. Step outside

    WASD to walk, L for the suit torch, V to cycle the visor, Space to fire the jetpack. Walk back into the capsule to return to orbit.

If you get lost: F1 opens the in-cockpit help, Esc releases the mouse, F10 locks it again, and F11 toggles fullscreen. The full key list is in the Command & Systems Codex.

THE_INSTRUMENT.TXT 03 / ENGINE & COMPATIBILITY

UNDER THE HULL

The old game is the specification. The new engine is the work.

§ 3.0

The surface is deliberately 1990s: a 320×200 indexed framebuffer, flat-shaded polygons, a palette. Under it is a C++20 engine with fixed-tick simulation, explicit platform seams, and compatibility fixtures that decide what “finished” means.

Noctis IV has captivated nerds for decades, but keeping a DOS-era assembly and C codebase alive on modern hardware is notoriously demanding. After spending months reverse-engineering Sierra’s SCI engine, I saw the monumental porting work started by the community and asked myself two simple questions: Can I do this? and Why wouldn't I?

The original DOS executable and the LR porting baseline serve as our exact behavioral specification. Every planetary formula, star seed, and flight calculation is pinned against automated test fixtures to guarantee total historical fidelity, compiled natively to modern C++20 and WebAssembly.

Subtle, handcrafted visual enhancements—Rayleigh and Mie atmospheric scattering, day/night terminators, limb-darkened stars, procedural coronal streamers, and a physically modeled suit torch—sit cleanly atop the simulation without altering its underlying mathematical seeds.

Noctis IV OM implementation at a glance
LanguageC++20, CMake, Raylib, GLM; dependencies pinned through CPM.
SimulationFixed 55 ms ticks. Presentation advances independently.
GalaxyCoordinate-seeded. DOS-compatible PRNG. Twelve stellar classes.
Renderer8-bit indexed framebuffer, software rasterizer, Scale2x and CRT shader.
Audiominiaudio, a 4-voice generative synth, and a 6-channel mixer.
Saves401-byte native v1; legacy profile migration; atomic replacement.
TargetsLinux x86-64 (Wayland/X11), Windows x86-64, WebAssembly/WebGL2.
Tests57 CTest suites on Linux Clang/GCC and ASan/UBSan.

Determinism, precisely. Stars, systems, and surface seeds are pinned against the DOS reference. A few rasterized surface pixels still differ between compilers because of floating-point rounding; those hashes are accepted explicitly per platform and enforced in CI. Read Known issues .

SIMULATION

One tick at a time

Engine-owned state, fixed 55 ms ticks, semantic input replay, and a 401-byte native save. The simulation does not care how fast the screen is drawn.

PRESENTATION

The look is the spec

An 8-bit indexed framebuffer and software polygon renderer, scaled by crisp pixels, Scale2x, or a CRT shader. 4:3, 16:10, and 16:9 are deliberate choices.

PLATFORM

Thin seams, same core

Raylib and GLFW on the desktop; Emscripten and WebGL2 in the browser; miniaudio underneath. The procedural core is shared, not forked.

Go deeper: blueprint roadmap decisions provenance

COCKPIT_CARD.TXT 05 / QUICK REFERENCE

COCKPIT CARD

The keys before the manual.

§ 5.0

The game has no HUD tutorial. These are the keys you will use before the Codex makes sense. The full list is in the Command & Systems Codex.

A / CABIN & MOVEMENT

Move & look

WASD
Walk around the cabin
Mouse
Look and aim
F10
Release or capture the cursor
F11
Toggle fullscreen
+ −
Cabin illumination

B / SHIP COMPUTER

Guidance & drives

5
Flight-control page
R
Onboard devices
P
Preferences and audio
J
GOESnet bookmarks
X
Display off

C / PLANETFALL

Surface exploration

L
Suit torch
V
Cycle the Explorer's Visor
Space
Fire the jetpack
C
Cut jetpack steering
J
Drop a GPS waypoint
0–9
Walking-speed gears

D / DISPLAY & MEDIA

Screen & archive

F3
Moviemaker
F4
Image archive
F6
CRT shader
F7
Pixel / Scale2x / smooth upscale
F8
4:3 / 16:10 / 16:9
F9
Mute procedural audio
The Codex covers the ship, GOESnet, the surface, Moviemaker, and the audio mixer in full. Stardrifter's Codex Command reference
RELEASE_3.2.0.TXT 06 / DOWNLOAD

RELEASE

3.2.0, the Browser Moviemaker release.

§ 6.0

The current stable release. Native builds are portable and self-contained; the browser build saves to IndexedDB in this browser. No installer, no account, no DOSBox.

GENERAL AVAILABILITY

Noctis IV OM 3.2.0

Released 2026-10-06 · Browser Moviemaker & WebM

Play now

IN THIS RELEASE

  • Record a numbered BMP deck in the browser, then export it directly to WebM from the F3 panel, the projector, or GOESnet.
  • The export reads the clean deck at its native frame size; browser chrome and the capture indicator stay out of the frame.
  • F3 gains deck playback controls. Ctrl-plus and Ctrl-minus select decks instead of zooming the page while the game is focused.
  • Includes the 3.1.0 deterministic engine, save compatibility, and renderer-safety work.

Full details in the changelog and release page .

BEFORE YOU DOWNLOAD

  • Windows: 10 or 11, x86-64. The ZIP is unsigned; SmartScreen may warn.
  • Linux: x86-64, Ubuntu 24.04+ or equivalent, OpenGL, X11 or Wayland.
  • Browser: a modern browser with WebGL2. Saves are local to that browser.
  • Not yet: a native macOS build. The browser build is the current route on macOS.
Noctis IV OM 3.2.0 downloads
PlatformArtifactSizeGet it
Windows 10/11 X86-64 Noctis-IV-OM-windows-x86_64.zip 8.3 MB Download SHA-256
Linux X86-64 Noctis-IV-OM-linux-x86_64.tar.gz 3.0 MB Download SHA-256
Browser WEBGL2 play/ · ~7.6 MB runtime No install Launch
Web SELF-HOST Noctis-IV-OM-web.zip 2.3 MB Download SHA-256

Windows

Extract the ZIP anywhere writable. Run nivlr.exe. Saves, catalogs, screenshots, and movie decks stay inside the extracted folder.

Linux

Extract, then run ./nivlr. If the desktop is minimal, install the runtime libraries listed in PACKAGE_README.md .

Browser

Click Launch. Progress autosaves in IndexedDB. Use the top-bar EXPORT/IMPORT STARMAP buttons to move discoveries between browsers.

Bringing an old profile forward? Keep the old folder as a backup, then run ./nivlr --prepare-user-data --migrate-from "/path/to/old Noctis folder". The importer copies recognized saves, catalogs, screenshots, and movie decks; it never deletes the source or overwrites a destination file.

SOURCE.TXT 07 / BUILD & READ

SOURCE

Read it. Build it. Keep the behavior.

§ 7.0

The repository is the full source, tests, and porting record. The build is CMake; the dependency revisions are pinned; the first configure downloads Raylib and GLM unless they are already cached.

LINUX / QUICK START4 COMMANDS
$ cmake --preset linux-clang-debug
$ cmake --build --preset linux-clang-debug --parallel
$ ctest --preset linux-clang-debug --output-on-failure
$ cd build/linux-clang-debug && ./nivlr

Ubuntu packages, GCC, sanitizers, Windows/MSVC, MinGW cross-compilation, and packaging are in the build guide .

REPOSITORY

src/            C++20 engine and game
res/            immutable runtime resources
data/           pinned starmap and guide
docs/porting/   blueprint, roadmap, decisions
manual/         the Stardrifter's Codex
tests/          determinism and compatibility
cmake/          pinned dependencies and packaging

Contributions should preserve deterministic behavior and bring evidence. Start with the earliest incomplete roadmap item ; run at least one full native lane. See CONTRIBUTING.md .

Source and releases: the repository carries the full history, the original licenses, and the porting record.

Open the repository
QUESTIONS.TXT 08 / FREQUENTLY ASKED

QUESTIONS

The short answers.

§ 8.0
Is Noctis IV OM the original game?

It is an independent community hybrid of Noctis IV Plus and Noctis IV LR, built to faithfully recreate the original game's behavior on modern systems. Alessandro Ghignola created Noctis IV; this project preserves his full authorship and original WTOF license terms.

Do I need DOSBox or an original copy of Noctis?

No. The release archives are completely self-contained and run natively as modern C++20 or WebAssembly binaries. The original DOS executable serves as a behavioral verification reference during development, not a runtime dependency.

What does “OM” stand for?

Open Movement: the community continuation pairing Plus's rich feature set with LR's native C++ architecture, bringing the galaxy forward into the modern era.

Which platforms are supported?

Windows x86-64, Linux x86-64 with X11 or Wayland, and WebAssembly in a browser with WebGL2. There is no native macOS build yet; the browser build is the current route on macOS.

Can I bring my old saves forward?

Native builds can migrate a portable DOS/Plus profile with ./nivlr --prepare-user-data --migrate-from "/path/to/old Noctis folder". The importer never overwrites a destination file. Browser saves live in that browser's IndexedDB and are separate from desktop profiles.

Is it really deterministic?

Stars, systems, and surface seeds are pinned against the DOS reference, and the accepted per-platform results are enforced in CI. A few rasterized surface pixels can differ across compilers because of floating-point rounding; those differences are explicit, not ignored. Read known issues .

Why are the graphics so low-resolution?

The game renders at 320×200 internally, as the original did. It scales with crisp pixels, Scale2x edge-directed upscaling, or a CRT shader. The low resolution is the look, not a limitation of the port.

Is it open source?

Yes, under the original WTOF terms and the project's provenance conditions. Keep the credits and license texts with any redistribution. The provenance register records the evidence.

COLOPHON.TXT 09 / CREDITS & LICENSE

COLOPHON

The names behind the galaxy.

§ 9.0

Noctis IV was created by Alessandro Ghignola in 2000. This project preserves and honors the foundational work of Ghignola, Noctis IV Plus, Noctis IV LR, and their open-source contributors.

Noctis IV OM is an independent community continuation stewarded by Andrew Edmark, bridging the gap between retro procedural ambition and modern systems. Full licenses, contributor histories, and original provenance records are documented throughout the repository.

This page is a static field manual: no trackers, no external fonts, no CDN. Every asset is served from this repository; nothing on the page calls a third party.