Misaweb-SlopeSafePaving icon

SlopeSafePaving

Keep paved roads off steep terrain. Checks local terrain triangles to pave closer to cliff edges, with an adjustable slope limit and an optional wider protective margin.

By Misaweb
Last updated 16 hours ago
Total downloads 34
Total rating 0 
Categories Tweaks Client-side AI Generated
Dependency string Misaweb-SlopeSafePaving-1.0.4
Dependants 1 other package depends on this package

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

Slope Safe Paving

Pave the road without painting nearby steep terrain with cobblestones.

Slope Safe Paving filters the hoe's Paved road terrain paint. Each paint point is checked against the actual terrain triangles touching it. Ground above the configured slope limit is skipped while eligible ground within the brush is paved normally.

In-game comparison

Without Slope Safe Paving

Paved-road paint extends from the road onto the steep rock face.

Without Slope Safe Paving: cobblestone paint extends onto the steep wall

With Slope Safe Paving

The road is paved while the steep wall keeps its natural terrain texture.

With Slope Safe Paving: the road is paved and the steep wall remains unpaved

Original game screenshots from the same location, with slightly different camera angles. A narrow transition may remain because of the terrain grid and texture blending. View the screenshot album.

Features

  • Adjustable slope limit: 45 degrees by default.
  • Closer paving at edges: the default local triangle filter avoids the wide unpainted margins of version 1.0.1.
  • Optional wider protection: use a conservative margin around cliffs when preferred.
  • Lightweight local filter: seven height samples, no temporary height array per point, and one slope-limit calculation per point in the default mode.
  • Dirt paths, cultivation and grass painting keep their normal behavior.

Installation

Install with your Valheim mod manager. BepInExPack Valheim is the only dependency; Jotunn is not required.

For manual installation, install BepInExPack Valheim and copy SlopeSafePaving.dll to BepInEx/plugins/SlopeSafePaving. Start the game through BepInEx.

When updating, close the game and replace the previous DLL. Keep your existing configuration and avoid installing duplicate copies.

Configuration

After the first launch, edit BepInEx/config/cz.misaw.slopesafepaving.cfg while the game is closed:

[Paving]
Enabled = true
MaxSlopeDegrees = 45
UseWideEdgeProtection = false
EdgeProtectionCells = 1
Setting Effect
Enabled Enables or disables the paving filter.
MaxSlopeDegrees Maximum permitted terrain slope, from 0 to 89 degrees. Lower values protect gentler slopes too.
UseWideEdgeProtection false uses local triangles; true restores the wider protective filter from 1.0.1.
EdgeProtectionCells Extra grid cells checked in wide mode, from 1 to 2. Ignored in the default local mode.

When upgrading from 1.0.1, the new UseWideEdgeProtection setting defaults to false. The old EdgeProtectionCells value does not force a wide margin.

Multiplayer

Install the mod on all players and the dedicated server, with the same configuration, for consistent filtering. Terrain operations run on the owner of the affected sector, so installation only on the builder may be insufficient. Configuration is not synchronized or enforced.

Paving is saved as ordinary game terrain and remains visible without the mod.

Limitations

  • Only new paving paint is filtered. Existing cobblestone paint is not removed; repainting can fill eligible ground previously skipped by older versions.
  • The game's normal terrain leveling, stone cost and brush radius remain in effect.
  • A vertex shared by flat ground and a steep triangle can still be skipped, leaving a narrow edge. Texture blending can also soften the boundary; the mod does not replace terrain shaders or increase paint-mask resolution.
  • The hoe preview remains unchanged and does not mark skipped areas.
  • Missing required terrain samples at an unloaded neighboring sector cause the point to be skipped.
  • Other mods changing the same terrain operation may affect compatibility. If the expected patch location is not recognized, the filter stays inactive and logs an error.

Validation

Version 1.0.2 was tested in-game by the author. Version 1.0.4 retains the terrain filtering and configuration from 1.0.3, whose performance and stability changes were verified by 20,000 deterministic comparisons, 66 slope checks, additional invalid-input checks and 22 simulated patch/sampling checks. The build and patch location were checked against the author's local game libraries. These checks do not replace in-game performance profiling or a multiplayer test of the optimized versions.

This mod was developed with AI assistance.