You are viewing a potentially older version of this package. View all versions.
Searica-AdvancedTerrainModifiers-1.3.2 icon

AdvancedTerrainModifiers

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

Date uploaded 6 months ago
Version 1.3.2
Download link Searica-AdvancedTerrainModifiers-1.3.2.zip
Downloads 7558
Dependency string Searica-AdvancedTerrainModifiers-1.3.2

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.21.3 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.21.3

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.

Ashlands Update: There are some visual glitches at the moment where the change of terrain paint (dirt, cobblestone, grass, etc.) can be slightly misalgned with the precision terrain tools (square shaped tools). This issue is related to a Vanilla issue and will be adressed as soon as possible.

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

CHANGELOG

Version Notes
1.4.0
  • Quick update to get things working with the Bog Witch update. Game breaking bugs are fixed but still need to do more testing to check for any new edge cases.
1.3.3
  • Minor bugfix for changing config while in-game. Warning should no longer be triggered and piece ordering should remain correct.
  • Updated Jotunn.
1.3.2
  • Bugfix for another issue with lava in Ashlands when using precision terrain tools.
  • I swear stuff related to lava is fixed now and if it isn't I'll have to figure out why.
1.3.1
  • Bugfix for issues with lava in Ashlands when using precision raise ground.
1.3.0
  • Updated for Ashlands release.
  • Note: Ashlands has some bugs with terrain paint (grass, dirt, etc) which cause visual errors.
  • Note: This version loads without errors but may have some issues given the bugs in Vanilla terrain right now, except fixes once Vanilla is patched.
1.2.6
  • Fixed bug where disabling specific terrain modifiers would not update correctly.
1.2.5
  • Changed how embedded textures are loaded to prevent errors on Linux systems that do not have optional dependencies for the .Net framework.
1.2.4
  • Fixed bug that could cause NRE when swapping between Hoe and Hammer pieces.
  • Updated Jotunn.
  • Minor performance improvement.
1.2.3
  • Square terrain tools now automatically snap to the world grid.
  • Bugfix for visual artifact that caused placement ghosts to persist after placement when placed on zone borders.
1.2.2
  • Change hotkeys to not be synced with server.
1.2.1
  • Minor performance optimizations.
  • Fixed bug where radius couldn't be changed under specific conditions in multiplayer.
  • Fixed bug where hardness scroll rate was being ignored.
  • Hopefully fixed bug where the reset terrain tool would sometimes not work in multiplayer if not all players had the mod.
1.2.0 Update Info
  • Changed configuration file format to handle the new tool. You need to regenerate your config file.
  • Updated README with visual examples to better explain "Hardness".
Features
  • Added a new tool that lets you lower the ground. You'll need to delve into some crypts and find some metal to make it though.
  • Changed hardness to display as a percentage and state whether the hardness is being changed for smoothing or for raising ground.
  • Updated all tool descriptions to explain how to smooth terrain instead of leveling it (this is actually a Vanilla feature but the game never tells you it exists).
Bug Fixes
  • Fixed bug where the radius of the pathen tool would not visually update even though it was changed.
  • Fixed bug where radius of raise ground would visually reset after placing it.
1.1.0
  • Added feature that to allow changing tool hardness. See README for details.
  • Icons used in the mod are now embedded in the dll
  • Changed hover info on square terrain tools to use the same x,y,z convention as unity where y = height.
  • Precision raise ground tool now displays both the change in height and the world coordinates.
  • Sharpened image in mod icon.
  • Updated README
1.0.0-1.0.2
  • Initial release.
  • Fix image links to github in README.
  • Fix manifest description.
  • Really wish Thunderstore let me edit typos without uploading a new version.