CinematicShaders(For Windows)

A shader mod for Kerbal Space Program 1.12 - GTAO and Starfield currently available, more planned...

Available Shaders

• GTAO (Ground-Truth Ambient Occlusion) – Horizon-based occlusion with normal-aware filtering
• Starfield Catalog - Catalog-based GPU-rendered stars. No PNG, no pixelation.

Starfield Shader

What is it?

This mod completely overhauls the stock Galaxy Camera, replacing the static skybox with a fully rendered catalog-based starfield. No textures are used to define the stars—the stars are generated mathematically and rendered in real-time using your GPU.

Star Catalogs The starfield is driven by catalogs that define each star's position, brightness, and color. You can choose from several "real star" catalogs based on actual astronomical data from the Hipparcos satellite courtesy of the ESA, or generate your own custom starfield using the procedural generation controls.

Save and share your creations easily! All catalogs are stored as .bin files in the PluginData\StarCatalogs folder and can be shared with other players.

Important Note The stars will not be visible on the Main Menu. You must load into a game (Space Center, Flight, or Tracking Station) to see the starfield.

Kartographer

What is it?

The Holographic Universal Celestial Kartographer, or H.U.C.K., is a diegetic heads-up info display that projects onto the background of space itself. Complete with info about your current situation, navigation indicators, maneuver burn info display, and target live target tracking info, H.U.C.K. can help you keep sight of what's important. With full options to enable and disable each feature individually, and an industry-first four colour options for the phosphor display, we think you'll find H.U.C.K. can be an invaluable member of your crew.

But that's not all. H.U.C.K. comes pre-loaded with a vast star catalog containing data on over three-thousand stars, allowing you to point-and click to to discover their names, distances, and more. Not just a navigation aid, H.U.C.K. is your guide to the stars. Simply enable the Kartographer, choose the visual options you want, and H.U.C.K. does the rest.

IMPORTANT NOTE

The Kartographer requires the starfield to be enabled in order to function, and you would not be able to access the star catalog data otherwise regardless.

Requirements

• KSP 1.12.x
• Deferred – Required for effects to function.

Installation

Unzip the archive into your Kerbal Space Program/ folder.

The folder structure should be: GameData/CinematicShaders/

GTAO Usage

1. Open UI: Click the wireframe sphere icon on the toolbar
2. Enable: Check "Enable Ground-Truth AO" in the GTAO tab (only functional if Deferred is installed)
3. Adjust:
4. Radius: Search distance for occluders (0.5m–10m)
5. Intensity: Shadow strength multiplier (0.0–2.0)
6. Shadow Spread: Maximum pixel radius for shadows
7. Quality: Preset controlling sample count (Low/Ultra)
8. Debug: Use the "Debug Visualization" dropdown for Raw AO or normal buffer inspection

Starfield Usage

1. Open the Cinematic Shaders UI from the toolbar button
2. Click on the Starfield tab
3. Click Enable to turn on the starfield
4. Either choose an existing catalog from the dropdown, or create a new one from scratch using the procedural generation sliders

Kartographer Usage

1. Open the Cinematic Shaders UI from the toolbar button
2. Click Enable Kartographer from the Kartographer tab
3. Choose the visualizer options you want and optionally customize their appearance
4. Starfield MUST be enabled!

Known Issues

• GTAO - There's currently an issue with the AO processing that I'll detail in a separate KnownIssues.md file. It affects the overall rendering and may be more noticeable in some scenes than others.
• Starfield - Some stars may experience some "z-fighting" which causes minor flickering/twinkling.
• Starfield - per-save settings are currently not functioning correctly, so your settings will persist across saves - this is incorrect, as the intent is to allow each save to have its own sky based on your choices.

License

All code is licensed via MIT License – See included LICENSE.txt file.

HYG Database (hyg_v42.csv) and derived real-sky catalogs (.bin files generated from this data) are licensed under CC BY-SA 4.0:

Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) Copyright (c) Astronexus (HYG Database)

You are free to: - Share: copy and redistribute the material - Adapt: remix, transform, and build upon the material Under the terms: Attribution + ShareAlike

Important: Real-sky catalogs derived from the HYG CSV (the included .bin files in GameData/CinematicShaders/PluginData/StarCatalogs/) are derivative works and inherit CC BY-SA 4.0 obligations. Procedurally generated catalogs (random seed, no HYG data) are original works and can be shared freely under any terms you choose.

Assets All navball icon assets(the sdf pngs and the svg source files in the assets\ folder) are licensed under the above MIT license terms. You are free to use, modify, copy, distribute them as you wish without attribution.

Font The DEC Rainbow 100 Font, Ac437_Rainbow100_re_66.ttf, found in the FONTS folder is licensed under CC-BY-SA-4.0 https://creativecommons.org/licenses/by-sa/4.0/ from https://int10h.org/oldschool-pc-fonts/ The Oldschool PC Font Resource.

Under CC-BY-SA-4.0 You are free to: Share — copy and redistribute the material in any medium or format for any purpose, even commercially. Adapt — remix, transform, and build upon the material for any purpose, even commercially. The licensor cannot revoke these freedoms as long as you follow the license terms. Under the following terms: Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use. ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original. No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits. Notices: You do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation.

No warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material.

Credits

• GTAO implementation based on XeGTAO
• ESA and the Hipparcos satellite for star data
• Tiffany352 and the Godot Starlight project for inspiration, PSF implementation.
• The Oldschool PC Font Resource (https://int10h.org/oldschool-pc-fonts/) for the awesome-looking DEC Rainbow-100 font.