Atmosphere+

Atmosphere+ is a client-side Fabric visual control suite for Minecraft.

It changes what you see: weather, time, fog, lighting, particles, clouds, profiles, presets, biome-based preset automation, and a few renderer controls that work best without shader packs.

Version 0.5.0-beta.1 introduces the UI v2 redesign: a darker neon dashboard style, refreshed cards/buttons/icons, improved Theme Studio layout, and more consistent responsive behavior at high GUI scale.

Target

• Minecraft 1.21.11
• Fabric Loader 0.18.4+
• Fabric API, required
• Java 21
• Environment: client-side

Features

Visual controls

• Client-side weather visuals
• Client-side time visuals
• Fog distance and density
• Fog modes: Default / Server Fog, Custom Fog, Fog Off
• Lava/Submersion Fog Off for lava, water, and powder snow fog
• Fog Debug status for the active dimension, submersion type, and Minecraft fog modifier
• Fullbright and gamma
• Particle amount
• Low Fire first-person overlay option
• Cloud mode: Server / Off / Fast / Fancy
• Mood Overlay / Color Grade: gameplay-only tint, brightness, contrast, saturation, and vignette

Renderer controls

Known useful renderer controls:

• Cloud height
• Star brightness

Removed for stability:

• Cloud distance

Shader packs may override renderer hooks. See KNOWN_WORKING_SHADER_LIMITED.md.

Presets and profiles

• Quick menu
• Prebuilt Presets
• My Presets
• Nether Presets
• End Presets
• Preset Packs for JSON import/export
• Cinematic presets
• Safe mode presets
• Optional Biome Atmospheres automation
• Save/load profiles
• Rename profiles
• Import/export profiles

UI v2

• Premium dark dashboard-style interface with a stronger full-height sidebar, clearer search area, and footer strip
• Shared UI v2 design tokens and constraint-based layout helpers for spacing, density, grids, and preview placement
• Shared card, button, slider, toggle, section, and preview panel styling across the main UI
• Refreshed icon boxes and selected states for better scanability
• Theme Studio uses concept-inspired page tabs, a compact action strip, two-column editor cards, selected theme card, and live preview behavior tuned for both ultrawide displays and 1080p high GUI scale
• High GUI scale layouts prioritize reachable controls and compact previews instead of excessive scrolling
• Tooltips wrap into compact UI v2 popups instead of stretching across large parts of the menu

Preset Packs

• Stable JSON preset sharing from v0.4.0
• Export selected presets into shareable JSON preset packs
• Import preset packs from config/atmosphereplus-preset-packs/
• Open the Preset Packs folder directly from the Presets page
• Preview pack name, author, description, preset count, preset names, and warnings before importing
• Imported presets appear under My Presets
• Duplicate imported IDs and names are made unique automatically
• Clear import/export messages for successful exports, missing packs, invalid packs, broken JSON, unsupported versions, empty packs, and renamed duplicate preset names
• Broken or unsupported pack files are rejected safely without wiping or changing existing custom presets

To export a pack, open Presets, choose Export Preset Pack, select one or more presets, and export. Atmosphere+ writes the JSON file to:

config/atmosphereplus-preset-packs/

To import a pack, put the .json file in that folder, open Presets, choose Import Preset Pack, preview it, and import. Imported presets appear under My Presets.

Biome Atmospheres

• Client-side biome category detection
• Optional preset automation by biome
• Disabled by default
• Default mappings for plains, desert, snow, Nether, and End atmospheres
• Uses both Prebuilt Presets and My Presets
• Smooth, interruptible atmosphere transitions
• Transition speed controls: Instant, Fast, Normal, Slow
• Minimum biome dwell time to avoid rapid border switching
• Transition status feedback while automation is moving toward a preset
• Favorite presets for quick access
• EnvironmentDetector-powered surface, underground, cave, Nether, and End awareness
• Cave Handling options for pausing automation underground or applying a dedicated cave preset
• Reliable Nether and End dimension detection
• Optional Biome Atmospheres automation toasts
• Nether and End mappings apply supported fog, gamma/fullbright, particle, and renderer controls; vanilla dimensions and shader packs can still limit sky or weather visuals
• Minecraft 1.21.11 fog hooks target AtmosphericFogModifier, LavaFogModifier, WaterFogModifier, and PowderSnowFogModifier
• Context-aware preset pickers keep Nether, End, cave, and Overworld choices focused

Biome Atmospheres does not require server installation. It applies mapped presets only when the detected biome category changes.

Mood Overlay / Color Grade

• Gameplay-only overlay that skips Atmosphere+ menus and normal Minecraft screens where practical
• Adds shader-like tint, brightness, contrast, saturation, and vignette without requiring shader packs
• Included in presets, custom presets, profiles, and smooth transitions
• Strengthened Nether and End presets use color grading so dimension presets remain visually distinct even when sky/time/weather controls are limited
• Can be disabled or reset from the visual controls/search
• Vignette uses adaptive edge darkening for normal and ultrawide displays, and Vignette Strength 0 disables vignette rendering completely

This is a safe overlay fallback, not a full shader replacement. Iris shader packs may still override, cover, or visually compete with the final look.

Transition Engine

• Reusable transition system for presets and automation
• Smooth ease-in-out interpolation for numeric atmosphere values
• Interruptible transitions that continue from the current interpolated state
• Shortest-path visual time interpolation across midnight
• Built for Biome Atmospheres now and future timeline/weather automation later

Environment Detection

• Reusable EnvironmentDetector for automation systems
• Uses sky visibility, overhead enclosure, depth, and dimension context
• Helps Biome Atmospheres avoid disruptive preset changes while mining or caving

Compatibility tools

• Sodium/Iris detection
• Shader Safe Reset
• Reset Renderer
• Vanilla Safe Mode
• Sodium/Iris Safe Mode

Install

1. Install Fabric Loader for Minecraft 1.21.11.
2. Install Fabric API.
3. Put the Atmosphere+ jar in your mods folder.
4. Optional but recommended:
   • Sodium
   • Iris
   • Mod Menu
5. Start the game.
6. Open Atmosphere+ with the keybind or through Mod Menu.

Development build

Use Java 21.

.\gradlew build

For dev testing companion mods:

run/mods

For shader packs:

run/shaderpacks

Then:

.\gradlew runClient

Releases

GitHub Actions builds pushes and pull requests to master.

Recommended release flow:

1. Update version files.
2. Build/test locally.
3. Commit and push.
4. GitHub -> Actions -> Create Release.
5. Enter the version, for example 0.4.0-beta.3.
6. The workflow builds, tags, creates the GitHub release, and uploads the normal mod jar.

Manual fallback: pushing a v* tag still creates a GitHub release when the tag version matches mod_version in gradle.properties. The tag workflow checks for an existing release first to avoid duplicate releases.

See RELEASE_CHECKLIST.md for details.

Troubleshooting

Visuals look weird with shaders

Shader packs may override sky/cloud/fog/lightmap rendering. Biome Atmospheres uses the same client-side visual controls, so shader limitations still apply.

Try:

• Advanced → Reset Renderer
• Advanced → Shader Safe Reset
• Presets → Sodium/Iris Safe Mode

Clouds look wrong

Cloud distance was removed for stability. Use cloud mode and cloud height instead.

Old config acts strange

Delete:

config/atmosphereplus.json

or in a Gradle dev run:

run/config/atmosphereplus.json

License

MIT