AntTrails

Walk somewhere often enough and the ground remembers.

AntTrails watches where players actually walk and slowly wears the terrain down into dirt paths — no hoe, no stamina, no materials. Routes that see heavy traffic over a long time have a small chance of cobbling over into stone. Routes that fall out of use fade back toward bare ground.

The result is a world that records how it has been lived in: desire lines between a base and the nearest copper vein, a worn ring around the smelter, a road to the boat that got wider the summer everyone was raiding.

Who needs to install this

Every player and the server. This writes to the shared terrain paint mask, which is persisted in the world save and replicated to every peer. Wear counters are kept by the host (or dedicated server), and clients report where they walked. A player without the mod still sees the paths, but their footsteps never count toward creating one — so on a server where only some people have it, trails form only under the players who do.

Config values that change behaviour are admin-only and pushed from the server, so everyone plays by the same numbers.

How it works

Terrain in Valheim carries a per-square-metre paint mask with separate dirt, cultivated and paved channels. The hoe slams the dirt channel to full in a 2 m circle. AntTrails instead nudges it upward a little at a time, so a path fades in rather than appearing:

Traffic on one 1×1 m tile	What you see
A few crossings	Faint scuffing, grass still there
Halfway to the threshold	Grass clears; visible bare track
Threshold reached (`StepsToPath`, default 60)	Full dirt path
Very heavy lifetime use (`StoneSteps`, default 1200)	Small per-crossing chance of stone

Crossings from all players pool together — four people walking a route wear it four times as fast.

Losing a path

Progress on an unfinished tile leaks away continuously, reaching zero after FormationWindowDays (default 4) of no traffic. A route you walk once a fortnight will never become a path; one you walk daily will.

A finished path fades far more slowly, taking RevertDays (default 30) of neglect to sink to ResidualTrace (default 0.3) — a faint permanent scar, below the threshold where grass regrows. Old routes stay legible forever unless you set ResidualTrace to 0.

Stone is terminal. It never decays. Remove it with a hoe or pickaxe like any other terrain.

What it will not touch

Cultivated soil — walking through a turnip field never paves it.
Existing stone, whether a player laid it or AntTrails did.
Inside workbench and ward range, while RespectBuildPrivilege is on (the default). Turn it off if you want trails to form through your settlement too.
Anything you are swimming through, standing on a built floor over, or Ashlands lava.

Standing still costs nothing: a tile only counts when you enter it, so idling at a workbench does not bore a hole in the ground.

Configuration

BepInEx/config/com.ragemedia.anttrails.cfg. Gameplay values are admin-only and server-synced; sampling rate and logging are local to each client.

Key	Default	Meaning
`Enabled`	`true`	Master switch. Existing terrain is left as-is when off.
`StepsToPath`	`60`	Crossings to fully wear one tile.
`FormationWindowDays`	`4`	Days of neglect to lose all unfinished progress.
`RevertDays`	`30`	Days of neglect for a finished path to fade to the floor.
`ResidualTrace`	`0.3`	Permanent floor a faded path keeps. `0` lets paths vanish.
`StoneSteps`	`1200`	Lifetime crossings before stone becomes possible.
`StoneChance`	`0.004`	Per-crossing chance of stone once eligible.
`RespectBuildPrivilege`	`true`	Skip tiles inside workbench/ward range.
`FlushIntervalSeconds`	`5`	How often paint changes are pushed to terrain.
`DecaySweepSeconds`	`60`	How often loaded tiles are re-checked for decay.
`SampleIntervalSeconds`	`0.25`	How often this client checks its own position. Local.

A note on the network

Valheim serialises a zone's entire terrain blob every time any part of it is painted, and replicates that to all peers. Painting once per footstep would be ruinous, so AntTrails accumulates changes and flushes them in batches, one message per zone per flush. Raising FlushIntervalSeconds trades responsiveness for bandwidth; lowering it does the reverse.

Wear data

Counters live in BepInEx/config/AntTrails/<worldname>.trails on the host, saved alongside the world. Deleting it resets progress but does not touch terrain — paths already painted stay painted.

Details