Groundwork

Pollination boosts honey and plant growth, rain speeds plant growth, hoe/cultivator ranges scale with grid views, pickaxes get scalable digging, scythes harvest all crops, and Farming skill scales mass planting, plant growth, and beehive capacity.

Configurable terrain tool scaling with radius and cost. Larger terrain ranges can require proportionally more materials, stamina, and durability, making expanded tools powerful but balanced.

Hoe and Cultivator terrain range scaling with precision grid preview. Adjust tool radius with the wheel modifier, preview affected terrain cells, and see range/cost feedback before placing.

Scalable pickaxe terrain digging. Increase radius and depth per pickaxe, with stamina and durability costs scaling from the selected dig size.

Scythe harvesting for all supported crops. Sweep through planted fields and harvest mature crops in a wide arc.

Beehive upgrades and hover details. Farming-scaled honey capacity, cover, pollination, night/rain modifiers, total honey rate, and next honey timing are shown at a glance.

Rain and pollination plant growth info. Hover text shows active Farming, pollination, and rain multipliers alongside the remaining growth time.

Farming-scaled mass planting, grid planting, and foraging pollination. Plant in clean grids, scale planting count by Farming level, and let beehives boost nearby foraging respawn when conditions are right.

Features

Farming and Planting

• Grid planting is always available while placing crops.
• Mass planting scales with Farming level:
  • 0-19: Off
  • 20-39: 5 plants
  • 40-59: 10 plants
  • 60-79: 15 plants
  • 80-99: 20 plants
  • 100: 25 plants
• Hold the tool wheel modifier hotkey and use the mouse wheel to change mass-plant count.
• Turn off Mass Planting Enabled to disable only multi-plant placement; grid planting stays available.
• Planted crops can grow faster based on the planter's Farming skill.
• Mass planting can grant extra Farming skill.

Foraging

• Edible respawning pickables, plus prefabs registered in BepInEx/config/Groundwork/pickables.yml, can be affected by Farming skill.
• Higher Farming skill can increase nearby pickup range.
• Higher Farming skill can speed up foraging respawn.
• Rain can speed up foraging respawn while the current environment is wet.

Beehives

• Beehive capacity can increase with Farming level.
• Newly placed hives store the builder's Farming level.
• Harvesting honey updates the hive's stored Farming level from the harvester.
• Harvesting honey can grant Farming skill.
• Lower cover increases honey production speed.
• Night honey production can be slowed or paused.
• Rain can slow or pause loaded honey production.
• Beehives can pollinate nearby growing plants and foraging targets, except while it is raining.
• Empty hives give stronger pollination bonuses; the bonus fades as the hive fills with honey.
• Growing nearby pollination targets can speed up honey production.
• Beehive hover text shows honey capacity in the title, plus cover, pollination, night/rain rates, and next honey time with total rate.

Terrain Tools

• BepInEx/config/Groundwork/Groundwork.yml controls Hoe and Cultivator piece costs and adjustable terrain ranges.
• Hold the tool wheel modifier hotkey and use the mouse wheel to adjust terrain range.
• Preview mode can be vanilla ghost scaling or an exact grid preview.
• Paved Road can optionally skip vanilla smooth-height behavior.
• Pickaxe primary terrain digging can scale radius and depth.
• Pickaxe scaled digging has configurable stamina and durability cost factors.

Hover Info

Groundwork adds compact hover information to:

• Beehives: honey capacity in the title, cover, pollination, night/rain rates, next honey with total rate.
• Plants: remaining growth time, rain growth, pollination growth.
• Foraging pickables: remaining respawn time, rain respawn, pollination respawn.

Groundwork.yml

BepInEx/config/Groundwork/Groundwork.yml defines terrain tool piece costs and adjustable ranges.

Example:

Pickaxe:
  terrainDig:
    range:
      enabled: true
      radiusMax: 1.5
      depthMax: 1.5
      staminaCostFactor: 1
      durabilityFactor: 1

# Exact override for a specific pickaxe prefab.
# Unspecified values fall back to Pickaxe: terrainDig.
PickaxeBlackMetal:
  terrainDig:
    range:
      # Optional: overrides the generic Pickaxe enabled state.
      # enabled: true
      radiusMax: 2
      depthMax: 2

Hoe:
  raise_v2:
    cost:
      Stone: 2
    range:
      enabled: true
      min: 1
      max: 5
      materialCostFactor: 1
      staminaCostFactor: 1
      durabilityFactor: 1

Fields:

• cost: replaces the build menu material cost. Use {} for no material cost.
• range.enabled: enables mouse-wheel range adjustment.
• range.min: minimum range.
• range.max: maximum range.
• range.default: optional default range.
• range.radiusMax: maximum radius scale for Pickaxe: terrainDig.
• range.depthMax: maximum depth scale for Pickaxe: terrainDig.
• range.materialCostFactor: material scaling above base range. 0 keeps base cost.
• range.staminaCostFactor: stamina scaling above base range. 0 keeps base cost.
• range.durabilityFactor: durability scaling above base range. 0 keeps base cost.

For Pickaxe: terrainDig, min and default scale are fixed at 1. Use range.enabled to turn the feature on or off, and use radiusMax and depthMax to set separate caps. staminaCostFactor and durabilityFactor apply to extra costs above x1; cost and materialCostFactor are ignored.

Specific pickaxe prefab blocks, such as PickaxeBlackMetal: terrainDig, override only the values they specify. Missing values fall back to the generic Pickaxe: terrainDig block, and an exact block can set range.enabled: true or false independently.

On multiplayer, the server's BepInEx/config/Groundwork/Groundwork.yml is synced to clients.

Pickable and Plant overrides

Groundwork keeps each growth domain in a separate file under BepInEx/config/Groundwork/:

• pickables.reference.yml: generated Pickable values, grouped by the prefab's original provider.
• pickables.yml: editable Pickable and Farming overrides.
• plants.reference.yml: generated Plant values, grouped by the prefab's original provider.
• plants.yml: editable Plant grow-time overrides.

Each override file is a root YAML sequence, not a pickables: or plants: mapping. Groundwork creates pickables.yml with Pickable_Dandelion and Pickable_Thistle registered as Farming targets:

- prefab: Pickable_Dandelion
  farming: [true, true, 0.25, 1]
- prefab: Pickable_Thistle
  farming: [true, true, 0.25, 1]

plants.yml starts as an empty root sequence:

[]

Copy only the entries you want to change from the corresponding generated reference. For example, a Plant override can be written as:

- prefab: Beech_Sapling, 3000~5000

Tuple schema:

• Pickable: prefab: <prefab>[, <respawnMinutes>]. The optional positive second value replaces a Pickable's base respawn time. Omitting it keeps the live value; a live value of 0 cannot be made respawning by this overlay.
• Farming: farming: [foragingTarget, bonusYield, maxChanceAtLevel100, bonusAmount]. When present, the tuple has exactly four positions; use null to preserve automatic/live behavior in a position.
• Plant: prefab: <prefab>, <growSecondsMin>~<growSecondsMax>. Both values are positive seconds and the maximum must be at least the minimum.
• foragingTarget: true opts in to range/scythe harvesting, Farming respawn scaling, pollination, rain effects, hover info, and missing bonus-effect fallback; false opts out; null keeps automatic edible-pickable detection.
• bonusYield: true opts in to Valheim's Farming skill gain and bonus-yield roll. false or null does not add behavior and never disables a prefab's native Farming bonus.
• maxChanceAtLevel100: bonus probability at Farming 100, from 0 to 1.
• bonusAmount: additional items on a successful roll.

On a successful configured or native Farming bonus roll, Groundwork temporarily supplies fallback VFX/SFX when the Pickable's m_bonusEffect is empty. This includes vanilla Farming pickables such as RaspberryBush and configured targets such as Dandelion.

Omitted Pickable times and null Farming positions use live prefab values, including values supplied by mods such as PlantEverything. Explicit times form the base before Farming, pollination, and rain multipliers.

On each reload, Groundwork reads and validates both pickables.yml and plants.yml before replacing either in-memory rule set. If either file is invalid, Groundwork keeps the last-known-good rules from both files. On multiplayer, the server synchronizes the normalized pair to clients; the generated owner-grouped reference files remain local to the server or single-player source of truth.

The root-sequence compact tuple schema is the only accepted growth schema. Groundwork does not read, parse, or migrate previous root-level YAML files or the unreleased combined/expanded Growth layouts.

Notes

• Rain effects use the currently detected wet environment and are not accumulated while an area is unloaded.
• Beehive Rain Honey Rate affects loaded beehives only. Unloaded honey catch-up is processed without rain history; current rain applies after the beehive is loaded.
• Rain disables beehive pollination while the area is loaded.
• Dedicated servers may not have precise per-position weather history.
• Groundwork does not write transient pollination multipliers to ZDOs.
• ZenBeehive beehive containers are supported: honey removed from the container counts as beehive harvest for Farming skill gain and capacity ownership.
• BepInEx/config/Groundwork/Groundwork.yml, pickables.yml, and plants.yml are created automatically if missing.
• pickables.reference.yml and plants.reference.yml are checked after each world prefab load and rewritten only when their settled content differs.

Changelog

1.0.9

• Added owner-grouped pickables.reference.yml and plants.reference.yml, with root-sequence pickables.yml and plants.yml overrides for Pickable respawn/Farming behavior and Plant grow-time ranges under BepInEx/config/Groundwork/.
• Registered Pickable_Dandelion and Pickable_Thistle as default Farming targets with range/scythe harvesting, Farming skill gain, and vanilla bonus-yield rolls.
• Applied growth overrides at runtime without permanently replacing prefab values, preserving live values from mods such as PlantEverything when override fields are omitted.
• Read and validated both Pickable and Plant override files before atomically replacing either in-memory rule set, then server-synced the normalized pair.
• Moved the generated Groundwork.yml terrain-tool configuration into BepInEx/config/Groundwork/; previous root-level YAML files and the unreleased combined/expanded Growth schemas are not migrated or parsed.
• Preserved native and configured Farming bonus VFX/SFX by supplying an interaction-scoped fallback when a Pickable has an empty m_bonusEffect.

1.0.8

• Fixed scaled terrain-tool placements so extra stamina and durability costs apply exactly once to the tool that performed the placement.
• Fixed terrain tools resetting to the vanilla radius instead of the configured range.default, prevented range-wheel input from also zooming the camera, and bounded oversized grid preview searches with a safe fallback.
• Hardened scalable pickaxe digs so temporary radius and depth changes stay bound to the exact terrain hit and are restored even when spawning fails.
• Fixed pollination catch-up for honey, plant growth, and forage respawn so unloaded time keeps its reduced bonus while loaded bonuses still obey night and rain restrictions.
• Fixed ranged foraging being limited by a fixed collider buffer in dense areas and removed duplicate bonus pickup effects.
• Made plant and forage hover countdowns follow the actual timing calculations and removed the potentially misleading combined speed multiplier.
• Improved mass-planting previews by rejecting overlaps with earlier preview slots, restricting rare placement fallback searches, and avoiding duplicate Grid or Mass instructions in partial key-hint layouts.
• Prevented scythe sweeps from processing the same unhealthy multi-collider crop more than once, improved Jewelcrafting recalculation, and made temporary scythe item-type changes reversible.
• Fixed stale ZenBeehive state after containers close automatically, preventing later inventory actions from being mistaken for a local honey harvest.
• Added comprehensive unload cleanup for configuration, localization, generated UI, previews, Farming state, and compatibility changes.
• Kept normal builds isolated from the live Valheim plugin directory; local deployment now requires explicitly setting DeployLocal=true.

1.0.7

• Clarified the Farming level 20 mass planting requirement in piece tooltips and build key hints, including live Farming progress, while listing always-available grid planting first.

1.0.6

• Fixed first-use mass planting previews stopping at five visible crops when cycling to 10, 15, 20, or 25 before the first placement.
• Reused the original renderer state of Groundwork-hidden placement ghosts when expanding a batch preview, preventing partial 3+2 layouts and repeated empty preview object creation.

1.0.5

• Expanded scythe harvesting to modded wild and cultivated pickables by recognizing additional collider layers and Plant-grown prefab relationships, with shared targeting for HarvestSweep compatibility.
• Added AzuCraftyBoxes-compatible resource checks for mass planting while preserving an exact resource recheck before placement.
• Fixed mass planting previews to copy only active plant renderers, preventing hidden mature growth stages from appearing in placement ghosts.
• Added client-controlled pickaxe terrain-dig tooltips showing the configured x1~xMax range and directing players to the live key hint.

1.0.4

• Improved mass planting persistence and performance by synchronizing the exact planted crop instance, with a compatibility fallback for unusual prefabs.
• Expanded pollination search buffers on demand in unusually dense fields instead of truncating targets at the initial capacity.
• Debounced Groundwork.yml hot reloads and simplified internal terrain tool, configuration, and Harmony state handling.

1.0.3

• Fixed terrain tool grid preview placement consistency so the terrain operation uses the last visible grid preview position at placement time.
• Removed orange coloring from terrain tool piece tooltip hints for a cleaner white/default tooltip style.

1.0.2

• Fixed grid/mass planting persistence by syncing planted crop ZDO positions and reserving batch plant spaces to prevent crops from stacking after reload.
• Disabled beehive pollination at night for both honey rate bonuses and plant/foraging growth bonuses.
• Clarified beehive capacity hover text as Max +N and kept Honey rate wording on the final next-honey line.

1.0.1

• Made grid planting always available independently from mass planting, while mass planting still scales by Farming level.
• Added ZenBeehive container compatibility so honey removed from beehive containers counts as Groundwork harvest.
• Minor refactoring and optimizations.

1.0.0

• Initial release.