-
Notifications
You must be signed in to change notification settings - Fork 1
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
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. |
S:breathEntityClassList <
Chicken
SnowMan
Zombie
VillagerGolem
Skeleton
Creeper
Enderman
>
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
>
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. |
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. |
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. |