.. dfhack-tool::
    :summary: Designate trees for chopping and shrubs for gathering.
    :tags: fort productivity plants

Specify the types of trees to cut down and/or shrubs to gather by their plant names.

getplants [-t|-s|-f]

List valid tree/shrub ids, optionally restricted to the specified type.

getplants <id> [<id> ...] [<options>]

Designate trees/shrubs of the specified types for chopping/gathering.

getplants

List all valid IDs.

getplants -f -a

Gather all plants on the map that yield seeds for farming.

getplants NETHER_CAP -n 10

Designate 10 nether cap trees for chopping.

-t

Tree: Select trees only (exclude shrubs).

-s

Shrub: Select shrubs only (exclude trees).

-f

Farming: Designate only shrubs that yield seeds for farming.

-a

All: Select every type of plant (obeys -t/-s/-f).

-c

Clear: Clear designations instead of setting them.

-x

eXcept: Apply selected action to all plants except those specified (invert selection).

-v

Verbose: Lists the number of (un)designations per plant.

-n <num>

Number: Designate up to the specified number of plants of each species.