Asphyxia (Gas API)

New Mechanics!

Gases can come from a variety of interactions with the world and can have different effects and densities

Players and some mobs now need to breathe and exhale, with some creatures being aquatic

Gases can have toxic effects on entities that breathe them

Some gases when dissolved in liquids will lower their pH, corroding armor and damaging entities at high concentrations

Gases can be explosive and flammable gases burn entities that are in them if an explosion happens

Containers in spaces with poor air quality have lower perish rates

Gases

+ Carbon Dioxide: One of the most abundant gases, it is exhaled by breathing living things, and a common product of combustion. It is heavier than air and is absorbed by plants.

+ Carbon Monoxide: While being absorbed by plants and a byproduct of combustion, it is the polar opposite of it’s cousin carbon dioxide, carbon monoxide is extremely dangerous and can cause rapid asphyxiation at concentrations as little as 10%. Its toxic effects likewise further restrict the ability to breath, plus it is near the same density as air so it evenly distributes in a space. In an enclosed, poorly ventilated space, it can kill in seconds.

+ Silica Dust: Lots of this can get in the air when breaking rock or quartz. Makes it hard to catch your breath and takes a bit of wind to get rid of.

+ Coal Dust: Lots of this gets in the air when mining coal or messing with charcoal. Makes it hard to catch your breath and it is flammable and explosive in very high concentrations. Takes a bit of wind to get rid of.

+ Hydrogen Sulfide: A heavy gas produced when mining sulfide ores, while known for its repulsive odor at small concentrations it can be extremely toxic, flammable, and explosive at high concentrations. Its toxic effects cause sluggishness, reducing movement and mining, and making it hard to deal damage in combat. Can be absorbed by plants and takes a fair amount of wind to get rid of.

+ Sulfur Dioxide: A heavy gas produced when blowing up sulfide ores or burning hydrogen sulfide, this gas is toxic and acidic and can cause armor to take greater damage and lower your health. When dissolved in water, it will lower its pH, making it corrosive to armor and can even burn creatures at high concentrations in water. Takes a lot of wind to get rid of it.

+ Nitrogen Dioxide: A heavy gas produced from explosions and mining saltpeter, this gas is toxic and acidic and can cause you to take increased damage and weakens your body’s ability to heal. When dissolved in water, it will lower its pH, making it corrosive to armor and can even burn creatures at high concentrations in water. Takes a lot of wind to get rid of it.

+ Methane: An extremely explosive and light gas, often found when mining coal, this gas is a leading cause of coal mine explosions.

Config Options

Explosions: If enabled gas explosions can occur

FlammableGas: Whether entities will burn during an explosion in the presence of flammable gas

PickaxeExplosionChance: The chance for a pickaxe strike to spark explosive gases

ContainerBonus: Whether reducing air quality will lower perish rates for containers

Smoke: Toggles smoke for burning things

Acid: Toggles acidic liquids

Exhaling: Toggles exhaling gases for breathing entities

DefaultSpreadRadius: The default distance for gas to spread up to

SpreadGasonBreakChance: The chance gas spreads when a block is broken

SpreadGasOnPlaceChance: The chance gas spreads when a block is placed

UpdateSpreadGasChance: The chance gas spreads for a block update

AllowScuba: Toggles scuba equipment

AllowMasks: Toggles mask equipment

ToxicEffects: Toggles toxic gas effects

GasesEnabled: Disables most content for that mod, can still be used by other mods though

GasesDebugEnabled: Toggles debug mode, with this mode on, see gas concentrations on block descriptions

BreathingEnabled: Whether breathing is enabled for entities other than the player

PlayerBreathingEnabled: Whether player breathing is enabled.

Library For Modders

This mod is hopefully built to be as compatible with other mods as possible. If you are interested in creating your own gas or using the system for other purposes please take a look at the README in the Github repository. It contains information for both content and code modders wanting to use this.