# Kraken's Kreations (KSP 1.x)

Kraken's Kreations is a visual-horror ARG mod for Kerbal Space Program 1.x. It adds distant signals, hostile creatures, strange sounds, optional debug tools, and planet-specific encounters without adding parts or vessels.

## Core encounters

- **Blackbox** — press **P** in flight to begin a 50 km pursuit. It becomes a Redbox during interplanetary encounters.
- **Kerbin Mimic** — a nighttime ground entity with Pilot, Engineer, Scientist, and Tourist variants.
- **Moho/Eve creature** — a heavy ground hunter on Moho and Eve.
- **Eve sea creature** — hunts splashed or submerged vessels in Eve's oceans.
- **Laythe Bloop** — a huge creature that hunts only in deep Laythe water.
- **Laythe land creature** — a roaming ground creature on Laythe.
- **Jool Eye** — may appear on entering Jool's SOI and becomes dangerous in Bop's SOI.

Ground entities use terrain and line-of-sight checks, remain level when you fly above them, and reroll their spawn point instead of appearing in water. Their visuals have no collider or physics body; a catch destroys the active vessel. The Blackbox instead returns to the main menu by default.

## Audio and atmosphere

- Entity-specific chase, footstep, scream, growl, and warning audio.
- Rare distant ambience at night on **Kerbin**, **Laythe**, and **Eve**.
- A small random chance for the in-game music to cut out temporarily and play a horror cue.
- Audio pauses with the game where appropriate.

## Controls and debug tools

- **P**: start or dismiss the Blackbox encounter.
- The Application Launcher toolbar button opens the Entity Tracker.
- With `debugTools = true`, situational entity spawners, radar/locator, water-fog toggle, immortality, and active-entity teleport are available.
- Every non-Blackbox debug spawner has a **200 m ahead** testing version.

## Settings

Edit `GameData/Kraken's Kreations/settings.cfg` before launching KSP. Highlights include:

- `quitOnArrival` — close KSP on Blackbox arrival instead of returning to the main menu.
- `alwaysVisible` — keep the Blackbox marker visible at long range.
- `tufxGlitchOnArrival` — enable the optional TUFX glitch moment.
- `randomEncounters`, spawn chances, cooldowns, and body lists.
- `blackboxSpeedMultiplier`, `groundEntitySpeedMultiplier`, `seaEntitySpeedMultiplier`, and `eyeSpeedMultiplier`.

`1` is the intended speed, `0.5` is half speed, and `2` is double speed.

## Installation

Copy the **Kraken's Kreations** folder into your KSP `GameData` folder so the layout is:

```text
Kerbal Space Program/
  GameData/
    Kraken's Kreations/
      Kraken's Kreations.dll
      Models/
      Sounds/
      Visuals/
      settings.cfg
```

Do not place a second `GameData` folder inside the mod folder; doing so prevents KSP from finding the DLL, models, textures, and sounds.

## Credits and license

See [CREDITS.md](CREDITS.md) for required model attribution. The source is open-source under the included license.
