# bmaju's InnerMinmus (bIM) — v1.2.0

**bmaju's InnerMinmus (bIM)** reimagines Kerbin’s moon system: Minmus becomes a larger inner moon, the Mun moves farther outward, and pale rings stretch across Kerbin’s sky.

Rather than adding new celestial bodies, bIM rearranges the familiar stock system, blending scientific plausibility with KSP’s playful absurdity. Minmus’ composition remains open to investigation—and the blue-cheese hypothesis still has enthusiastic supporters.

### Features

- Moves **Minmus** to a semi-major axis of **12,000 km**, enlarges it to a **120 km radius**, and increases its surface gravity to approximately **0.12 g**
- Keeps Minmus tidally locked to Kerbin
- Moves the **Mun** outward to a semi-major axis of approximately **46,975 km**
- Rebalances baseline science rewards for the moons’ new roles, including separate Mun values when **KH’s Better Mun** is installed
- Adds an optional **pale ring system around Kerbin**
- Includes **RingShadow**, allowing Kerbin, Mun and Minmus to cast shadows onto the rings
- Includes optional **RingGlow**, using MunGlow integration and an arc-shaped ring-light model to illuminate compatible clouds and supported surface/craft shaders
- Adds **red lunar eclipses** as Mun and Minmus pass through Kerbin’s shadow, with compatible MunGlow reflected-light colour handling
- Adds optional **Eclipse Science**, rewarding observations of eclipses caused by Kerbin and rare eclipses of Minmus caused by Mun
- Adds **23 biome-specific Minmus EVA and surface-sample reports**, exploring possible olivine, glassy fragments and surface weathering without entirely abandoning dessert speculation
- Retains the existing terrain and textures of Minmus and the Mun, allowing compatible visual overhauls to provide their appearance

### Kerbin Rings and Shadows

Kerbin’s rings extend approximately **1,628–1,973 km from its centre**. Ring shadows work in flight, map view and the tracking station, and account for the configured Sun radius—including changes made by **BetterKerbol**.

Rings are enabled by default. To disable them, open:

`GameData/bmaju's InnerMinmus/Settings.cfg`

and change `KerbinRings = True` to `KerbinRings = False`.

When enabled, bIM replaces existing Kopernicus ring definitions on Kerbin to prevent duplicate ring systems.

### RingGlow

RingGlow is included in bIM and activates only when a compatible, enabled **MunGlow** installation is present. No separate RingGlow download is required.

The illuminated rings are represented by an **arc-shaped light-source model** rather than the single representative cloud-lighting direction used in v1.1.x. Reflected ring lighting has been tested on compatible volumetric clouds.

Cloud lighting additionally requires compatible **volumetric EVE and Scatterer** installations and respects MunGlow’s cloud and per-layer settings. Follow those mods’ own dependency instructions.

Surface and craft illumination depend on their shaders. Dedicated atmosphere and ocean lighting are not included. The arc is a sampled lighting approximation; increasing sampling or the number of craft lights can increase rendering cost.

Settings are available in `RingGlowSettings.cfg` and `RingShadowsSettings.cfg` inside the mod folder. MunGlow integration was developed against **MunGlow 4.7.0.66** and may disable itself with incompatible versions.

### Red Lunar Eclipses

When **Kerbin eclipses Mun or Minmus**, sunlight passing through Kerbin’s atmosphere produces a reddish phase as the surface darkens into shadow. Fully shadowed regions become dark. The effect follows the eclipse across the visible surface, with smoothing and terrain-aware coverage.

Compatible MunGlow integration also adjusts the colour and strength of reflected moonlight during these eclipses. Its visible contribution depends on the viewing geometry, other light sources and the receiving shaders.

The red appearance is part of bIM’s eclipse rendering. `RedEclipseSettings.cfg` contains performance and sampling controls rather than an on/off switch. Visual eclipse rendering requires a compatible **EVE PlanetLight shader**.

### Eclipse Science

Observe an eclipse from **Mun or Minmus** to perform additional science experiments using familiar stock equipment:

- Crew Report and EVA Report
- 2HOT Thermometer
- Mystery Goo
- SC-9001 Science Jr.
- Surface Sample
- SENTINEL Infrared Telescope

The original experiments remain available. bIM adds dedicated eclipse experiments with their own results and science subjects. Experiments complete **instantly**, without collection timers or progress bars.

| Occulting body → observing moon | Combined maximum additional science |
| :--- | ---: |
| Kerbin → Minmus | **600** |
| Kerbin → Mun | **1,500** |
| Mun → Minmus | **4,000** |

The arrow identifies the body blocking sunlight and the moon where observations take place. **Minmus → Mun** has no dedicated Eclipse Science reward; normal science remains usable.

These totals apply at **100% Science Rewards** and combine the caps of all seven experiments. They are **not awarded anew for each eclipse**. Each experiment and eclipse configuration has a shared science budget across biomes and observation situations; repeating it cannot exceed that cap.

Eligibility uses the **observing vessel’s actual position and eclipse geometry**, including obscuration and applicable horizon checks. Different instruments require different obscuration thresholds; temperature observations and surface samples require a higher covered fraction of Kerbol. Crew Report requires a crewed vessel, while EVA Report and Surface Sample require an EVA Kerbal.

Reports, temperature observations and SENTINEL data support full-value transmission. Mystery Goo, Science Jr. and surface samples have reduced transmission efficiency; recover their data for the full reward.

Eclipse Science is **enabled by default** and can be disabled by setting `enabled = false` in `EclipseScience.cfg`. Its detection and rewards do not require the visual eclipse effect, EVE, Scatterer or MunGlow.

### Requirements

- **Kerbal Space Program 1.12.x**
- **ModuleManager**
- **Kopernicus**, including its required dependencies

Dependencies are not bundled.

**EVE, Scatterer and MunGlow are optional.** The core system changes, ring shadows and Eclipse Science do not require them. Visual lunar eclipse rendering requires EVE’s compatible PlanetLight shader; RingGlow requires MunGlow. Follow each optional mod’s dependency instructions.

### Recommended Mods and Compatibility

- **Parallax Continued:** recommended for terrain and scatter visuals. Install its stock-system assets and dependencies. Compatibility with every version or third-party configuration is not guaranteed.
- **KH’s Better Mun:** recommended for its Mun visual overhaul. bIM retains its terrain and textures while setting Mun’s orbit and applying adjusted baseline science rewards.
- **BetterKerbol:** supported by bIM’s eclipse calculations, which use the actual configured star radius.
- **OPXtras:** complements an expanded stock-system setup. bIM takes priority for its specified moon orbits and Minmus physical properties; keep overlapping moon options at their stock settings. When using BetterKerbol alongside OPXtras, set OPXtras’ **`ImprovedKerbol` to `Stock`**.

**Techo’s Planet Revamp compatibility is not included in v1.2.0.**

Other mods that alter Minmus’ orbit or physical properties, Mun’s orbit, or Kerbin’s rings may conflict. Mods that change experiment definitions or biome counts can affect baseline science balancing. Compatibility with every planet pack, science overhaul or optional configuration has not been verified.

### Installation and Updates

Close KSP and copy the included mod folder into:

`Kerbal Space Program/GameData/bmaju's InnerMinmus`

The complete package uses **one mod folder** and includes the ring features and Eclipse Science. Only the contents of **`GameData`** are needed to play. **`Source` and `Validation` are development materials and do not need to be installed.**

When updating, back up saves and custom settings, remove the previous InnerMinmus folder, then install the new one. Reapply custom settings to the new configuration files.

**Back up existing saves before installing or updating.** Initial installation changes moon orbits, size, gravity and sphere of influence, which can affect nearby vessels. v1.2.0 retains the v1.1.1 orbital, physical and baseline science settings; it does not reset previously earned science or rewrite existing science subjects.

### Localization

Minmus’ description, all **23 Minmus science reports**, and the eclipse experiment titles, part information, result summaries and **21 detailed eclipse reports** are localized in:

**English, German, Spanish, French, Italian, Japanese, Brazilian Portuguese, Russian, Simplified Chinese and Korean.**

Detailed eclipse reports follow the active game language and fall back to English if a translation is unavailable.

Korean requires a suitable Korean localization setup; it is not a standard selectable language in stock KSP 1.

### Known Limitations

- Very thin rings can be difficult to see when viewed edge-on and may appear broken at shallow viewing angles.
- Optional visual integrations depend on compatible versions of their respective mods and shaders.
- RingGlow uses a sampled arc approximation; surface and craft lighting vary with shader support.
- Existing saved science subjects may retain their stored caps. Installing an update does not recalculate them.

### License

**MIT License.** Optional dependencies are separate projects with their own licenses and installation requirements.

### Included Development Materials

The Source folder in this archive contains the EclipseScience assembly source and its build script. It does not contain the source for the separate RingShadows and ScaledEclipse assemblies. Validation contains localization checks. These folders are not required to run the mod and should remain outside GameData.
