61 lines
2.1 KiB
ReStructuredText
61 lines
2.1 KiB
ReStructuredText
.. _job:
|
|
|
|
jobutils
|
|
========
|
|
|
|
.. dfhack-tool::
|
|
:summary: Provides commands for interacting with jobs.
|
|
:tags: unavailable
|
|
:no-command:
|
|
|
|
.. dfhack-command:: job
|
|
:summary: Inspect or modify details of workshop jobs.
|
|
|
|
.. dfhack-command:: job-duplicate
|
|
:summary: Duplicates the highlighted job.
|
|
|
|
.. dfhack-command:: job-material
|
|
:summary: Alters the material of the selected job.
|
|
|
|
Usage
|
|
-----
|
|
|
|
``job``
|
|
Print details of the current job. The job can be selected in a workshop or
|
|
the unit/jobs screen.
|
|
``job list``
|
|
Print details of all jobs in the selected workshop.
|
|
``job item-material <item-idx> <material[:subtoken]>``
|
|
Replace the exact material id in the job item.
|
|
``job item-type <item-idx> <type[:subtype]>``
|
|
Replace the exact item type id in the job item.
|
|
``job-duplicate``
|
|
Duplicates the highlighted job. Must be in :kbd:`q` mode and have a workshop
|
|
or furnace building selected.
|
|
``job-material <inorganic-token>``
|
|
Alters the material of the selected job (in :kbd:`q` mode) or jumps to the
|
|
selected material when choosing the building component of a planned building
|
|
(in :kbd:`b` mode). Note that this form of the command can only handle
|
|
inorganic materials.
|
|
|
|
Use the ``job`` and ``job list`` commands to discover the type and material ids
|
|
for existing jobs, or use the following commands to see the full lists::
|
|
|
|
lua @df.item_type
|
|
lua "for i,mat in ipairs(df.global.world.raws.inorganics) do if mat.material.flags.IS_STONE and not mat.material.flags.NO_STONE_STOCKPILE then print(i, mat.id) end end"
|
|
|
|
Examples
|
|
--------
|
|
|
|
``job-material GNEISS``
|
|
Change the selected "Construct rock Coffin" job at a Mason's workshop to
|
|
"Construct gneiss coffin".
|
|
``job item-material 2 MARBLE``
|
|
Change the selected "Construct Traction Bench" job (which has three source
|
|
items: a table, a mechanism, and a chain) to specifically use a marble
|
|
mechanism.
|
|
``job item-type 2 TABLE``
|
|
Change the selected "Encrust furniture with blue jade" job (which has two
|
|
source items: a cut gem and a piece of improvable furniture) to specifically
|
|
use a table instead of just any furniture.
|