ThunderFeet
Your boots read the ground. Paved roads, stone and wood floors, grass, mud, snow and 31 grounds in all each set your sprint and walk speed, shown by a HUD icon and a glowing rune trail. Server-synced and admin-locked.Changelog
0.1.1
Fixes the grass that flickered to "Rock slope" while running. Same network and save behaviour as 0.1.0. Server and players must update together (ServerSync version lock: 0.1.1 on both ends).
Fixed
- Flat grass no longer flickers to Rock slope. The slope used to come from the player's ground-contact normal, which while running regularly reports a sideways normal (90°) on flat ground. Measured in game on Meadows grass: 40 grass -> Rock slope blips in 16 s of sprinting (20 reached the icon and the speed). The slope now comes from a short ray straight down onto the terrain layer: 0 changes in the same 16 s run.
Added
Surface Change Delay(00 General, server-synced, 0.35 s, 0 to 2): a new ground must be read steadily for this long before the speed and the icon switch to it. The first reading, and leaving the ground (swimming, riding, dying), still apply at once.- In-game autotest (
tools/thunderfeet-autotest/, not shipped): drives the real client and measures the speed the game computes and the speed the body moves. It also tests flicker on natural ground and detection on wood, stone and a paved road.TF_AUTOTEST_PROFILE=<Gale profile>/BepInExruns it beside a player's whole mod list.
Verified
- The speed multiplier is applied, alone and beside the 48 plugin folders of the New Dawn player profile. At 200% / 50% the body moved ×2.00 / ×0.49 on grass. With 125% on built stone it moved ×1.26 jogging and ×1.25 sprinting. The default grass value is 100% (vanilla), and the other defaults are +5–15%, so the change is small there by design.
0.1.0
First release, for Valheim 1.0.21 (network version 41) and BepInEx 5.4.23. Put it on the server and on every client.
Added
- 31 surfaces, each with its own
Sprint Speed %andJog Walk Speed %(10 to 300, 100 = vanilla) in a section per surface (01 Paved roadto31 Other).- Painted terrain (the Heightmap paint mask): Paved road, Dirt path, Cultivated soil. Paint wins over the biome.
- Natural terrain: Meadows grass, Black Forest floor, Plains grass, Swamp mud, Snow, Deep snow, Mistlands ground,
Ashlands ground, Lava, Seabed, and Rock slope (unpainted ground steeper than
Rock Slope Angle, 35°). - Built pieces, by
WearNTear.MaterialType: Wood, Core wood (HardWood), Timberwood, Stone, Black marble (Marble), Grausten (Ashstone), Ancient, Iron, Ice. - Other: Ship deck, Natural rock, Log, Ice, Dungeon floor, Shallow water, Tar, Other.
- The paved road and built stone never mix. The road is read from the terrain paint mask (blue channel); a stone floor from the piece's material. In the Deep North the green channel is deep snow, as in vanilla (0.12 = deep).
- Speed applies on foot only.
m_speed,m_walkSpeed,m_crouchSpeed(jog / walk / sneak) andm_runSpeed(sprint) are scaled for the length ofCharacter.UpdateWalkingon the local player and restored in a Harmony finalizer. Turning, swimming, flying and status-effect speed mods are untouched and multiply as before. While airborne the last ground is kept, so a jump does not lose the road's speed. - HUD status effect
SE_ThunderFeet(display only, never saved): the surface name under the icon, the change on it (+15%, or+15% / +10%). Six icons inplugins/ThunderFeet/icons/(Road, Stone, Wood, Earth, Grass, Frost); a missing PNG falls back to a vanilla icon, then a tinted disc.Show Surface Icon: Always / OnlyWhenSpeedChanges / Never.Icon Shows Percent. - Rune footsteps: a postfix on
FootStep.RPC_Stepemits runes on every client for every player's step (no new network traffic). 1 / 2 / 4 runes for walk / jog / sprint (by horizontal speed), a 10-rune ring on a Land-only step effect. Tinted by icon family, brightness by the surface's sprint multiplier. None under water level, in water or tar, or beyond 40 m from the camera. One world-space ParticleSystem (600 max), a procedural 16-rune atlas and an additive material from a built-in particle shader. A remote player's surface is read by a 1.5 m raycast under the step.Rune Footsteps(Everyone / OnlyMine / Off) andRune Intensity(0.25 to 3) are local;Rune Footsteps Allowedis the server's. - ServerSync (compiled in): every setting outside
00 Display (local)is the server's;Lock Configuration(on) limits changes to the server andadminlist.txtadmins. The server's cfg is watched and re-read 0.5 s after a write.CurrentVersion=MinimumRequiredVersion= 0.1.0;ModRequiredoff (players without the mod may join). Log Surface Changeswrites each change of surface, with the position, to the BepInEx log.
