Описание
# Northstar Sable Iris Horizon Bridge
**A compatibility bridge for Northstar, Iris, Complementary Shaders, Distant Horizons, Sodium, and Sable.**
Northstar Sable Iris Horizon Bridge makes planetary exploration look and behave as one connected experience. It fixes shader conflicts with Northstar skies, gives Distant Horizons a clean atmospheric exit, adds integrated configuration pages, and lets compatible Sable structures travel through Northstar's native planet-transfer boundaries.
Northstar is required. Other integrations activate only when their matching mod is installed.

## Iris and Shader Compatibility
Northstar uses its own sky layers for planets, stars, clouds, masks, and space effects. Shader packs can hide these layers, treat them as a Sun or Moon, or render them with the wrong transparency.
This bridge adds Iris-aware Northstar rendering, with dedicated support for **Complementary Shaders on Iris 1.8.x**.
- Restores Northstar planet masks and custom sky layers.
- Keeps Northstar stars visible in dimensions and times where Northstar expects them.
- Prevents large planet textures and cloud layers from being mistaken for celestial bodies.
- Respects Northstar's dimension-specific Sun and Moon rules.
- Preserves clean black space backgrounds where appropriate.
- Stops shader volumetric clouds, cloud shadows, fog, and light effects from appearing in Northstar no-cloud space dimensions.
- Applies Northstar's intended atmospheric behaviour to Mars and Venus.
- Includes shader-side handling for Venus acid rain.
BSL can benefit from the Iris-side sky compatibility, while Complementary receives the dedicated shader-source compatibility path.


## Distant Horizons Atmospheric Transition
Distant Horizons is useful near a planet's surface, but LOD terrain should not remain visible in open space.
The bridge fades Distant Horizons out as the player rises through the atmosphere instead of leaving an abrupt cutoff.
- Default fade begins at **Y=500**.
- Default fade distance is **64 blocks**, ending at Y=564.
- Both values can be changed in the configuration.
- Prevents visual remnants when moving into high altitude.
- Protects Minecraft's vanilla cloud option from being permanently switched off by Distant Horizons.

## Sable Structure Transfer
With Sable installed on the server, physical structures can cross Northstar's native transfer boundaries together with their passengers.
- A player standing on a Sable structure transfers together with that structure.
- Other entities on the structure transfer with it.
- An unattended Sable structure can transfer by itself when it crosses the Northstar transfer line.
- Structure detection uses Sable's own physical structure and standing-entity logic.
- Server transfer settings are synchronised to connected clients when the server has the bridge installed.

## Planet-Aware Sable Weather Physics
Lightweight Sable structures can react to Northstar's Martian weather.
- Mars dust storms can push light physical structures.
- Movement is mass-aware and configurable.
- Motion is reduced when a structure travels across or against the wind.
- Players standing on a moving structure can follow its movement more naturally.
- Venus is not treated as a generic wind-force dimension.

## Configuration Where You Expect It
The bridge groups related compatibility patches into understandable settings instead of exposing a confusing list of individual mixins.
- Client rendering compatibility and server gameplay patches are separated.
- Optional features disable themselves when their required mod is missing.
- Failed compatibility checks can show an error indicator and explanation.
- Shader-related changes can reload the active Iris shader pack when needed.
- When Sodium is installed, settings are available in its configuration screen.
- Settings can also be opened from the NeoForge Mods screen through the embedded configuration page.

## Dependencies
| Mod | Required? | Purpose |
|---|---:|---|
| Northstar | Yes | Planet, orbit, sky, atmosphere, and transfer integration |
| Iris | Optional | Iris-compatible sky rendering |
| Complementary Shaders | Optional | Dedicated shader compatibility |
| Distant Horizons | Optional | High-altitude LOD fade |
| Sable | Optional | Structure transfer and Mars weather physics |
| Sodium | Optional | Integrated Sodium configuration page |
## Recommended Setup
For the full experience, use:
- Minecraft 1.21.1
- NeoForge
- Northstar 0.6.4+1.21.1
- Iris 1.8.x
- Complementary Shaders
- Distant Horizons
- Sable
- Sodium
## Notes
- This is a compatibility add-on, not a standalone planet mod.
- Some shader-related settings require an Iris shader reload or a game restart.
- Install the bridge on the server to use Sable structure transfer and Sable weather physics.
- Client-side rendering compatibility can be used independently.
## Not Affiliated
Northstar Sable Iris Horizon Bridge is an independent compatibility add-on. It is not affiliated with Northstar, Sable, Iris, Sodium, Distant Horizons, Complementary Shaders, or BSL Shaders.