Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/changelog.txt
Original file line number Diff line number Diff line change
Expand Up @@ -57,8 +57,11 @@ Template for new versions:
## New Tools

## New Features
- `autofarm`: farm plots can now be individually excluded from autofarm management via new controls on the farm plot information sheet, which also warn when a farm's crops are being managed by autofarm
- `autofarm`: thresholds can now be assigned to specific growth products of a plant (e.g. ``BUSH_QUARRY:LEAVES``), so crops that are grown for their growth items can be farmed to a target amount of that product

## Fixes
- `autofarm`: farms that span multiple biomes are now handled correctly: crops that can grow in any of the farm's biomes can be assigned to the farm, instead of only using the biome of the farm's center tile
- `labormanager`: the modern engine's labor-mismatch probe no longer enables unmanaged labors on idle units or specialists, and no longer re-probes postings that can never be claimed (#6028)

## Misc Improvements
Expand Down
18 changes: 18 additions & 0 deletions docs/plugins/autofarm.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,14 @@ Periodically scan your plant stocks and assign crops to your farm plots based on
which plant stocks are low (as long as you have the appropriate seeds). The
target threshold for each crop type is configurable.

Farms that span multiple biomes are handled correctly: any crop that can grow
in any of the biomes covered by the farm's tiles may be assigned to that farm.

Individual farm plots can be excluded from autofarm management via the controls
that appear on the farm plot information sheet. That sheet also provides a
shortcut to `gui/autofarm`, a convenient UI for setting crop thresholds and
enabling or disabling autofarm.

Usage
-----

Expand All @@ -26,10 +34,20 @@ Usage
You can find the identifiers for the crop types in your world by running the
following command: ``getplants -f``

Some plants produce usable growth items (such as fruits, leaves, or bulbs)
when processed or gathered. These products normally count toward the plant's
threshold together with the plant items themselves, but you can also assign a
threshold to a specific growth product with the ``<plant>:<growth>`` syntax.
A plant is grown while either its pooled stock or any of its assigned growth
products is below the corresponding threshold.

Examples
--------

``autofarm default 30``
Set the default threshold to 30.
``autofarm threshold 150 MUSHROOM_HELMET_PLUMP GRASS_TAIL_PIG``
Set the threshold for Plump Helmets and Pig Tails to 150
``autofarm threshold 30 BUSH_QUARRY:LEAVES``
Keep at least 30 Quarry Bush Leaves in stock, growing Quarry Bushes until
you have enough of them to process
2 changes: 1 addition & 1 deletion plugins/CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ if(BUILD_SUPPORTED)
dfhack_plugin(autoclothing autoclothing.cpp LINK_LIBRARIES lua)
dfhack_plugin(design design.cpp LINK_LIBRARIES lua)
dfhack_plugin(autodump autodump.cpp)
dfhack_plugin(autofarm autofarm.cpp)
dfhack_plugin(autofarm autofarm.cpp LINK_LIBRARIES lua)
#dfhack_plugin(autogems autogems.cpp LINK_LIBRARIES jsoncpp_static)
add_subdirectory(autolabor)
dfhack_plugin(autonestbox autonestbox.cpp LINK_LIBRARIES lua)
Expand Down
Loading
Loading