CropUtils

CropUtils v 2.1.1

Inspired by MassFarming by Xeio, but uses more efficient triangle packing for optimal placement as well as harvesting a large area at once.

Check out Xeio's mod here: https://github.com/Xeio/MassFarming

This mod has two main purposes:

1. Plant many crops at once with two pattern options, triangle packing or in a line that respect healthy plant distancing.

This uses triangle packing hex grid to maximize crop placement efficiency instead of a less space efficient and more limiting square grid.

1. Pick crops (and other interactables like beehives, rocks, branches, herbs and more) in an area with one interaction.

Planting will skip any invalid plant locations, so you can use this to fill in any gaps in your fields.

Usable entirely on client, even in multiplayer - though if in MP, you should probably get permission from the admin to use. Dedicated servers do not need this installed.

Dependant on BepInEx (https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim/)

See config for all configurables, and change at your leasuire.

Tested with some mods that add additional plants but compatibility not guarenteed.

Default keybinds:

• Pickup: While looking at a pick-able item, hold left ALT to pickup in an area
• Planting Line: Hold left ALT to plant in a line, and optionally hold Z to lock the line in place.
• Planting Hex: Press and hold Z first then left ALT creates a circle packed pattern for mass planting
• Change range: Use the ]} key to increase the size and range of the utils, and [{ to decrease the range of the utils
• Change spacing: Use the = key to increase the space between plants and the - key to decrease it. The adjustment is relative to the spacing in effect for the current plant and cannot go below the minimum that plant requires.

Configurables:

• Keybinds for primary & secondary tool function
• Pickup range display, range increase & decrease keybinds
• Optional matching-type-only mass pickup (disabled by default)
• Discount for stamina and durability use when multiplanting
• Show / hide range helper
• Support for gamepad keybinds, but admittedly defaults are probably not good. Let me know if you find some good controller binds.
• Support for additional mods that plant non-standard Valheim crops, such as PlantEverything. (https://valheim.thunderstore.io/package/Advize/PlantEverything/1.12.0/) See 1.2.0 changelog for more info.

Limitations:

• Hex grid does not align with rotation like line tool does. I'd like to fix that in future.
• In order for hex grid to not cause lag when displaying ghosts, it has to be locked in place while it builds. The line tool does not, though perfomance will suffer with very high ranges.
• Will cause a bunch of lag when planting very large patterns.
• Mod compatibility is not guaranteed, but this mod offers a generic solution should should work for most use cases.-
• Ashlands introduced randomized rotation. From 2.1.0 the orientation is held steady while the util key is held, so rows planted in sequence keep one direction. Releasing the key restores Valheim's normal behaviour.
• Locking the shape with an invalid origin, then looking away may let you place the first plant even if it shows as invalid. All other plants should correctly respect the preview, only planting if they are valid.

Changelog:

2.1.1

Added an optional MatchingTypeOnly pickup setting, disabled by default. When enabled, mass pickup only picks up items of the same type as the targeted item. Beehive behavior is unchanged.

2.1.0

Spacing is derived per plant instead of being a fixed multiple of the grow radius. The minimum distance is the largest radius Valheim sweeps when checking for space, plus the plant's collider footprint measured about its own vertical axis, so the figure does not change with rotation. Both are taken for the fully grown plant: growth stages are followed through to the end, and each stage's footprint is scaled by that stage's maximum growth scale. Valheim re-checks for space on every growth tick, and a neighbour that has already grown is both larger and blocks unconditionally, so reserving room for the sapling alone was not sufficient. A fixed multiplier could not suit every crop - 2.0 was wider than any plant needed, and 1.5 was too tight for some. "GrowRadiusSpacingMultiplier" now defaults to 1.0 and serves only to add optional extra room.

Clearance is evaluated in both directions. Every plant runs its own space check, so a position is accepted only when it satisfies the new plant's requirement against its neighbour and the neighbour's requirement against the new plant. Neighbouring plants are measured individually, which matters when they are a different species with a different size and shape. Previously only the new plant's requirement was honoured, which could leave an established crop unable to grow.

The build rotation is held steady while the util key is held. Valheim re-rolls it both after a piece is placed and whenever the placement ghost is rebuilt, and paying for a plant rebuilds the ghost, so rows planted in sequence changed direction. Ordinary building is unaffected.

The preview matches what is planted. Ghost states account for the available seed count, so with five seeds only five positions validate however many are previewed. The generated pattern also carries a small margin over the minimum distance rather than sitting exactly on it, which previously allowed rounding to reject roughly every other position at planting time.

Invalid positions are skipped rather than blocking the action, and this includes the first plant. A first plant that is crowded or unaffordable is left unplanted and unpaid for while the rest of the pattern proceeds, which allows a row to be started next to existing crops in order to fill gaps. Warnings are consistent across the whole shape, with the first plant tinting red under the same conditions as the rest. A position where the crop could never grow