Footprints

Footprints

Players and mobs leave fading tracks on selected surfaces. The effect is backported from modern Dynamic Surroundings and runs on the client. Adult and baby entities can have different stride lengths, foot sizes and stance widths.

Configuration guide · All categories

Entities and shape

Config category: footprints.

Entity names use registered IDs such as Cow, Creeper and Player. An empty blacklist allows all supported entities; an empty whitelist allows none. In an override such as Creeper;;0.5;, empty fields keep the defaults. Baby overrides are absolute values; otherwise the adult values are multiplied by the baby settings.

Setting	Default	Range or format	Effect
entityClassList	Blaze	List of text entries	List of mobs which are either leaving footprints, or not, depending on entityClassListIsBlacklist.
entityClassListIsBlacklist	true	true / false	Whether entityClassList is a blacklist (or a whitelist).
entityOverrides	Empty list	List of text entries	Per-entity overrides. Format: "mob_class_name;stride;foot_size;stance_width". Leave a value empty to use defaults, e.g. "Creeper;;0.5;"
footprintsEnabled	true	true / false	Whether footprint particles are enabled.
defaultStride	1.0	0.1 to 100.0	Default distance between footprints in blocks.
defaultFootSize	1.0	0.1 to 100.0	Default foot size scale multiplier for the footprint particle.
defaultStanceWidth	0.1	0.0 to 100.0	Default perpendicular offset between left and right foot in blocks.
babyStrideMultiplier	0.5	0.1 to 100.0	Multiplier applied to stride for baby mobs.
babyFootSizeMultiplier	0.5	0.1 to 100.0	Multiplier applied to foot size for baby mobs.
babyStanceWidthMultiplier	0.5	0.1 to 100.0	Multiplier applied to stance width for baby mobs.
babyEntityOverrides	Empty list	List of text entries	Per-entity baby overrides (absolute values, not multiplied). Format: "mob_class_name;stride;foot_size;stance_width". Leave a value empty to use adult value * baby multiplier.

Surfaces

Config category: footprints.

The block whitelist takes priority over the blacklist. For all other blocks, the blacklist excludes blocks and the sound-type list selects eligible surfaces. Sound types refer to the block's step sound, not its biome.

Setting	Default	Range or format	Effect
footprintSoundTypes	Default list	List of text entries	Sound types that allow footprints. Valid values: stone, wood, gravel, grass, cloth, sand, snow, ladder, anvil.
blockBlacklist	Empty list	List of text entries	Exclude these block registry names from footprints unless the same block is explicitly whitelisted. Example: minecraft:tallgrass.
blockWhitelist	Empty list	List of text entries	Blocks that should always have footprints, even if their sound type is not in the list. Use registry names, e.g. "minecraft:stone".

Default footprintSoundTypes

S:footprintSoundTypes <
    sand
    snow
    grass
    gravel
 >

Lifetime and opacity

Config category: footprints.

Lifespans use ticks: 200 ticks is 10 seconds at 20 TPS. Weather multipliers shorten or lengthen that lifetime. Block opacity overrides take priority over sound-type overrides, then the default opacity. Although the config accepts opacity above 1, the useful visual range is 0 to 1.

Setting	Default	Range or format	Effect
defaultFootprintLifespan	200	1 to 6000	Default footprint lifespan in ticks (20 ticks = 1 second).
rainLifespanMultiplier	0.4	0.0 to 100.0	Multiplier applied to footprint lifespan when raining at the footprint's position.
snowLifespanMultiplier	0.6	0.0 to 100.0	Multiplier applied to footprint lifespan when snowing at the footprint's position.
soundTypeLifespans	Default list	List of text entries	Per-sound-type lifespan overrides. Format: "sound_type;lifespan_in_ticks". e.g. "snow;100", "sand;300".
defaultFootprintOpacity	0.4	0.0 to 100.0	Default footprint opacity (0.0 = invisible, 1.0 = fully opaque).
soundTypeOpacities	Default list	List of text entries	Per-sound-type opacity overrides. Format: "sound_type;opacity". e.g. "snow;0.6", "sand;0.3".
blockOpacityOverrides	Empty list	List of text entries	Per-block opacity overrides (takes priority over sound type). Format: "registry_name;opacity". e.g. "minecraft:snow_layer;0.7".
footprintParticleCap	2000	0 to 100000	Maximum number of footprint particles tracked at once. 0 = unlimited.

Default soundTypeLifespans

S:soundTypeLifespans <
    snow;100
    sand;300
    grass;200
    gravel;250
 >

Default soundTypeOpacities

S:soundTypeOpacities <
    snow;0.6
    sand;0.5
    grass;0.4
    gravel;0.35
 >