# getplants

Tags: fort | productivity | plants

Command: `getplants`

Designate trees for chopping and shrubs for gathering.

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

## Usage

`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.

## Examples

`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.

## Options

`-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.

Note

DF is capable of determining that a shrub has already been picked, leaving an unusable structure part behind. This plugin does not perform such a check (as the location of the required information has not yet been identified). This leads to some shrubs being designated when they shouldn’t be, causing a plant gatherer to walk there and do nothing (except clearing the designation). See Issue 1479 for details.