ServerSync & Configuration Guide

SmarterHoe is built from the ground up to support both solo survival worlds and high-population dedicated servers.

🖥️ Dedicated Server Support

SmarterHoe uses ServerSync to guarantee that server owners maintain full control over gameplay balance.

Server Authority: When installed on a dedicated server, settings such as CostMode, maximum reach, max brush radius, and tool requirements are synchronized to joining players.
Client-Optional: Players with SmarterHoe can freely join vanilla servers. Likewise, vanilla players can join dedicated servers running SmarterHoe without issues.
Admin Exemption: Server admins listed in adminlist.txt automatically bypass locked settings and can adjust configuration in real time using the BepInEx Configuration Manager (F1).

SmarterHoe offers two gameplay cost modes via the CostMode configuration:

Terraforming costs resources realistically scaled to the actual physical volume modified:

Raise Earth: Scales with Volume (Radius² × Height). Raising a tall 4m hill costs proportionately more stone than a small 0.5m mound.
Paved Stone: Scales with the surface area paved.
Station Proximity: Requires a nearby Workbench for raising earth and a Stonecutter for paving roads.
Tool Durability & Stamina: Consumes stamina per swing; tools wear down over time. Broken tools block further terraforming.

0 Material Cost: No stone or materials are deducted from your inventory.
0 Stations: Terraform anywhere on the map without placing workbenches or stonecutters.
No Wear or Exhaustion: Stamina and durability costs are disabled.

File location: BepInEx/config/com.jubaroo.smarterhoe.cfg

Setting	Default	Synced	Description
`Lock Configuration`	`true`	Yes	Locks client configs to server authority
`CostMode`	`BalancedSurvival`	Yes	`BalancedSurvival` or `Freebuild`
`HoeReach`	`20`	Yes	Maximum hoe placement distance in meters
`MaxBrushRadius`	`20`	Yes	Maximum selectable radius for leveling & raising
`AllowBeyondGameLimit`	`true`	Yes	Removes vanilla ±8m height deformation clamp
`MaxTerrainDelta`	`50`	Yes	Maximum elevation delta from natural world-gen
`EnableUndo`	`true`	Yes	Enables multi-step terrain undo and redo
`MaxUndoSteps`	`15`	Yes	Number of undo history snapshots preserved
`InstantFlatten`	`true`	Yes	Instantly level 100% of terrain inside brush
`RequireCraftingStation`	`true`	Yes	Requires Workbench/Stonecutter in survival
`RequireToolsForDebris`	`true`	Yes	Requires Axe/Pickaxe to clear debris
`DynamicSlopeColoring`	`true`	No	Color-codes ramp guide ribbon by cart slope
`SuppressCameraZoom`	`true`	No	Prevents camera zooming while scrolling hoe controls

(Requires the -console Steam launch option)

smarterhoe_undo — Undoes the last terrain operation.
smarterhoe_redo — Redoes the last undone terrain operation.
resetterrain [radius] — Resets terrain within the specified radius back to natural world-gen (Default: 10m).
remove_forestry [radius] — Clears trees, logs, stumps, and bushes within radius.
cleardebris [radius] — Clears rocks, boulders, and obstacles within radius.