Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

KerbalFX

Lightweight modular FX framework for Kerbal Space Program.

KerbalFX is built as one core plugin with independent FX modules. Each module can be enabled or disabled separately. Optional module installs require KerbalFX Core.

Current modules

KerbalFX - Rover Dust

Wheel-ground dust for rovers and wheeled craft.

  • Dust emission based on wheel contact, speed, and slip.
  • Quality scaling from Difficulty Settings.
  • Optional surface color adaptation.
  • Optional light-aware behavior (sun + local lights).
  • Per-body tuning through config.

KerbalFX - Impact Puffs

Engine-ground interaction and touchdown effects.

  • Engine plume-ground puffs near terrain.
  • Touchdown burst on harder landings.
  • Volumetric plume-ground puffs for launch and landing. Works best with single-engine vessels.
  • Light-aware behavior and per-body tuning through config.
  • Compatible approach with Waterfall.

KerbalFX - AeroFX

Atmospheric ribbon condensation for wings, control surfaces, and fins.

  • Ribbon emitters attached to suitable wing-like parts.
  • Four emitters by default, configurable up to six per vessel.
  • Activation based on speed, density, dynamic pressure, and maneuver load.

KerbalFX - BlastFX

FX module for separators, decouplers, docking ports, and vacuum part explosions.

  • Pyro effects (sparks, smoke, chunk fragments) on supported separator parts.
  • Softer smoke-puff burst for ordinary decouplers.
  • Gas venting effect on docking-port undock. WIP
  • Lingering small debris field in space after decoupling.
  • Vacuum explosion replacement FX for eligible parts destroyed in space.
  • Size-based effects scaling.

Installation

  1. Download the latest release from Releases.
  2. Install KerbalFX Core.
  3. Install any KerbalFX modules you want to use.
  4. Copy the KerbalFX folder of selected modules into your KSP GameData.
  5. Remove older KerbalFX files before updating.

Dependencies

  • ModuleManager
  • KerbalFX Core is required for all optional KerbalFX modules.
  • KSPBurst is required for KerbalFX - AeroFX and KerbalFX - Impact Puffs.
  • Harmony2 is required for KerbalFX - BlastFX.

Configuration

Core:

  • GameData/KerbalFX/Core/KerbalFX_Core.cfg

Rover Dust:

  • GameData/KerbalFX/RoverDust/KerbalFX_RoverDust.cfg

Impact Puffs:

  • GameData/KerbalFX/ImpactPuffs/KerbalFX_ImpactPuffs.cfg

AeroFX:

  • GameData/KerbalFX/AeroFX/KerbalFX_AeroFX.cfg

BlastFX:

  • GameData/KerbalFX/BlastFX/KerbalFX_BlastFX.cfg

Difficulty Settings:

  • KerbalFX: Main
  • Rover Dust, Impact Puffs
  • KerbalFX: Extras
  • BlastFX, AeroFX

Compatibility

  • Built for KSP 1.12.5.
  • Designed with compatibility in mind to run alongside visual and terrain mods (Parallax, EVE, Waterfall, etc.)

Development status

Public beta.

KSP Forum thread

Credits

Halbann

Disclaimer and License

This mod is released under the Unlicense, which means it is in the public domain.