Skip to content

jobutils.rst

Latest commit

 

History

History
60 lines (49 loc) · 2.11 KB

jobutils.rst

File metadata and controls

60 lines (49 loc) · 2.11 KB

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 q mode and have a workshop or furnace building selected.
job-material <inorganic-token>
Alters the material of the selected job (in q mode) or jumps to the selected material when choosing the building component of a planned building (in 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.