Searica-AdvancedTerrainModifiers icon

AdvancedTerrainModifiers

Quality of life building mod that improves how terrain manipulation with the hoe and cultivator works and adds new terrain manipulation tools.

Last updated 3 months ago
Total downloads 35020
Total rating 17 
Categories Mods Tweaks Server-side Client-side Building Hildir's Request Update
Dependency string Searica-AdvancedTerrainModifiers-1.2.6
Dependants 94 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202
ValheimModding-Jotunn-2.16.2 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.16.2

README

AdvancedTerrainModifiers

Quality of life building mod that improves how terrain manipulation with the hoe and cultivator works and adds new terrain manipulation tools.

Server-Side Info: This mod does work as a client-side only mod and only needs to be installed on the server if you wish to enforce configuration settings.

Note: This is the same mod as TerrainTools by Searica. Turns out there is another mod named TerrainTools already on Thunderstore so I have changed the name for the sake of clarity and deprecated the upload that was named TerrainTools.

Features

Multiplayer Support

  • All terrain operations, including resetting terrain modifications, work in multiplayer and are synced to other players.

Quality of Life

  • Adds descriptions of how each terrain tool works for all Vanilla terrain tools.
  • All new features can be enabled/disabled from the configuration file.

Modifiable Tool Radius

  • Lets you change the radius of terrain tools using the scroll wheel.
  • Configurable hotkey to enable changing radius.
  • Configurable maximum tool radius.
  • Camera zoom is blocked while modifying tool radius.

Modifiable Tool Hardness

  • Lets you change the "hardness" of terrain tools using the scroll wheel. "Hardness" refers to how uniformly the effect is applied over the radius of the tool, so increasing the hardness will apply the effect more uniformly (see image for example of changing hardness for the Raise Ground tool).
  • Configurable hotkey to enable changing hardness.
  • Camera zoom is blocked while modifying tool hardness.

New Terrain Tool

  • Adds a craftable shovel that lets you lower terrain.

New Hoe Tools

  • Adds a version of each terrain tool that doesn't affect the terrain height when used.
  • Adds square versions of all terrain tools that modify terrain according to the world grid (so you can enjoy clean edges).
  • Adds a precision raise ground tool that lets you set the exact height you want to raise the terrain by using the scroll wheel on your mouse.
  • Adds a remove terrain modifications tool that lets you reset terrain.

New Cultivator Tools

  • Adds a version of the cultivate tool that doesn't affect the terrain height when used.
  • Adds square versions of each tools tool in the cultivator that modifies terrain according to the world grid (so you can enjoy clean edges).

Instructions

If you are using a mod manager for Thunderstore simply install the mod from there. If you are not using a mod manager then, you need a modded instance of Valheim (BepInEx) and the Jotunn plugin installed.

Configuration

Changes made to the configuration settings will be reflected in-game immediately (no restart required) and they will also sync to clients if the mod is on the server. The mod also has a built in file watcher so you can edit settings via an in-game configuration manager (changes applied upon closing the in-game configuration manager) or by changing values in the file via a text editor or mod manager.

Global Section

These settings control the global settings and how verbose the output to the log is.
Setting Server Sync Description
Verbosity No Low will log basic information about the mod. Medium will log information that is useful for troubleshooting. High will log a lot of information, do not set it to this without good reason as it will slow down your game.
  • Acceptable values: Low, Medium, High
  • Default value: Low
HoverInfo Yes Set to true/enabled to show terrain height when using square terrain tools.
  • Acceptable values: False, True
  • Default value: true

Radius Section

These settings control features related to modifying the radius of terrain tools.
Setting Server Sync Description
RadiusModifier Yes Set to true/enabled to allow modifying the radius of terrain tools using the scroll wheel. Note: Radius cannot be changed on square terraforming tools.
  • Acceptable values: False, True
  • Default value: true
RadiusModKey No Modifier key that must be held down when using scroll wheel to change the radius of terrain tools.
  • Acceptable values: KeyCode
  • Default value: LeftAlt
RadiusScrollScale No Scroll wheel change scale, larger magnitude means the radius will change faster and negative sign will reverse the direction you need to scroll to increase the radius.
  • Acceptable values: (-1, 1)
  • Default value: 0.1
MaxRadius Yes Maximum radius of terrain tools.
  • Acceptable values: (4, 20)
  • Default value: 10

Hardness Section

These settings control features related to modifying the hardness of terrain tools.
Setting Server Sync Description
HardnessModifier Yes Set to true/enabled to allow modifying the hardness of terrain tools using the scroll wheel. Note: Hardness cannot be changed on square terraforming tools and tools that do not alter ground height do not have a hardness.
  • Acceptable values: False, True
  • Default value: true
HardnessModKey No Modifier key that must be held down when using scroll wheel to change the hardness of terrain tools.
  • Acceptable values: KeyCode
  • Default value: LeftControl
HardnessScrollScale No Scroll wheel change scale, larger magnitude means the hardness will change faster and negative sign will reverse the direction you need to scroll to increase the hardness.
  • Acceptable values: (-1, 1)
  • Default value: 0.1

Shovel Section

These settings control features related to the new Shovel tool.
Setting Server Sync Description
Shovel Yes Set to true/enabled to allow crafting the shovel. Setting to false/disabled will prevent crafting new shovels but will not affect existing shovels in the world.
  • Acceptable values: False, True
  • Default value: true
ShovelToolName Yes Set to true/enabled to add this terrain tool to the shovel. Set to false/disabled to remove it.
  • Acceptable values: False, True
  • Default value: true

Hoe Section

These settings control features related to the Hoe.
Setting Server Sync Description
HoeToolName Yes Set to true/enabled to add this terrain tool to the hoe. Set to false/disabled to remove it.
  • Acceptable values: False, True
  • Default value: true

Cultivator Section

These settings control features related to the Cultivator.
Setting Server Sync Description
CultivatorToolName Yes Set to true/enabled to add this terrain tool to the cultivator. Set to false/disabled to remove it.
  • Acceptable values: False, True
  • Default value: true

Known Issues

Reseting terrain modifications on the edge of a zone when there are significant differences in terrain height can result in the terrain appearing to tear. To fix this you can hit the tear in the fabric of reality with a pickaxe, or just walk to the other zone and reset the terrain while in that zone. This isn't something I plan to fix and it's largely a product of how terrain and zones work in Valheim.

Compatibility

Should usually be compatible with everything except other mods that let you change the radius of terrain manipulation tools as they will likely conflict.

Partial Incompatibility

ValheimPlus While TerrainTools does work with ValheimPlus there are some UI glitches. ValheimPlus freezes the animations for the terrain tools so you can't visualize the effect size properly and the hover info on square tools does not update correctly. It may be possible to fix this via changing something in ValheimPlus's configuration.

FastTools While the two mods are fully compatible and you can modify the stamina cost of the Shovel using FastTools, there is currently a visual bug in FastTools that breaks the animations on the placement ghost for all terrain tools and prevents AdvancedTerrainModifiers from being able to show the change in radius. You can use ToolTweaks as a compatible alternative.

Donations/Tips

My mods will always be free to use but if you feel like saying thanks you can tip/donate.

My Ko-fi: ko-fi

Source Code

Source code is available on Github.

Github Repository: TerrainTools

Contributions

If you would like to provide suggestions, make feature requests, or reports bugs and compatibility issues you can either open an issue on the Github repository or tag me (@searica) with a message on my discord Searica's Mods.

I'm a grad student and have a lot of personal responsibilities on top of that so I can't promise I will respond quickly, but I do intend to maintain and improve the mod in my free time.

Credits

This mod was inspired by and is based on OCDHeim by javadevils as well as HoeRadius by aedenthorn.

Shameless Self Plug (Other Mods By Me)

If you like this mod you might like some of my other ones.

Building Mods

Gameplay Mods