Editing Instrument

{{Quality|Exceptional|12:59, 15 April 2021 (UTC)}}
{{av}}
{{new in v0.42}}
{{old}}

An '''instrument''' {{Tile|¿|7:1}}  is a procedurally-generated item used for making music in [[tavern]]s and [[temple]]s.
__TOC__

Instruments come in four types defined by the skill necessary for play ([[Keyboardist|keyboard]], [[Stringed instrumentalist|stringed]], [[Wind instrumentalist|wind]], and [[Percussionist|percussion]]). Some instruments are made in a single step like other [[finished goods]], however most instruments are assembled from multiple individual components. (For example, a bell might be one-piece, but a pipe organ would have a keyboard, pipes, bellows, and a body to support it all). Instruments can be either hand-held or stationary. Stationary instruments are built from the [[furniture]] menu with the {{k|b}}-{{k|f}}-{{k|i}} command. Hand-held instruments can be carried around by dwarves or placed in [[coffer]]s in [[tavern]]s or [[temple]]s.

Instruments and their components can be made out of a variety of materials, including [[wood]], [[bone]], [[shell]], [[stone]], [[silk]] [[thread]], [[plant fiber]] [[thread]], [[glass]], [[ceramic]]s, [[metal]], or [[leather]]. Out of those, thread and leather can only be used for components, not for a full instrument. Many of the instruments/components are made in [[craftsdwarf's workshop]]s {{k|b}}-{{k|o}}-{{k|r}}, however certain types of instruments or components may only be created in more specialized workshops:
:* [[carpenter's workshop]] {{k|b}}-{{k|o}}-{{k|p}}  for [[wood]] instruments/components
:* [[glass furnace]] {{k|b}}-{{k|o}}-{{k|u}}-{{k|g}} for [[glass]] instruments/components
:* [[kiln]] {{k|b}}-{{k|o}}-{{k|u}}-{{k|k}} for [[ceramic]] instruments/components
:* [[leather works]] {{k|b}}-{{k|o}}-{{k|l}}-{{k|l}} for [[leather]] instruments/components
:* [[mason's workshop]] {{k|b}}-{{k|o}}-{{k|t}} for [[stone]] instruments/components
:* [[metalsmith's forge]] {{k|b}}-{{k|o}}-{{k|i}} for [[metal]] instruments/components

The details menu can be used to select the specific material for most instruments and components. Glass and ceramic instrument jobs do not yet support the details menu; all glass instruments will be made from [[green glass]] in your fortress (though [[caravan]]s can bring instruments or instrument parts made out of other types of glass), and the potter will choose the material for ceramic instruments. Assembling the instrument after all the components are finished is also performed in a craftsdwarf's workshop, and the skill needed to assemble it is defined by the material of the "main" part of the instrument (see "Components", below).

Any instruments with a single component can be made directly. More complex ones require each instrument piece to first be made separately and then assembled into the final instrument. The option associated with them is "assemble <*instrument*>". Make a note of the name of the instrument and enter the work orders screen with {{k|o}}. Clicking the button to create a new work order and typing the name of the instrument in the search box will show all the pieces required (possibly from other workshops). Single-piece instruments created at other workshops will not be listed in the craftsdwarf's shop; those can be found by checking the potential workshops or scrolling through possible jobs in the manager screen.

During a [[strange mood]], dwarves may create instruments which use improper materials and/or do not include the required components (e.g. a metal-bells-on-a-glass-stand instrument made from wood with spikes of leather).

=== Instrument names ===
There are no standard instruments or names for them, nor are there intended to be. Specific instruments are semi-randomly generated at [[world generation]] (both their names and the details of any components they are built of), and are usually specific to each [[civilization]]. The stone triangle your dwarves have in this fortress will almost certainly not be the stone triangle you have in the next fortress, nor that their neighbors have in either. This can make remembering the various instruments a challenge - a notepad or equivalent may be handy.

Traders may bring individual components for other instruments from their civilizations, but you will be unable to assemble them into instruments unless your dwarves have the necessary knowledge for that specific instrument.  In theory, a dwarf can play any instrument if it is complete (but see "usage", below – they may never want/need to).

In order to find out what instruments are available to your fortress, go to a [[craftsdwarf's workshop]] and look under the instrument section. It will show ''most'' of the available instruments, either as a whole instrument or some individual component. Go to the other workshops (listed above) for any additional instruments. Highlight each individual instrument will show their description and material required.

==Usage==

Dwarves will use instruments in taverns or temples only if they know a particular song or dance that requires their use.  If you see a dwarf with the job status "Simulate <*instrument name*>" then the dwarf would use that instrument if it were available.

==Components==
Below are tables of parts that instruments can have and what materials they may require. It should be noted that, for a given world, only one material type is possible for each specific component. Thus, if a given instrument uses a metal keyboard material, it cannot be made using any other materials. Shell is only rarely chosen as a material.

A completely assembled instrument has a very high [[Item value#Base values of items|base item value]].  The [[quality]] of the overall item is determined by the quality of the  "main" part, from which the instrument takes its description, e.g. a ''superior quality black bronze'' stelid. The main part also determines which skill is used to assemble the instrument (bonecarving, glassmaking, leatherworking, metalcrafting, pottery, stonecrafting or woodcrafting).  Main parts are designated by an asterisk (*) in the table below.

===Keyboard===
{|class="wikitable sortable"
! rowspan=2 | Part
! rowspan=2 | Component name
! colspan=10| Materials
|-
<!-- ! Materials -->
! Silk
! Plant Thread
! Leather
! Wood
! Bone
! Ceramic
! Metal
! Glass
! Stone
! Shell
|-
<!--              Part | Component | Silk | Thread | Leather | Wood | Bone | Ceramic | Metal | Glass | Stone | Shell -->
| rowspan=1 |Keyboard ||Keyboard  ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
| rowspan=4 |Body*    ||Console   ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}   
|-
|<!--                -->Chest     ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
|<!--                -->Body      ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|- 
|<!--                -->Case      ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
| rowspan=3 |Vib      ||Strings   ||{{Y}}||  {{Y}}||        ||     ||     ||        || {{Y}}||      ||      ||
|-
|<!--                -->Bells     ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
|<!--                -->Pipes     ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
| rowspan=2 |Bellows  ||Pump      ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
|<!--                -->Bellows   ||     ||       ||   {{Y}}||     ||     ||        ||      ||      ||      ||
|}



===Stringed===
{|class="wikitable sortable"
! rowspan=2 | Part
! rowspan=2 | Component name
! colspan=10 | Materials
|-
<!-- ! Materials -->
! Silk
! Plant Thread
! Leather
! Wood
! Bone
! Ceramic
! Metal
! Glass
! Stone
! Shell
|-
<!--              Part | Component | Silk | Thread | Leather | Wood | Bone | Ceramic | Metal | Glass | Stone | Shell -->
| rowspan=1 |Neck     ||Neck      ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
| rowspan=1 |Frame*   ||Frame     ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
| rowspan=2 |Body*    ||Body      ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
|<!--              -->Sound-chest ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
| rowspan=1 |Yoke     ||Yoke      ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}     
|- 
| rowspan=1 |Strings  ||Strings   ||{{Y}}||  {{Y}}||        ||     ||     ||        || {{Y}}||      ||      ||
|-
| rowspan=3 |Prod     ||Bow       ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
|<!--                -->Plectrum  ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
|<!--                -->Hammers   ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|- 
| rowspan=1 |Neck_res ||Neck bowl ||     ||       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}  
|}

===Wind===
{|class="wikitable sortable"
! rowspan=2 | Part
! rowspan=2 | Component name
! colspan=8 | Materials
|-
<!-- ! Materials -->
! Leather
! Wood
! Bone
! Ceramic
! Metal
! Glass
! Stone
! Shell
|-
<!--              Part | Component | Leather | Wood | Bone | Ceramic | Metal | Glass | Stone | Shell -->
| rowspan=2 |Blow     ||Blowpipe  ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
|<!--                -->Bellows   ||   {{Y}}||     ||     ||        ||      ||      ||      ||       
|-
| rowspan=1 |Bag*     ||Bag       ||   {{Y}}||     ||     ||        ||      ||      ||      || 
|-
| rowspan=1 |Melody   ||Melody pipe ||      ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
| rowspan=1 |Drone    ||Drone pipe ||       ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
| rowspan=2 |Body*    ||Body       ||       ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
|<!--                -->Wind-Chest ||       ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
| rowspan=1 |Pipes*   ||Pipes     ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}  
|- 
| rowspan=1 |Horns*   ||Horn      ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|}

===Percussion===
{|class="wikitable sortable"
! rowspan=2 | Part
! rowspan=2 | Component name
! colspan=8 | Materials
|-
<!-- ! Materials -->
! Leather
! Wood
! Bone
! Ceramic
! Metal
! Glass
! Stone
! Shell
|-
<!--              Part | Component | Leather | Wood | Bone | Ceramic | Metal | Glass | Stone | Shell -->
| rowspan=1 |Stand    ||Stand     ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}
|-
| rowspan=8 |Body*    ||Drum      ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}  
|-
|<!--                -->Chime     ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
|<!--                -->Block     ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|- 
|<!--                -->Bowl      ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
|<!--                -->Triangle  ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
|<!--                -->Bell      ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
|<!--                -->Bar       ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
|<!--                -->Ring      ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
| rowspan=1 |Head     ||Head      ||   {{Y}}||     ||     ||        ||      ||      ||      ||
|-
| rowspan=3 |Mallet   ||Mallet    ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
|<!--                -->Hammer    ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
|<!--                -->Stick     ||        ||{{Y}}||{{Y}}||   {{Y}}|| {{Y}}|| {{Y}}|| {{Y}}|| {{Y}} 
|-
|}

: * refers to the "main" part of the instrument - see explanation, above.

==Realism==
{{D for Dwarf}}
Due to the procedurally-generated nature of the instruments, it can be expected to see some resemblance to certain real-world instruments such as organs, as many large stationary instruments will include metal pipes and various keyboards as components. It should also be noted that dwarven ingenuity can create instruments that could not be considered playable in the real world, such as the Kat: a small hand-held percussion instrument consisting of a metal block. The "musician" shakes the block. The instrument has a single high pitch.
Due to the block's only means of producing this high pitch being the displacement of air as it is shaken, it can be inferred that the dwarf shakes the block at several kHz, providing a great source of strength and endurance based [[cross-training]] for [[military]] dwarves.

{{gamedata|title=Single-part instrument - example raws (as extracted from world.dat)|item_layer

[OBJECT:ITEM]

[ITEM_INSTRUMENT:ENT51_INW2]
	[GENERATED]
	[SOURCE_ENID:51]
	[NAME:ushlub:ushlub]
	[VALUE:50]
	[SIZE:19000]
	[MATERIAL_SIZE:3]
	[BONE_MAT]
	[SOUND_PRODUCTION:BLOW_AGAINST_FIPPLE:SELF]
	[PITCH_CHOICE:STOPPING_HOLE_KEY:SELF]
	[VOLUME_mB:0:10000]
	[PITCH_RANGE:-1650:2350]
	[TIMBRE:NOISY:FULL:DARK]
	[MUSIC_SKILL:PLAY_WIND_INSTRUMENT]
	[DESCRIPTION:The ushlub is a mid-size hand-held cylindrical bore bone wind instrument with a flared bell. The musician blows into the fipple at one end. The musician selects the pitch by pressing keys to stop holes. The instrument has a three-octave range going from a mid-low to a high pitch. The instrument has a noisy full dark timbre.]
}}

{{gamedata|title=Multi-part instrument - example raws (as extracted from world.dat)|item_layer

[OBJECT:ITEM]

[ITEM_TOOL:ENT51_INS1_BODY]
	[GENERATED]
	[SOURCE_ENID:51]
	[NO_DEFAULT_JOB]
	[INCOMPLETE_ITEM]
	[UNIMPROVABLE]
	[NAME:etes body:etes bodies]
	[VALUE:10]
	[METAL_MAT]
	[TILE:155]
	[UNIMPROVABLE]
	[SIZE:34200]
	[MATERIAL_SIZE:3]
	[DESCRIPTION:The etes body of the instrument vibrates with strings, producing sound.]

item_layer

[OBJECT:ITEM]

[ITEM_TOOL:ENT51_INS1_STRINGS]
	[GENERATED]
	[SOURCE_ENID:51]
	[NO_DEFAULT_JOB]
	[INCOMPLETE_ITEM]
	[UNIMPROVABLE]
	[NAME:etes strings:etes strings]
	[VALUE:10]
	[METAL_MAT]
	[TILE:155]
	[UNIMPROVABLE]
	[SIZE:1800]
	[MATERIAL_SIZE:3]
	[DESCRIPTION:The etes strings vibrate, causing the instrument to produe sound.]

item_layer

[OBJECT:ITEM]

[ITEM_TOOL:ENT51_INS1_PROD]
	[GENERATED]
	[SOURCE_ENID:51]
	[NO_DEFAULT_JOB]
	[INCOMPLETE_ITEM]
	[UNIMPROVABLE]
	[NAME:etes bow:etes bows]
	[VALUE:10]
	[WOOD_MAT]
	[TILE:155]
	[UNIMPROVABLE]
	[SIZE:2000]
	[MATERIAL_SIZE:3]
	[DESCRIPTION:The etes bow is drawn across the strings of the instrument.]

item_layer

[OBJECT:ITEM]

[ITEM_INSTRUMENT:ENT51_INS1]
	[GENERATED]
	[SOURCE_ENID:51]
	[NAME:etes:etes]
	[VALUE:50]
	[SIZE:36000]
	[DOMINANT_MATERIAL_PIECE:BODY]
	[INSTRUMENT_PIECE:BODY:ENT51_INS1_BODY:body:bodies:STANDARD]
	[INSTRUMENT_PIECE:STRINGS:ENT51_INS1_STRINGS:strings:strings:ALWAYS_PLURAL]
	[INSTRUMENT_PIECE:PROD:ENT51_INS1_PROD:bow:bows:STANDARD]
	[VOLUME_mB:0:10000]
	[SOUND_PRODUCTION:BOWED:PROD:STRINGS]
	[PITCH_CHOICE:SUBPART_CHOICE:STRINGS]
	[PITCH_RANGE:-3240:3360]
	[TUNING:PEGS:STRINGS]
	[TIMBRE:VIBRATING:BRITTLE:STRIDENT]
	[MUSIC_SKILL:PLAY_STRINGED_INSTRUMENT]
	[DESCRIPTION:The etes is a large hand-held metal-stringed instrument with a metal body. The instrument rests flat as the musician plays the fifty-six main strings with a wooden bow. A drone string is occasionally plucked. Tuning is accomplished by pegs. The instrument has a five-and-a-half octave range going from a very low to a very high pitch. The instrument has a vibrating brittle strident timbre.]
}}

{{Category|Items}}
[[ru:Instrument]]