Skip to content

Entity effects

jack edited this page Sep 12, 2026 · 1 revision

Entity effects

Cold breath, dripping wet entities and cake crumbs add small visual details. These effects run on the client. Breath is adapted from Dynamic Surroundings, wetness from Legendary Survival Overhaul, and cake effects from Particular.

Configuration guide · All categories

Cold breath: entities and position

Config category: breath.

Offsets are measured in blocks: the vertical offset starts at the top of the entity bounding box, and the forward distance follows its look direction. Adult and baby defaults are separate. Registered entity names such as Pig and Player are case-sensitive.

Setting Default Range or format Effect
breathEnabled true true / false Enable breath particles on entities in cold environments.
breathEntityClassList Default list List of text entries List of mobs which either show breath, or don't, depending on breathEntityClassListIsBlacklist.
breathEntityClassListIsBlacklist true true / false Whether breathEntityClassList is a blacklist (or a whitelist).
breathDefaultUpOffset -0.4 -100.0 to 100.0 Default vertical offset from top of bounding box for breath spawn point.
breathDefaultForwardDist 0.3 -100.0 to 100.0 Default forward distance along look direction for breath spawn point.
breathDefaultBabyUpOffset -0.1 -100.0 to 100.0 Default vertical offset for baby entities.
breathDefaultBabyForwardDist 0.0 -100.0 to 100.0 Default forward distance for baby entities.
breathEntityOverrides Default list List of text entries Per-entity breath position overrides. Format: "mob_name;upOffset;forwardDist". Leave a value empty to use defaults, e.g. "Pig;;0.4".
breathBabyEntityOverrides Empty list List of text entries Per-entity baby breath positions: mob_name;upOffset;forwardDist. Empty fields use breathDefaultBabyUpOffset and breathDefaultBabyForwardDist. Example: Pig;;0.4.

Default breathEntityClassList

S:breathEntityClassList <
    Chicken
    SnowMan
    Zombie
    VillagerGolem
    Skeleton
    Creeper
    Enderman
 >

Default breathEntityOverrides

S:breathEntityOverrides <
    Pig;-0.3;1.1
    Cow;-0.15;0.85
    Sheep;-0.15;0.85
    MushroomCow;-0.15;0.85
    EntityHorse;-0.3;1.2
    Wolf;-0.2;0.3
    Ozelot;-0.15;0.2
    Villager;-0.4;0.25
 >

Cold breath: climate

Config category: breath.

Dimension rules are checked first. never disables breath even in a listed cold biome or above the altitude threshold; always skips the climate checks. In normal mode, a cold-biome match, sufficient altitude, or low enough temperature allows breath. By default the Nether (-1) and End (1) use never.

Setting Default Range or format Effect
breathTemperatureThreshold 0.5 -100.0 to 100.0 Biome temperature below which breath is visible. Vanilla temps: Ice Plains 0.0, Taiga 0.25, Extreme Hills 0.2, Plains 0.8, Desert 2.0. Temperature also drops with altitude above Y=64.
breathAltitudeThreshold 130 0 to 1000 Above this Y level, breath is always visible regardless of biome temperature.
breathDimensionRules -1;never, 1;never List of text entries Per-dimension breath rules. Format: "dimensionId;mode". Modes: "normal" (temperature + altitude checks), "always" (breath always visible), "never" (breath disabled). Unlisted dimensions use breathDefaultDimensionMode.
breathDefaultDimensionMode normal normal, always, never Default breath mode for dimensions not listed in breathDimensionRules.
breathColdBiomes Empty list List of text entries Biomes that always show breath regardless of temperature. Accepts biome names and numeric biome IDs, e.g. "Extreme Hills", "FrozenRiver", "3", "158".
breathRenderDistance 64 1 to 1000 Maximum distance in blocks at which breath particles are rendered.

Wetness

Config category: wetness.

Entities become wet in water and supported non-gaseous Forge fluids, or from rain when enabled, then drip as they dry. Lava is excluded from wetness. The global fluid blacklist on Water effects also applies here. Duration controls drying time; density controls the number of drops.

Setting Default Range or format Effect
wetParticlesEnabled true true / false Enable water drip particles when entities exit water or stand in rain.
wetnessEntityClassList Empty list List of text entries List of mobs which either show wetness particles, or don't, depending on wetnessEntityClassListIsBlacklist.
wetnessEntityClassListIsBlacklist true true / false Whether wetnessEntityClassList is a blacklist (or a whitelist).
wetnessRainEnabled true true / false Whether standing in rain causes wetness buildup.
wetnessDuration 1.0 0.1 to 100.0 Multiplier for how long entities stay wet after leaving water. Higher values = longer dripping. 1.0 = default (~65 seconds from fully soaked).
wetnessParticleDensity 1.0 0.1 to 100.0 Multiplier for particle spawn frequency. Higher values = more water drops.

Cake

Config category: misc.

Taking a bite from a placed cake produces crumbs and an eating sound. This is independent of the wetness and breath toggles.

Setting Default Range or format Effect
cakeEatingParticlesEnabled true true / false Enable Particular-style eating sound and crumbs when taking a bite of cake.

Clone this wiki locally