Thin Air: ReLived | MariesWiki

A faithful NeoForge port of fuzs's Thin Air. The air is not always breathable deep underground and in other dimensions.

The original mod is archived on Modrinth (last release: Minecraft 1.20.4). This fork brings it forward to Minecraft 1.21.1 on NeoForge while staying close to the upstream design (not a ground-up rewrite) with some features added.

⚠️ Please report bugs for this port only in this repository's issue tracker. Do not contact fuzs about issues specific to this port.

What's Different

NeoForge-only: Direct port of the 1.20.4 codebase and data, updated for NeoForge 1.21.1 APIs and datapack path changes (recipe/, advancement/, loot_table/, and so on).
Server-authoritative config: Settings live in thinair-server.toml under each world's serverconfig/ folder, with an optional in-game config screen (Mods menu) via Cloth Config.
Optional Curios: Respirator uses the Curios head slot and Safety Lantern uses the Curios belt slot when Curios is installed; the mod works without it.
Optional Create integration: Backtanks provide breathable air in yellow and red air when worn with a Diving Helmet (via Create's own equipment system, with an optional Curios back slot for the backtank itself); like Curios, none of this is required or bundled — the mod loads and works fine with neither installed.
Optional Sable integration: Air-provider blocks work on moving Sable sub-levels when Sable Companion is installed. With Create: Deep Seas, sealed compartments are green while a powered oxygen diffuser has oxygen and turn orange when the compartment has no active oxygen supply. This also covers Sable vessels in Create: Cosmonautics when they use Deep Seas life-support blocks.
Work in progress: Full parity testing is ongoing.

Features

Air quality levels: Green, yellow, orange, red, and blue air affect breathing and what equipment helps, by dimension, biome, and height.
Safety Lantern: Shows nearby air quality by color; can be dyed and scraped with an axe.
Signal Torch: Right-click to emit particles (configurable).
Respirator: Protects against choking air (Curios head slot when available).
Air Bladder / Reinforced Air Bladder: Portable air refill; reinforced variant crafted with netherite and copies durability from the ingredient bladder.
Bottle of Soulfire: Emergency air restore in the Nether.
Advancements, recipes, loot injections, drowned air-drain behavior, chunk air-quality sync, and English / Russian / Chinese lang files.

Blocks

Safety Lantern: shows nearby air quality by color; can be dyed and scraped with an axe
Signal Torch: right-click to emit particles (configurable)

Items

Respirator: protects against choking air (Curios head slot when available)
Air Bladder / Reinforced Air Bladder: portable air refill (reinforced recipe copies bladder durability)
Bottle of Soulfire: emergency air restore in the Nether

Advancements

Air Bladder: use an Air Bladder to refill your air supply on the go
Blue Air: breathe the life force given off by Soul Fire to maintain your air (but not increase it!)
Disco Lantern: use a piece of Dye to manually change the color of a Safety Lamp (you can scrape the color off with an axe)
Respirator: protect yourself from choking air with something like a Respirator
Safety Lantern — use a Safety Lantern to check the air quality around you
Signal Torch: right-click a torch to make it spew particles, perhaps to signal the exit of a cave
Soulfire Bottle: restore your lungs with the souls trapped in a Bottle of Soulfire
Water Breathing: breathe freely where there is no air at all

Known limitations

Work still in progress compared to the original 1.20.4 release:

Full parity testing (multiplayer, loot, advancements, worldgen-placed air providers) is ongoing
Sable oxygen status currently follows Create: Deep Seas sealed-compartment state and powered oxygen-diffuser tank contents; other add-ons' filtration systems and warning thresholds are not inferred.

Technical Info

Dependency	Version	Notes
NeoForge	1.21.1	Required
Java	21	Required
Curios	9.5.1+1.21.1	Optional: respirator head slot, belt lantern, Curios rendering
Create	6.0.10-280	Optional: backtank breathable air via Diving Helmet
Sable	2.0.5+	Optional: moving-sub-level air providers
Sable Companion	1.6.0+	Optional: Sable API used for moving-sub-level integration
Create: Deep Seas	2.2.4+	Optional: sealed compartment oxygen status, requires Sable
Cloth Config	15.0.140	Recommended: in-game config screen from the Mods menu; otherwise edit `serverconfig/thinair-server.toml`

Installation

Install NeoForge for Minecraft 1.21.1.
Download or build thinair-*.jar from Releases.
Drop the mod .jar into your mods/ folder.
Optionally install Curios for respirator/lantern slot support, and/or Create for backtank breathable-air support.
Launch the game.

After the first launch, change settings from the Mods menu config screen or by editing <world>/serverconfig/thinair-server.toml (air quality, signal torches, mob sensitivity, drowned choking, and air-provider bubble ranges).

The dimensions setting configures ambient air by dimension, and the biomes setting can override it for individual biomes. Both use entries of the form resource_location=default_quality,height:quality,height:quality, with height thresholds in ascending order; each quality applies at that height and above until the next threshold. For example, minecraft:the_nether=yellow and minecraft:lush_caves=green,-64:yellow,0:red. A biome override takes precedence over the dimension profile; explicit air blocks and nearby air-provider bubbles take precedence over both. By default, air effects apply to entity types in the thinair:air_quality_sensitive entity tag. Enable affectAllMobs to include all non-player living entities as well.

Credits

Role	Author
Original mod	fuzs
1.21.1 NeoForge port	Marie (kgbcupcake)

References

License

MIT — same as the original Thin Air project. Asset rights follow the upstream LICENSE-ASSETS terms where applicable.