You are viewing a potentially older version of this package. View all versions.
Wubarrk-ThunderFeet-0.1.0 icon

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.

Date uploaded 4 days ago
Version 0.1.0
Download link Wubarrk-ThunderFeet-0.1.0.zip
Downloads 38
Dependency string Wubarrk-ThunderFeet-0.1.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2360 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2360

README

⚡ ThunderFeet

ᚦ THUNDERFEET · YOUR BOOTS READ THE GROUND VERSION · 0.1.0 CLIENT + SERVER · SERVER-LOCKED

⚡ +15% 🗺️ 31 🔒 Locked ✨ Runes
sprint on a paved road kinds of ground, each tuned the server sets the speeds rise from every footstep

Old Hrolf swore the king's road was paved for carts. His boots knew better. On cut stone they sang, on bog they sulked, and on fresh snow they sat down and refused to discuss it.

The ground under your boots matters now.

Paved road, stone floor, plank deck, meadow grass, swamp mud, deep snow — every step reads what you stand on, and that sets how fast you sprint and walk. Lay a road and it pays you back every time you run it.

A rune-icon names the ground under you, and every footstep strikes a spark of runes in its colour. The server holds the numbers, so everyone runs by the same law.


ᛞ NEW IN 0.1.0 · FIRST STEPS

ThunderFeet arrives: 31 kinds of ground, each with its own pace.

You It
sprint down a paved road the fastest ground in the land
cross a stone or wooden floor every building material has its own speed
wade into mud or snow it drags at your boots
look at your status bar a rune-icon names the ground under you
look behind you a trail of runes, coloured by the ground

🔹 Server-locked speeds · 🔹 Live edits, no restart · 🔹 Rune trail on every player


ᚾ BEFORE YOU INSTALL · READ THIS

If… Then…
🤝 you play on a server put ThunderFeet on the server too. Its speeds become the law for everyone, and players need the same version as the server.
🏰 the server does not run it your own settings apply to you alone — fine for single player, but a server owner cannot lock them.
⚖️ you run another speed mod they stack: ThunderFeet multiplies whatever speed the others give you.
🌊 you swim, ride or sail nothing changes. ThunderFeet only touches speed on foot.

ᚱ I · THE GROUND DECIDES

Every step reads the ground, and the ground sets your pace.

Underfoot It
🛣️ The paved road you laid with the hoe the fastest ground there is
🧱 Floors you built — stone, black marble, grausten, wood, iron quick, and every material has its own speed
🌿 Open country — Meadows, Black Forest, Plains as the gods made it
🥾 Mud, sand, snow and drifts drag at your boots
⛰️ Steep rock slows the climb
📖 Read the saga — why a road is not a floor, and how the land is read

The road is not the floor. A paved road is the land itself, worked with the hoe. A stone floor is a building you placed on top of it. ThunderFeet reads them in different ways, so they can never be mixed up, and each has its own speed: make the road the highway and the hall floor a stroll.

What you paint wins. A hoe path through the swamp is a dirt path, not swamp mud. A paved road up a mountain is a road, not snow. Farmland you cultivated is farmland wherever it lies.

Steep ground is rock. Unpainted slopes past the angle where Valheim starts drawing rock count as rock, whatever the biome.

Thirty-one grounds in all — every biome's floor, every building material, ship decks, boulders, logs, dungeon floors, shallow water and tar — and each one has its own sprint speed and its own walk speed.


ᚨ II · READ THE GROUND

A rune-icon in your status bar names the ground under your feet.

Icon Shows on
🛣️ Road the paved road
🪨 Stone built stone, black marble, grausten, iron, boulders, cliffs, dungeon floors
🪵 Wood wood floors, core wood, timberwood, ship decks, logs
🌿 Grass Meadows, Black Forest and Plains
🟤 Earth dirt paths, farmland, swamp mud, sand, ash, lava — and anything else
❄️ Frost snow, deep snow, ice, wading water

The exact ground is named under the icon, and the speed change is written on it: +15%, or +15% / +10% when sprinting and walking differ.


ᚲ III · RUNES UNDERFOOT

Every footstep strikes a spark of runes in the colour of the ground.

You It
walk a rune rises from each step
jog two
sprint a burst of four — a trail behind you
land a jump a ring of runes bursts outward
cross faster ground the runes burn brighter; slow ground dims them

🟡 Road gold · 🔵 Stone lightning blue · 🟠 Wood amber · 🔴 Earth ember · 🟢 Grass green · ⚪ Frost ice

📖 Read the saga — who sees them, and what they cost

Everyone sees everyone's runes. They ride on the footstep every player's game already receives, so they cost the network nothing — and you see them on the steps of players who do not even run ThunderFeet.

Standing still costs nothing. The runes only exist while someone walks near you, and fade within a second. No runes rise in water or tar.

Every rune is drawn by the mod — sixteen Elder Futhark glyphs, glowing. Turn them down to only your own, or off, or change how many rise; the server can switch them off for everyone.


ᛉ IV · THE SERVER IS LAW

The server sets the speeds. Its admins hold the keys.

The law What it means
🔒 Locked from the start only the server and the admins in its admin list can change a speed
📜 The server's numbers win everyone who joins runs on them; your own file comes back when you leave
⚡ Live edit the server's config and every player feels it within a second — no restart
🛠️ Admins tune in game change a speed in Configuration Manager and it reaches everyone at once

ᛃ THE LEDGER · DEFAULT SPEEDS

What each ground does out of the box. Each 🟩 is 5% faster, each 🟧 5% slower, ⬜ is vanilla.

Ground Icon Sprint Jog · walk
Paved road 🛣️ Road 🟩🟩🟩 +15% 🟩🟩 +10%
Stone floor 🪨 Stone 🟩🟩 +10% 🟩 +5%
Wood floor 🪵 Wood 🟩 +5% 🟩 +5%
Dirt path 🟤 Earth 🟩 +5% 🟩 +3%
Grass 🌿 Grass ⬜ ±0% ⬜ ±0%
Swamp mud 🟤 Earth 🟧🟧🟧 -15% 🟧🟧 -10%
Snow ❄️ Frost 🟧🟧 -10% 🟧 -5%
Deep snow ❄️ Frost 🟧🟧🟧🟧🟧 -25% 🟧🟧🟧🟧 -20%
📜 The whole ledger — all 31 grounds, by icon
Ground Icon Sprint Jog · walk
Paved road 🛣️ Road 🟩🟩🟩 +15% 🟩🟩 +10%
Rock slope 🪨 Stone 🟧 -5% 🟧 -3%
Stone floor 🪨 Stone 🟩🟩 +10% 🟩 +5%
Black marble 🪨 Stone 🟩🟩 +10% 🟩 +5%
Grausten 🪨 Stone 🟩🟩 +10% 🟩 +5%
Ancient structure 🪨 Stone 🟩 +5% 🟩 +5%
Iron floor 🪨 Stone 🟩 +5% 🟩 +5%
Rock 🪨 Stone 🟧 -5% 🟧 -3%
Dungeon floor 🪨 Stone ⬜ ±0% ⬜ ±0%
Wood floor 🪵 Wood 🟩 +5% 🟩 +5%
Core wood 🪵 Wood 🟩 +5% 🟩 +5%
Timberwood 🪵 Wood 🟩 +5% 🟩 +5%
Ship deck 🪵 Wood ⬜ ±0% ⬜ ±0%
Log 🪵 Wood ⬜ ±0% ⬜ ±0%
Grass 🌿 Grass ⬜ ±0% ⬜ ±0%
Forest floor 🌿 Grass 🟧 -5% 🟧 -3%
Plains grass 🌿 Grass ⬜ ±0% ⬜ ±0%
Dirt path 🟤 Earth 🟩 +5% 🟩 +3%
Cultivated soil 🟤 Earth 🟧🟧 -10% 🟧 -5%
Swamp mud 🟤 Earth 🟧🟧🟧 -15% 🟧🟧 -10%
Mistlands ground 🟤 Earth 🟧 -5% 🟧 -3%
Ashlands ground 🟤 Earth 🟧 -5% 🟧 -3%
Lava 🟤 Earth ⬜ ±0% ⬜ ±0%
Seabed 🟤 Earth 🟧🟧 -10% 🟧 -5%
Tar 🟤 Earth ⬜ ±0% ⬜ ±0%
Other ground 🟤 Earth ⬜ ±0% ⬜ ±0%
Snow ❄️ Frost 🟧🟧 -10% 🟧 -5%
Deep snow ❄️ Frost 🟧🟧🟧🟧🟧 -25% 🟧🟧🟧🟧 -20%
Ice blocks ❄️ Frost ⬜ ±0% ⬜ ±0%
Ice ❄️ Frost ⬜ ±0% ⬜ ±0%
Shallow water ❄️ Frost ⬜ ±0% ⬜ ±0%

ᚠ THE TOOLBOX · QUICK START · HOW-TO

First ten minutes: install on the server and every player → step from grass onto a paved road and watch the icon change → sprint, and look behind you → open Configuration Manager and tune a ground.

🛠️ Make the roads worth building

Raise Paved road Sprint Speed % to 130 and drop Swamp mud to 70. Players will start paving the routes they run.

🛠️ Turn the runes down

Set Rune Footsteps to OnlyMine to see only your own, or Off. Rune Intensity sets how many rise and how big (0.25 to 3). A server owner can switch them off for everyone with Rune Footsteps Allowed.

🛠️ Show the icon only when it matters

Set Show Surface Icon to OnlyWhenSpeedChanges: the icon hides on ground that leaves you at vanilla speed.

🛠️ The edges of my road do not count

Road paint fades at its edges. Lower Paint Threshold (0.5 by default) to count more of the faded edge as road.

🛠️ Which ground am I on?

Turn on Log Surface Changes and every change of ground is written to the BepInEx log with where it happened.


ᚷ MULTIPLAYER · WHO NEEDS WHAT

🌍 Works with vanilla players 🏰 Needs it on the server 🤝 Needs it on both ends
players without ThunderFeet join and move at vanilla speed — and you still see runes on their steps the server's speeds and the lock, for everyone who has the mod the speed change, the icon and the rune trail

Versions: a player whose ThunderFeet is a different version from the server's is turned away, with a message naming both.


ᛗ COMPATIBILITY · OTHER MODS

Mod How they get on
⚠️ Mods that rewrite walking itself may fight over the same step; the one that runs last wins
Speed buffs and other speed mods stack — ThunderFeet multiplies the speed they give
Configuration Manager every setting shows; synced settings lock for anyone who is not an admin
Mods that add building pieces their material decides: a modded stone floor counts as stone

ᛚ SETTINGS · CONFIGURATION MANAGER · F1

🔒 Server-synced — set on the server, locked to admins
Section Setting What it does
00 General Lock Configuration only the server and admins can change the synced settings (on)
00 General Enabled the master switch; off is vanilla speed everywhere
00 General Rock Slope Angle how steep unpainted ground must be to count as rock (35°)
00 General Paint Threshold how strongly ground must be painted to count as road, path or farmland (0.5)
00 General Rune Footsteps Allowed lets players see rune footsteps at all
01 – 31, one per ground Sprint Speed % sprint speed on that ground, in percent: 100 is vanilla, 115 is 15% faster
01 – 31, one per ground Jog Walk Speed % jog, walk and sneak speed on that ground, in percent
🖥️ Local — your own, never synced
Section Settings
00 Display (local) Show Surface Icon · Icon Shows Percent · Rune Footsteps · Rune Intensity · Log Surface Changes

ᛟ CREDITS · THANK YOU

Needs: BepInExPack for Valheim · Carries: ServerSync by blaxxun · Rune magic descends from Wings of the Valkyrie and Njord · Made by Wubarrk. · License: MIT

ᛟ The runes on this page — every banner is sealed with one
Rune Means Seals
ᚦ Thurisaz Thor's thorn, thunder the name: thunder underfoot
ᛞ Dagaz dawn, a new day what is new
ᚾ Nauthiz need, what must be what you need to know first
ᚱ Raidho the ride, the road the speeds
ᚨ Ansuz Odin's word, a message the HUD icon
ᚲ Kenaz the torch, light in the dark the rune trail
ᛉ Algiz the elk, protection the server's authority
ᛃ Jera the harvest, the year's reckoning the ledger of speeds
ᚠ Fehu cattle, wealth earned the toolbox
ᚷ Gebo the gift, give and take multiplayer
ᛗ Mannaz humankind, the folk other mods
ᛚ Laguz water, the flow the settings
ᛟ Othala the homestead, heritage the credits

CHANGELOG

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>/BepInEx runs 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 % and Jog Walk Speed % (10 to 300, 100 = vanilla) in a section per surface (01 Paved road to 31 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) and m_runSpeed (sprint) are scaled for the length of Character.UpdateWalking on 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 in plugins/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_Step emits 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) and Rune Intensity (0.25 to 3) are local; Rune Footsteps Allowed is the server's.
  • ServerSync (compiled in): every setting outside 00 Display (local) is the server's; Lock Configuration (on) limits changes to the server and adminlist.txt admins. The server's cfg is watched and re-read 0.5 s after a write. CurrentVersion = MinimumRequiredVersion = 0.1.0; ModRequired off (players without the mod may join).
  • Log Surface Changes writes each change of surface, with the position, to the BepInEx log.