Skip to content

Custom Features

Daniel Nylander edited this page Aug 7, 2026 · 1 revision

Custom Features

OpenCaptive includes optional enhancements beyond the original games. All are disabled by default to preserve parity. Enable individually via CLI flags, the F10 popup, or a features config file.

Visual Enhancements

HD Upscaling (--hd-upscale)

xBRZ edge-aware pixel art upscaler applied to the native framebuffer before presentation. Factor 2x-4x (--upscale-factor). Preserves the original pixel grid while smoothing diagonal edges.

Widescreen (--widescreen)

Expands the output canvas beyond the original 4:3 aspect ratio to 16:9. The verified native framebuffer remains unchanged; the additional width is filled by extending the viewport.

Scanlines (--scanlines)

Adds a horizontal scanline overlay simulating a CRT monitor's line pattern.

CRT Effect (--crt)

Applies barrel distortion simulating CRT screen curvature. Combines with scanlines.

Bilinear Filtering (--bilinear)

Smooth texture interpolation on wall surfaces instead of nearest-neighbor sampling.

Dynamic Lighting (--dynamic-lighting)

Per-pixel distance and normal-based shading. Walls and floors darken with distance from the party, and surface normals affect light intensity.

Gameplay Enhancements

Multi-Slot Quicksave (--quicksave)

10 save slots accessible via F5 (save), F6 (cycle slot), F9 (load). Slots are independent of the standard save system.

Minimap (--minimap)

Real-time overhead minimap overlay showing explored dungeon layout. Toggle with F8. Configurable size and opacity.

Automap (--automap)

Permanently reveals visited cells on the minimap. Without this, only the current view range is shown.

Mouse Look (--mouse-look)

FPS-style mouse turning with configurable sensitivity. Replaces keyboard-only rotation.

Speed Control (--speed)

Adjustable game speed from 0.25x to 4x. Use numpad +/- during gameplay.

Fast Travel (--fast-travel)

Skip traversal animations in Liberation cities. Useful for replaying missions.

Audio Enhancements

Audio Reverb (--reverb)

4-tap delay reverb applied to dungeon audio, simulating enclosed stone corridors.

HQ MIDI (--hq-midi)

Short output filter applied after OPL2 FM synthesis for cleaner MIDI audio.

Utility

Debug HUD (--debug-hud)

Displays cell type, grid position, facing direction, droid stats, and PRNG seed. Toggle with F7. Useful for development and debugging.

Replay System

Record input sequences with --replay-record and play them back with --replay-play <file>. Replay files use explicit little-endian encoding and are portable across platforms.

Cross-Save (--cross-save-export)

Portable binary save format (.ocsv) that works across macOS, Linux, and Windows. Exports are created alongside regular saves.

Config Persistence (--features-config)

Save and load feature settings from a text file. Format:

hd_upscale = true
upscale_factor = 3
dynamic_lighting = true
minimap = true

F10 Runtime Popup

Press F10 during gameplay to access live display controls:

  • Scanlines on/off
  • CRT curvature on/off
  • Bilinear filtering on/off
  • Dynamic lighting on/off
  • Original/Enhanced display toggle
  • God Mode (invulnerability)
  • Infinite Energy

God Mode and Infinite Energy work in both Captive and Liberation sessions.

Enable All

opencaptive --all-features

This enables every custom feature with default settings.

Clone this wiki locally