v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "Unit list"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(+fix/dead-units)
(Forgot the image.)
 
(26 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{quality|unrated}}
+
{{Quality|Superior|20:34, 3 March 2023 (CST)}}
 
{{av}}
 
{{av}}
  
The '''unit list''' is [[menu]] screen which lists [[creature]]s on the map. It is accessible with {{k|u}}, and is subdivided into four separate screens, whose individual counts are visible at the top of the screen. All have four options: {{k|v}}iewing the creature, zooming to the {{k|c}}reature location, opening the {{k|m}}[[manager|anager]], and {{k|r}}emoving a job order (although this is currently only usable for actual citizens).
+
[[File:unit_list_v50_preview.png|thumb|270px|right|Preview of the unit list.]]This menu tab, labelled '''Creatures''' in game, is separated into four tabs: [[Citizenship|Citizens]], [[Pet]]s/[[Livestock]], [[Invader|Others]], and Dead/Missing. It can be opened with {{k|u}} or by clicking on the first icon on the bottom left of the main [[interface]].
  
The first and primary screen is the Citizens screen, which lists your dwarves according to their [[profession]]. Dwarves are ordered by category: [[mining]], [[carpentry]], [[stoneworker|stoneworking]], [[ranger]]s, [[metalsmith]]s, [[jeweler]]s, [[craftsdwarf|craftsdwarves]], [[fishery worker]]s, [[farmer]]s, [[peasant]]s, active-duty [[soldier]]s, [[children]], and finally [[children#Babies|babies]]. It shows the current [[job]] of each dwarf, highlighted in light blue; repeating tasks are additionally reported with a "/R" at the end, and joblessness is reported with a yellow "No Job." Any [[administrator]]s will appear in purple where they would appear normally according to their profession. Position in the sublists is determined by the order at which the dwarves arrived. If the unit's name is flashing in this list, it means that they have attained [[legendary]] skill level.
+
== Citizens tab ==
 +
Lists all residents of your fortress, including [[Visitor#Long-term residency|long-term residents]], but not [[visitor]]s.
  
The second screen lists livestock. This is useful for quickly zooming to particular animals; most animal management actually happens in the animal [[status]] screen.
+
Each entry includes the following columns (from left to right):
 +
* An image of the resident.
 +
* The [[name]]* and [[profession]]* of the resident, color-coded by profession.
 +
* Buttons to go to the resident's location or view their sheet.
 +
* The task* they are currently performing, along with (where applicable) buttons to go to its location, view a detailed description, remove the current worker from the task, [[suspend]] the task, and cancel the task.
 +
* The resident's current [[stress]] level*.
 +
* The resident's assigned [[work detail]]s preceded by a button to toggle whether they are allowed to do unassigned [[labor]]s.
  
The third lists "Other". Any creatures that are neither dwarves nor dwarven livestock are listed under Other; this means that the list is populated by ''visible'' local [[biome|wildlife]] (there may be unseen creatures underground), [[caravan]] traders and guards (as well as their pack animals and for-sale animals), exposed [[thief|thieves]] and [[ambush]]es, the contents of [[siege]]s, and anything [[megabeast|really]] [[titan|scary]]. This list is most useful for zooming on their location, and lists a few statuses: wild animal ([[creature|wildlife]]), domesticated ([[pet]]s), domesticated (caged) (pets in [[cage]]s), hostile ([[thief|thieves]]), invader ([[ambush]]es), uninvited guest ([[werebeast]]s, [[megabeast]]s, and [[forgotten beast]]s), and friendly ([[trader]]s, the [[outpost liaison]], and caravan guards). This menu is important for keeping track of the local wildlife; regular looks may very well save you from a deadly [[giant lion]] attack.
+
''* The list is sortable by this column. Defaults to sorting by profession''
  
The final list is the Dead/Missing list, which keeps tabs on everything that entered the map and didn't leave. This is the best record of your [[hunting]] returns, siege rebuffs, [[unfortunate accident|accident]] victims, and battle casualties. As a dead or missing list, it reports either Deceased or Missing; the missing status will be tacked on the moment a dwarf goes missing, not a week later as with the [[announcement]], making it extremely useful for checking for [[vampire]]s. For fortresses with long histories, this list may very well be hundreds or even thousands of units long. Note: cluttered unit lists can interfere with things like [[migration]]; you can prune less interesting dead units with [[DFHack]]'s "fix/dead-units" command.
+
When sorting by profession, they are not by alphabetical order, instead being sorted by [[Labor#List of labors|labor category]], then specific profession within the category, again not necessarily in alphabetical order. Children and babies are listed last. All sorting may be reversed, meaning for example, sorting by [[name]] may go A-Z or can be reversed to be Z-A.
  
 +
== Pets/Livestock tab ==
 +
Lists all [[Creature#Animals|animals]] that are owned by the fortress or its residents, but does not include any wild animals, nor animals belonging to invaders or caravans.
  
 +
Each entry includes the following columns (from left to right):
 +
* An image of the creature.
 +
* The [[Name#Animal and megabeast names|name]]* of the creature. The word "[[stray]]" indicates that the animal is not any dwarf's [[pet]]. In the case of [[War animal|war]] or [[Hunting animal|hunting animals]], it means the animal has not been assigned to a dwarf. Named animals are usually a pet, often of an [[Immigration|immigrant]], named before joining your fortress, although animals that have made a significant kill by also get a name.
 +
* Buttons to go to the creature's location or view the creature's sheet.
 +
* The level of [[Animal trainer#Training|training]]* the creature has and its [[Animal trainer|Trainer]] status (see [[#Animal Training Level|below]] for options).
 +
* Buttons to assign a [[Animal trainer|trainer]], and to toggle if the creature should receive [[War animal|war training]] and/or [[Hunting animal|hunting training]].
 +
* The creature's ownership status (see [[#Animal Ownership Status|below]] for options).
 +
* Buttons to toggle pet availability (for stray creatures, excluding all [[Cat|cats]]), mark for [[Butcher|slaughter]] (for stray creatures), or mark for [[Gelder|gelding]] (for ungelded male creatures).
  
 +
''* The list is sortable by this column. Defaults to sorting by [[profession]], which is likely a bug, as this appears not to do anything but apply a semi-random order for animals.''
 +
 +
=== Animal training level ===
 +
The following are the options for the animal's [[Animal trainer|training]] level:
 +
*(none) - This animal is wild.{{Verify|Can this happen?}}
 +
*{{DFtext|W|6:1}}{{Verify|Premium version icons}} - This animal is semi-wild.
 +
*{{DFtext|T|7:1}}{{Verify|Premium version icons}} - This animal is trained.
 +
*{{DFtext|-|7:1}}{{Verify|Premium version icons}} - This animal is well-trained.
 +
*{{DFtext|+|7:1}}{{Verify|Premium version icons}} - This animal is skillfully trained.
 +
*{{DFtext|*|7:1}}{{Verify|Premium version icons}} - This animal is expertly trained.
 +
*{{DFtext|≡|7:1}}{{Verify|Premium version icons}} - This animal is exceptionally trained.
 +
*{{DFtext|☼|7:1}}{{Verify|Premium version icons}} - This animal is masterfully trained.
 +
*{{DFtext|Domesticated|2:1}} - This animal is domesticated.
 +
 +
=== Animal ownership status ===
 +
The following are the options for the animal's ownership status:
 +
* {{DFtext|Available as a pet|3:1}} - This animal is available for adoption as a pet.
 +
* {{DFtext|Work Animal|7:0}}{{Verify|Premium version representation}} - This animal has been trained as either a hunting or war animal, and has not been assigned an owner.
 +
* <span style="font-family:IBM Plex Mono Medium, Consolas, monospace; font-size:12.5px; background-color:#000; color:#FF7A12;">Unavailable as a pet</span> - This animal currently cannot be claimed as a pet.
 +
* {{DFtext|Uninterested in an owner|7:0}} - Cats, being superior to all other creatures, cannot be assigned as pets. Instead, they will adopt an owner at their whim.
 +
* {{DFtext|Owned|7:1}} with the owner's name below - This animal belongs to the listed dwarf. Pets can provide happiness to their owners.
 +
* {{DFtext|Ready for Slaughter|5:1}} - This animal will be butchered when a [[butcher]] becomes available.
 +
* {{DFtext|Not Tame|5:0}}{{Verify|Premium version representation}} - This animal is wild and requires taming.
 +
 +
=== Overall training ===
 +
In the bottom right corner of the Pets/Livestock menu, there is a button to open a menu that shows civilization-wide animal training knowledge. Training wild animals contributes to this knowledge.
 +
 +
{|class="wikitable" style="width:20%; align:center"
 +
! Training level
 +
|-
 +
| {{DFtext|A few facts|red}}
 +
|-
 +
| {{DFtext|General familiarity|yellow}}
 +
|-
 +
| {{DFtext|Knowledgeable|white}}
 +
|-
 +
| {{DFtext|Expert|cyan}}
 +
|-
 +
|{{DFtext|Domesticated|lime}}
 +
|}
 +
 +
== Others tab ==
 +
Lists all visible living creatures that are not residents of, or owned by, your fortress. Creatures [[Captured creature|captured]] in a [[cage]] still remain in this tab and are not considered owned until [[Animal trainer|tamed]]. There may be unseen creatures underground or hiding that will not be listed.
 +
 +
Each list entry includes the following columns (from left to right):
 +
* An image of the creature.
 +
* The [[name]]* and (if applicable) [[profession]]* of the creature.
 +
* Buttons to go to the creature's location or view the creature's sheet.
 +
* The status* of the creature (see [[#Status|below]] for options).
 +
* Button to assign a trainer to a [[Captured creature|captured]] wild [[Creature#Animals|animal]] (if applicable).
 +
 +
''* The list is sortable by this column. Appears to initially be sorted by first arrival date{{Verify}}, though sorting by profession is initially selected, which is likely a bug, as actually sorting by profession requires switching to sort by [[name]] then back to profession.'' <!-- This should probably be moved to a bug report tag -->
 +
 +
=== Status ===
 +
The following are the options for the creature's status:
 +
{| class=wikitable
 +
! Status
 +
! Description
 +
|-
 +
| {{DFtext|Wild animal|2:0}}
 +
| Wildlife.
 +
|-
 +
| {{DFtext|Merchant|7:0}}
 +
| [[Merchant]]s, as well as their pack animals and wagons.
 +
|-
 +
| {{DFtext|Diplomat|7:1}}
 +
| [[Diplomat]]s and [[outpost liaison]]s.
 +
|-
 +
| {{DFtext|Guest|2:1}}
 +
| Foreign [[visitor]]s.
 +
|-
 +
| {{DFtext|Friendly|2:1}}
 +
| All non-hostile creatures that do not fit into any of the categories above.
 +
|-
 +
| {{DFtext|Invader|4:0}}
 +
| [[Siege]]s and [[ambush]]es.
 +
|-
 +
| {{DFtext|Caged Prisoner|4:0}}
 +
| Caged invaders.
 +
|-
 +
| {{DFtext|Uninvited Guest|4:0}}
 +
| [[Megabeast]]s, [[semi-megabeast]]s, [[forgotten beast]]s and [[titan]]s.
 +
|-
 +
| {{DFtext|Caged Guest|4:0}}
 +
| Uninvited guests you managed to catch in a cage.
 +
|-
 +
| {{DFtext|Current Resident|4:0}}
 +
| All named beasts you encounter upon embark.
 +
|-
 +
| {{DFtext|Berserk|4:1}}
 +
| [[Werebeast]]s, [[Insanity|berserk]] dwarves and creatures with the [[Creature token|[CRAZED]]] token.
 +
|-
 +
| {{DFtext|Undead|0:1}}
 +
| Undead, such as [[zombie]]s and [[ghost]]s.
 +
|-
 +
| {{DFtext|Opposed to life|0:1}}
 +
| Creatures with the [[Creature token|[OPPOSED_TO_LIFE]]] token, hostile to all living creatures.
 +
|-
 +
| {{DFtext|Hostile|4:0}}
 +
| All other hostile creatures.
 +
|}
 +
 +
This menu is important for keeping track of the local wildlife; regular looks may very well save you from a deadly [[giant lion]] attack.
 +
 +
== Dead/Missing tab ==
 +
Lists all creatures that have died or gone missing in your settlement, regardless of which tab they would have been on when alive. This serves as record of your [[hunting]] returns, siege rebuffs, [[unfortunate accident|accident]] victims, and battle casualties
 +
 +
Each list entry contains the following columns (from left to right):
 +
* An image of the creature.
 +
* The [[name]]* and (if applicable) [[profession]]* of the creature.
 +
* Whether the creature is {{DFtext|Deceased|5:1}} or {{DFtext|Missing|7:0}}*.
 +
 +
''* The list is sortable by this column. Appears to initially be sorted by first arrival date{{Verify}}, though sorting by profession is initially selected, which is likely a bug, as actually sorting by profession requires switching to sort by [[name]] then back to profession.'' <!-- This should probably be moved to a bug report tag -->
 +
 +
{{V50 menus}}
 
{{Category|Interface}}
 
{{Category|Interface}}
 +
[[ru:Unit list]]

Latest revision as of 02:37, 4 March 2023

This article is about the current version of DF.
Note that some content may still need to be updated.

Preview of the unit list.

This menu tab, labelled Creatures in game, is separated into four tabs: Citizens, Pets/Livestock, Others, and Dead/Missing. It can be opened with u or by clicking on the first icon on the bottom left of the main interface.

Citizens tab[edit]

Lists all residents of your fortress, including long-term residents, but not visitors.

Each entry includes the following columns (from left to right):

  • An image of the resident.
  • The name* and profession* of the resident, color-coded by profession.
  • Buttons to go to the resident's location or view their sheet.
  • The task* they are currently performing, along with (where applicable) buttons to go to its location, view a detailed description, remove the current worker from the task, suspend the task, and cancel the task.
  • The resident's current stress level*.
  • The resident's assigned work details preceded by a button to toggle whether they are allowed to do unassigned labors.

* The list is sortable by this column. Defaults to sorting by profession

When sorting by profession, they are not by alphabetical order, instead being sorted by labor category, then specific profession within the category, again not necessarily in alphabetical order. Children and babies are listed last. All sorting may be reversed, meaning for example, sorting by name may go A-Z or can be reversed to be Z-A.

Pets/Livestock tab[edit]

Lists all animals that are owned by the fortress or its residents, but does not include any wild animals, nor animals belonging to invaders or caravans.

Each entry includes the following columns (from left to right):

  • An image of the creature.
  • The name* of the creature. The word "stray" indicates that the animal is not any dwarf's pet. In the case of war or hunting animals, it means the animal has not been assigned to a dwarf. Named animals are usually a pet, often of an immigrant, named before joining your fortress, although animals that have made a significant kill by also get a name.
  • Buttons to go to the creature's location or view the creature's sheet.
  • The level of training* the creature has and its Trainer status (see below for options).
  • Buttons to assign a trainer, and to toggle if the creature should receive war training and/or hunting training.
  • The creature's ownership status (see below for options).
  • Buttons to toggle pet availability (for stray creatures, excluding all cats), mark for slaughter (for stray creatures), or mark for gelding (for ungelded male creatures).

* The list is sortable by this column. Defaults to sorting by profession, which is likely a bug, as this appears not to do anything but apply a semi-random order for animals.

Animal training level[edit]

The following are the options for the animal's training level:

  • (none) - This animal is wild.[Verify]
  • W[Verify] - This animal is semi-wild.
  • T[Verify] - This animal is trained.
  • -[Verify] - This animal is well-trained.
  • +[Verify] - This animal is skillfully trained.
  • *[Verify] - This animal is expertly trained.
  • [Verify] - This animal is exceptionally trained.
  • [Verify] - This animal is masterfully trained.
  • Domesticated - This animal is domesticated.

Animal ownership status[edit]

The following are the options for the animal's ownership status:

  • Available as a pet - This animal is available for adoption as a pet.
  • Work Animal[Verify] - This animal has been trained as either a hunting or war animal, and has not been assigned an owner.
  • Unavailable as a pet - This animal currently cannot be claimed as a pet.
  • Uninterested in an owner - Cats, being superior to all other creatures, cannot be assigned as pets. Instead, they will adopt an owner at their whim.
  • Owned with the owner's name below - This animal belongs to the listed dwarf. Pets can provide happiness to their owners.
  • Ready for Slaughter - This animal will be butchered when a butcher becomes available.
  • Not Tame[Verify] - This animal is wild and requires taming.

Overall training[edit]

In the bottom right corner of the Pets/Livestock menu, there is a button to open a menu that shows civilization-wide animal training knowledge. Training wild animals contributes to this knowledge.

Training level
A few facts
General familiarity
Knowledgeable
Expert
Domesticated

Others tab[edit]

Lists all visible living creatures that are not residents of, or owned by, your fortress. Creatures captured in a cage still remain in this tab and are not considered owned until tamed. There may be unseen creatures underground or hiding that will not be listed.

Each list entry includes the following columns (from left to right):

  • An image of the creature.
  • The name* and (if applicable) profession* of the creature.
  • Buttons to go to the creature's location or view the creature's sheet.
  • The status* of the creature (see below for options).
  • Button to assign a trainer to a captured wild animal (if applicable).

* The list is sortable by this column. Appears to initially be sorted by first arrival date[Verify], though sorting by profession is initially selected, which is likely a bug, as actually sorting by profession requires switching to sort by name then back to profession.

Status[edit]

The following are the options for the creature's status:

Status Description
Wild animal Wildlife.
Merchant Merchants, as well as their pack animals and wagons.
Diplomat Diplomats and outpost liaisons.
Guest Foreign visitors.
Friendly All non-hostile creatures that do not fit into any of the categories above.
Invader Sieges and ambushes.
Caged Prisoner Caged invaders.
Uninvited Guest Megabeasts, semi-megabeasts, forgotten beasts and titans.
Caged Guest Uninvited guests you managed to catch in a cage.
Current Resident All named beasts you encounter upon embark.
Berserk Werebeasts, berserk dwarves and creatures with the [CRAZED] token.
Undead Undead, such as zombies and ghosts.
Opposed to life Creatures with the [OPPOSED_TO_LIFE] token, hostile to all living creatures.
Hostile All other hostile creatures.

This menu is important for keeping track of the local wildlife; regular looks may very well save you from a deadly giant lion attack.

Dead/Missing tab[edit]

Lists all creatures that have died or gone missing in your settlement, regardless of which tab they would have been on when alive. This serves as record of your hunting returns, siege rebuffs, accident victims, and battle casualties

Each list entry contains the following columns (from left to right):

  • An image of the creature.
  • The name* and (if applicable) profession* of the creature.
  • Whether the creature is Deceased or Missing*.

* The list is sortable by this column. Appears to initially be sorted by first arrival date[Verify], though sorting by profession is initially selected, which is likely a bug, as actually sorting by profession requires switching to sort by name then back to profession.

Creatures Ui u.pngu
Tasks Ui t.pngt
Places Ui P.pngP
Labor Ui y.pngy
Work orders Ui o.pngo
Nobles and Administrators Ui n.pngn
Objects Ui O.pngO
Justice Ui j.pngj