Dwarf Fortress Wiki - User contributions [en]

Utility:SoundSense

2012-08-13T21:26:52Z

CJN: formating.

=SoundSense=

SoundSense is a sound-engine tool for Dwarf Fortress. It plays sounds based on what entries appear in the gamelog.txt.[http://df.zweistein.cz/soundsense/ "Dwarf Fortress: SoundSense"]

Discussion: http://www.bay12forums.com/smf/index.php?topic=60287.0

Homepage: http://df.zweistein.cz/soundsense/

==Installation==

Installing and configuring software can be intimidating if you are not an IT nerd. And this
is no exception with SoundSense. But bear with me and it can actually be pretty easy.

'''Non-scary instructions:'''

* Install the java runtime 7. Get it [http://www.oracle.com/technetwork/java/javase/downloads/jre-7u3-download-1501631.html here].
* Download and extract SoundSense (It does not matter where.)
* Download soundpack.zip and extract the "packs" folder to SoundSense directory
* Run soundsense.cmd or soundsense.exe

First, you need to have the java runtime installed. It can be downloaded from the java
homepage. To determine if your computer already has the correct installation of java, go
to the Start button, left click "Run..." from the bottom of the menu, type in "cmd" in the
dialog that opens, and press the [OK] button. A dark windows pops up and you will be at a
command prompt. Type in "java -version" and press [Enter].

A few lines starting with [java version "1.7.0_03"] or something similar should apear. If
that case is the case, you are good to go. But if you see [java version "1.6.x_xx" or an
earlier version (lower number), you will need to download and install the latest java.

If something similar to ['java' is not recognized as an internal or external command]
appears, either java has not been installed yet or it was not installed correctly. If
your case is the latter, it may be possible to work around the problem by editing the
soundSense.cmd (in your SoundSense directory). Open it with Notepad and find line line
starting with "java -Dja..." and replace the "java" part with the full path for your java
installation. For example: "C:\Program Files\Java\jdk1.6.0_20\bin\java.exe"

That was the hard part.

Now, where to install it? SoundSense expects to be in a sub-directory that is inside your
Dwarf Fortress directory. So, for example, if you have Dwarf Fortress in F:/df_31_18_win/,
you should unpack the contents of SoundSense zip to F:/df_31_18_win/soundsense/. By
default, you want to make sure that the .cmd file you use to launch SoundSense is inside a
sub-directory of (i.e., below) the DF folder where gamelog.txt is located.

If you want to install to a different location, you need to edit configuration.xml and
edit the <gamelog path="../gamelog.txt"/> line. Replace "../gamelog.txt" with the path to
where Dwarf Fortress is located. For example: "F:/df_31_18_win/gamelog.txt"

SoundSense is now all set up and ready to run. But you still need the actual sounds and
music that it will play. So download soundpack.zip and unzip the "packs" directory and all
the contents inside that to the SoundSense directory.

You can start SoundSense by launching (double left-clicking) either soundSense.cmd or
soundSenseExe.cmd. (Using the latter should give you clearer error messages regarding a
bad java installation.) If you like, you can create a shortcut to soundSense.cmd, rename
it "SoundSense" and move it to your desktop for easy access.

Finally, remember that SoundSense needs to run in the background. Ideally, you should
start SoundSense BEFORE you start Dwarf Fortress.

==Known Issues==

===Moments of Silence===

Occationally, the music in SoundSense will stop for a short period (10, 20, or 30 seconds)
before resuming. This is not a bug - it is intentional. This was done to let ears rest a
bit between tracks. (Research shows that ears which get a rest have time to recover and
are less likely to be damaged.) Also, a few tracks have a silent start and, at low volume,
may take a minute or longer to become audible. If in doubt, you can see what is currently
playing in GUI under the volume slider. During periods of silence, this will typically
show "10s silence" or similar.

===Game Loads and the Music is Random===

When a game is loaded, SoundSense picks a random seasonal music track to play. This is not
a bug - it is intentional. There is no way for SoundSense to detect what season it is when
a game is loaded, so a random soundtrack is chosen. But when the season next changes, it
will choose the correct soundtrack.

===Adventure Mode - A Bit Lacking===

Adventure Mode kind of works. The battle sounds function quite well because they are
mostly the same as those in Fortress Mode. But SoundSense is still a bit lacking in other
adventure sounds. The problem is that Adventure Mode does not log many other usefull
events. For example, encountering a megabeast or a quest mob is resolved in chat, leaving
no message in the game log to trigger SoundSense.

Improvements in how DF handles logging could benfit both SoundSense and DF as a whole.
Such suggestions have already been posted in the official Dwarf Fortress forums:
http://www.bay12forums.com/smf/index.php?topic=64834.0

===Event Detection: Better Late Than Never?===

In some cases, by the time SoundSense detects conditions to trigger an alert, it may be
too late to react to the situation. For example, a "Tantrum Spiral" might already be over
before the player can be alerted.

Part of this is a balance between detecting too many false positives and ignoring events
until it is too late to do anything. For example, a soldier might lose a pet and report
feeling like blowing off some steam... but instead of throwing a tantrum they calm down.

Another problem is FPS sensitivity. A specific sequence of events may trigger certain
alert sounds in a high FPS situation, but it might not trigger with low FPS. The sequence
of events might "time out". Also, pausing the game could cause similar problems.

===Compatible With DF Mods - Should Work, But NO PROMISES===

SoundSense was mainly designed for "vanilla" (unmodified) Dwarf Fortress. It should work
fine with most mods. However, I can not guarantee compatibility. Some mods, especially
"major" or "full conversions", may create unusual behavior and involve dangerous events
that SoundSense was not designed to detect.

Another words, SoundSense may lack sounds for certain mod-specific events. (E.g.; you
should NOT expect SoundSense to include gunshot sounds for mods that add guns! But you CAN
modify SoundSense yourself to do this.) Conversely, some events that work normally in
vanilla DF may trigger so frequently with a mod as to be very annoying.

===On some Linux===

====Error on 'soundSense.sh' call: "/bin/sh^M : wrong interpret"====

File "soundSense.sh" has CR+LF characters at lines ending.
Convert these characters to a more suitable form, with a tool like "[http://en.wikipedia.org/wiki/Unix2dos dos2unix]":
dos2unix soundSense.sh
Shell script should then be run without previous error.

Also using sed you can try this:
# IN UNIX ENVIRONMENT: convert DOS newlines (CR/LF) to Unix format.
sed -i -e 's/\r$//' ./soundSense.sh
IF launching .sh file after that, says that something is wrong on the last line, when you try to launch sh. Just check, if "fi" is present there instead of "f" or smth like that.

====Error at playing any MP3 file: "javax.sound.sampled.UnsupportedAudioFileException: could not get audio input stream from input file: could not get audio input stream from input file"====

Your Java virtual machine failed at reading MP3 files as audio stream. This could fix by adding to JVM an extra plugin: [http://www.oracle.com/technetwork/java/javase/download-137625.html JMF MP3 Plugin].
Download plugin, and put *.jar files into your JVM "lib/ext/" directory.

====Error at playing any MP3 file: "javax.sound.sampled.LineUnavailableException: Audio Device Unavailable"====

Whereas your JVM succeeded in reading MP3 file as audio stream, it failed to access to an audio device. If your audio system uses [http://fr.wikipedia.org/wiki/Advanced_Linux_Sound_Architecture Alsa], you could install "aoss" utility, and "soundSense.sh" will call it. On Debian, package "alsa-oss" provides this utility. '''Note: if you are on Ubuntu see below'''. Ubuntu uses PulseAudio backend, therefore toying with aoss is a waste of time.

On a MacOS (snow leopard), this problem has been solved by changing the format of all the sound files to ogg.

====I'm using PulseAudio and I still can't hear anything!====

First, '''be sure that you are using OpenJDK 7'''; you can't use OpenJDK 6 as it has quite a serious bug in its ALSA backend[http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6271108]. You can check what java you have installed by typing
java -version
in the terminal. You can install OpenJDK like this in Ubuntu:
sudo apt-get install openjdk-7-jdk
sudo update-alternatives --set java /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java
('''The "update-alternatives" command will only work on 64bit Ubuntu'''; for 32bit version you need to replace the "amd64" with "i386" or something like that'''.)

Now, check the
/etc/java-7-openjdk/sound.properties
file for this:
# OpenJDK on Ubuntu is configured to use PulseAudio by default
javax.sound.sampled.Clip=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
javax.sound.sampled.Port=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
javax.sound.sampled.SourceDataLine=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
javax.sound.sampled.TargetDataLine=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider

# PulseAudio not running? Please give feedback on LP: #407299.
#javax.sound.sampled.Clip=com.sun.media.sound.DirectAudioDeviceProvider
#javax.sound.sampled.Port=com.sun.media.sound.PortMixerProvider
#javax.sound.sampled.SourceDataLine=com.sun.media.sound.DirectAudioDeviceProvider
#javax.sound.sampled.TargetDataLine=com.sun.media.sound.DirectAudioDeviceProvider

'''This will not work''', as OpenJDK's PulseAudio backend is buggy as hell. What you need to do is to comment out the PulseAudio and turn back on the old backend:

# OpenJDK on Ubuntu is configured to use PulseAudio by default
#javax.sound.sampled.Clip=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
#javax.sound.sampled.Port=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
#javax.sound.sampled.SourceDataLine=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
#javax.sound.sampled.TargetDataLine=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider

# PulseAudio not running? Please give feedback on LP: #407299.
javax.sound.sampled.Clip=com.sun.media.sound.DirectAudioDeviceProvider
javax.sound.sampled.Port=com.sun.media.sound.PortMixerProvider
javax.sound.sampled.SourceDataLine=com.sun.media.sound.DirectAudioDeviceProvider
javax.sound.sampled.TargetDataLine=com.sun.media.sound.DirectAudioDeviceProvider

This should make the sound work. (If you don't know how to edit this then try typing "sudo nano /etc/java-7-openjdk/sound.properties" in the terminal.)

If you're using Sun/Oracle's JRE then switch to OpenJDK. If you don't want to do that (not recommended) then you might try to use the padsp wrapper or install osspd. If the padsp wrapper will not work properly for you then osspd daemon might just do the trick. (''[https://wiki.archlinux.org/index.php/Pulseaudio#OSS Archlinux Pulseaudio user]'')

===Any Other Issues? Post Feedback===

There is a thread at the official Dwarf Fortress forums. Feel free to post any issues,
suggestions, and contributions there:
http://www.bay12forums.com/smf/index.php?topic=60287.0

When providing feedback about your experience with SoundSense, please specify which mods
(if any) you are using. If SoundSense seems to behave weirdly only for you, it just might
be from using certain mods.

==Customization==

You can insert additional sounds and music into SoundSense by adding entries to an .xml
configuration file. logPattern="regexp" is a regular expression which, if matched, will
cause a random soundFile from a list to be played. (Details on how java uses regular
expressions: http://download.oracle.com/javase/1.4.2/docs/api/java/util/regex/Pattern.html )

===Sound element attributes:===

* ''logPattern'' - regular expression matching log line (see link above)
* ''channel'' - string; Specifies a channel on which sound is played. Sounds played on a channel can be looped or stopped prematurely.
* ''loop'' - string; Specifying "start" will start looping a sound on a channel until an expression with "stop" is triggered or until a different loop sound is played on the same channel. (If a non-looped sound is triggered on the same channel, this loop will resume when the non-looped is done playing.)
* ''concurency'' - number; The number of concurrent (i.e., simultaneous) sounds allowed to be played besides this sound. If SoundSense is currently playing more than this, the sound is ignored. The default is unlimited.
* ''timeout'' - number; This initiates a time out during which this particular sound is prevented from playing again. This is measured in milliseconds and the default is 0.
* ''delay'' - number; Adds a delay before the sound is played. This is measured in milliseconds and the default is 0.
* ''haltOnMatch'' - boolean; If this is set to True and more than one equivalent logPattern exists, SoundSense will only process the first logPattern expression. If it is False, it will continue to process matching (e.g., identical) logPatterns. The default is True.
* ''speech'' - boolean; If this is set to True, SoundSense will echo the gamelog text line (containing the logPattern) with a speech synthesizer instead of playing a sound. The default is False.
* ''playbackThreshhold'' - number, 0-4, defines level of filter which is applied to this sound.

===SoundFile element attributes:===

* ''fileName'' - the path to and name of the sound/music file
* ''weight'' - number; This controls the likelihood of a sound being chosen. Default is 100.
* ''volumeAdjustment'' - number; This can be used to adjust the volume of the sample. The value can range from -40 to +6 decibles and the default is 0.
* ''randomBalance'' - boolean, if set to true will randomply distribute sound betweem stereo channels.
* ''balanceAdjustment'' - number, adjusts stereo channel, can range for -1 (full left) to 1 (full right).

SoundSense supports these audio formats for soundFiles:

* mp3 (SoundSense can normalize the sound volume with this format)
* ogg (works, but SoundSense can not normalize the sound volume)
* wav (See note below. SoundSense only supports "Windows PCM" encoded .wav files)
* aiff
* au

Note: Not all .wav files are supported...

SoundSense supports .wav encoded in the "Windows PCM" format. However, some files with the
.wav extention are actually encoded in some other proprietary format. A sound format
conversion utility (such as FormatFactory) could be used to fix them.

===Some Tips:===

; Control of Randomness: Each logPattern expression can contain several soundFile elements. When it is triggered, one of them is randomly chosen to play. You can control the probability of each sound being chosen by adding the weight="number" attribute.
; Simultaneous Sounds: By default, only one sound will play for a given logPattern, even if there are several expression using identical logPatterns. (Only the first expression is processed.) But you can allow more than one sound to be played for same pattern by giving the first one the haltOnMatch="false" attribute. They will all start at same time (unless one or more of them also has a delay). An example is in Seasons.
; Sequential Sounds: Two (or more) sounds can be played sequentially (one after the other) for the same logPattern by using the haltOnMatch="false" tip above and including a delay attribute for one of them with a delay that surpasses the length of the other.

===Helpful files:===

* packSkeletons.zip ( http://df.zweistein.cz/soundsense/packSkeletons.zip ) - This contains .xml files for all known gamelog lines currently without sounds. You can use this as a starting point to expand SoundSense.
* missingMessages.cmd - Run this program to parse your gamelog.txt file and output all lines your sound packs will not recognize.
* logging.properties - Edit this file to enable more debug messages from SoundSense. Set ".level = ALL" to view a very verbose output.

===Sources of sound & music:===

The following are some sites of interest, should you want additional sounds/music.
(Websites with free, creative commons, public domain, and/or GNU GPL licensed audio):

*http://soundbible.com/
*http://www.freesound.org/searchText.php
*http://www.musopen.org/
*http://opengameart.org/browse/audio
*http://www.incompetech.com/m/c/royalty-free/
*http://ccmixter.org
*http://free-loops.com/
*http://www.pdsounds.org/
*http://commons.wikimedia.org/wiki/Category:Sound
*http://www.archive.org/details/opensource_audio
*http://publicdomainaudiovideo.blogspot.com/

===How to add music to seasonal playlist:===

It is rather easy. Locate '''seasons.xml''' in ''soundpack/seasons'' directory.

This file contains definition of two sets of sounds: First, there are four definitions for playing voiced anouncements (''<sound logPattern="Spring has arrived!" haltOnMatch="false" playbackThreshhold="3">'') which are not interesting and should be left alone.

Seccond are main defintions of season music which start with ''<sound logPattern="(Spring has arrived!)|(Spring has arrived on the calendar\.)" loop="start" channel="music" playbackThreshhold="0">''.

You can simply add new ''<soundFile fileName="'''Name of your.mp3'''"/>'' and put it in seasons directory.
[[ru:SoundSense]]

Utility:SoundSense

2012-08-13T21:26:15Z

CJN: At least provide a brief description on what the utility does!

=SoundSense=

"SoundSense is a sound-engine tool for Dwarf Fortress. It plays sounds based on what entries appear in the gamelog.txt."[http://df.zweistein.cz/soundsense/ "Dwarf Fortress: SoundSense"]

Discussion: http://www.bay12forums.com/smf/index.php?topic=60287.0
Homepage: http://df.zweistein.cz/soundsense/

==Installation==

Installing and configuring software can be intimidating if you are not an IT nerd. And this
is no exception with SoundSense. But bear with me and it can actually be pretty easy.

'''Non-scary instructions:'''

* Install the java runtime 7. Get it [http://www.oracle.com/technetwork/java/javase/downloads/jre-7u3-download-1501631.html here].
* Download and extract SoundSense (It does not matter where.)
* Download soundpack.zip and extract the "packs" folder to SoundSense directory
* Run soundsense.cmd or soundsense.exe

First, you need to have the java runtime installed. It can be downloaded from the java
homepage. To determine if your computer already has the correct installation of java, go
to the Start button, left click "Run..." from the bottom of the menu, type in "cmd" in the
dialog that opens, and press the [OK] button. A dark windows pops up and you will be at a
command prompt. Type in "java -version" and press [Enter].

A few lines starting with [java version "1.7.0_03"] or something similar should apear. If
that case is the case, you are good to go. But if you see [java version "1.6.x_xx" or an
earlier version (lower number), you will need to download and install the latest java.

If something similar to ['java' is not recognized as an internal or external command]
appears, either java has not been installed yet or it was not installed correctly. If
your case is the latter, it may be possible to work around the problem by editing the
soundSense.cmd (in your SoundSense directory). Open it with Notepad and find line line
starting with "java -Dja..." and replace the "java" part with the full path for your java
installation. For example: "C:\Program Files\Java\jdk1.6.0_20\bin\java.exe"

That was the hard part.

Now, where to install it? SoundSense expects to be in a sub-directory that is inside your
Dwarf Fortress directory. So, for example, if you have Dwarf Fortress in F:/df_31_18_win/,
you should unpack the contents of SoundSense zip to F:/df_31_18_win/soundsense/. By
default, you want to make sure that the .cmd file you use to launch SoundSense is inside a
sub-directory of (i.e., below) the DF folder where gamelog.txt is located.

If you want to install to a different location, you need to edit configuration.xml and
edit the <gamelog path="../gamelog.txt"/> line. Replace "../gamelog.txt" with the path to
where Dwarf Fortress is located. For example: "F:/df_31_18_win/gamelog.txt"

SoundSense is now all set up and ready to run. But you still need the actual sounds and
music that it will play. So download soundpack.zip and unzip the "packs" directory and all
the contents inside that to the SoundSense directory.

You can start SoundSense by launching (double left-clicking) either soundSense.cmd or
soundSenseExe.cmd. (Using the latter should give you clearer error messages regarding a
bad java installation.) If you like, you can create a shortcut to soundSense.cmd, rename
it "SoundSense" and move it to your desktop for easy access.

Finally, remember that SoundSense needs to run in the background. Ideally, you should
start SoundSense BEFORE you start Dwarf Fortress.

==Known Issues==

===Moments of Silence===

Occationally, the music in SoundSense will stop for a short period (10, 20, or 30 seconds)
before resuming. This is not a bug - it is intentional. This was done to let ears rest a
bit between tracks. (Research shows that ears which get a rest have time to recover and
are less likely to be damaged.) Also, a few tracks have a silent start and, at low volume,
may take a minute or longer to become audible. If in doubt, you can see what is currently
playing in GUI under the volume slider. During periods of silence, this will typically
show "10s silence" or similar.

===Game Loads and the Music is Random===

When a game is loaded, SoundSense picks a random seasonal music track to play. This is not
a bug - it is intentional. There is no way for SoundSense to detect what season it is when
a game is loaded, so a random soundtrack is chosen. But when the season next changes, it
will choose the correct soundtrack.

===Adventure Mode - A Bit Lacking===

Adventure Mode kind of works. The battle sounds function quite well because they are
mostly the same as those in Fortress Mode. But SoundSense is still a bit lacking in other
adventure sounds. The problem is that Adventure Mode does not log many other usefull
events. For example, encountering a megabeast or a quest mob is resolved in chat, leaving
no message in the game log to trigger SoundSense.

Improvements in how DF handles logging could benfit both SoundSense and DF as a whole.
Such suggestions have already been posted in the official Dwarf Fortress forums:
http://www.bay12forums.com/smf/index.php?topic=64834.0

===Event Detection: Better Late Than Never?===

In some cases, by the time SoundSense detects conditions to trigger an alert, it may be
too late to react to the situation. For example, a "Tantrum Spiral" might already be over
before the player can be alerted.

Part of this is a balance between detecting too many false positives and ignoring events
until it is too late to do anything. For example, a soldier might lose a pet and report
feeling like blowing off some steam... but instead of throwing a tantrum they calm down.

Another problem is FPS sensitivity. A specific sequence of events may trigger certain
alert sounds in a high FPS situation, but it might not trigger with low FPS. The sequence
of events might "time out". Also, pausing the game could cause similar problems.

===Compatible With DF Mods - Should Work, But NO PROMISES===

SoundSense was mainly designed for "vanilla" (unmodified) Dwarf Fortress. It should work
fine with most mods. However, I can not guarantee compatibility. Some mods, especially
"major" or "full conversions", may create unusual behavior and involve dangerous events
that SoundSense was not designed to detect.

Another words, SoundSense may lack sounds for certain mod-specific events. (E.g.; you
should NOT expect SoundSense to include gunshot sounds for mods that add guns! But you CAN
modify SoundSense yourself to do this.) Conversely, some events that work normally in
vanilla DF may trigger so frequently with a mod as to be very annoying.

===On some Linux===

====Error on 'soundSense.sh' call: "/bin/sh^M : wrong interpret"====

File "soundSense.sh" has CR+LF characters at lines ending.
Convert these characters to a more suitable form, with a tool like "[http://en.wikipedia.org/wiki/Unix2dos dos2unix]":
dos2unix soundSense.sh
Shell script should then be run without previous error.

Also using sed you can try this:
# IN UNIX ENVIRONMENT: convert DOS newlines (CR/LF) to Unix format.
sed -i -e 's/\r$//' ./soundSense.sh
IF launching .sh file after that, says that something is wrong on the last line, when you try to launch sh. Just check, if "fi" is present there instead of "f" or smth like that.

====Error at playing any MP3 file: "javax.sound.sampled.UnsupportedAudioFileException: could not get audio input stream from input file: could not get audio input stream from input file"====

Your Java virtual machine failed at reading MP3 files as audio stream. This could fix by adding to JVM an extra plugin: [http://www.oracle.com/technetwork/java/javase/download-137625.html JMF MP3 Plugin].
Download plugin, and put *.jar files into your JVM "lib/ext/" directory.

====Error at playing any MP3 file: "javax.sound.sampled.LineUnavailableException: Audio Device Unavailable"====

Whereas your JVM succeeded in reading MP3 file as audio stream, it failed to access to an audio device. If your audio system uses [http://fr.wikipedia.org/wiki/Advanced_Linux_Sound_Architecture Alsa], you could install "aoss" utility, and "soundSense.sh" will call it. On Debian, package "alsa-oss" provides this utility. '''Note: if you are on Ubuntu see below'''. Ubuntu uses PulseAudio backend, therefore toying with aoss is a waste of time.

On a MacOS (snow leopard), this problem has been solved by changing the format of all the sound files to ogg.

====I'm using PulseAudio and I still can't hear anything!====

First, '''be sure that you are using OpenJDK 7'''; you can't use OpenJDK 6 as it has quite a serious bug in its ALSA backend[http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6271108]. You can check what java you have installed by typing
java -version
in the terminal. You can install OpenJDK like this in Ubuntu:
sudo apt-get install openjdk-7-jdk
sudo update-alternatives --set java /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java
('''The "update-alternatives" command will only work on 64bit Ubuntu'''; for 32bit version you need to replace the "amd64" with "i386" or something like that'''.)

Now, check the
/etc/java-7-openjdk/sound.properties
file for this:
# OpenJDK on Ubuntu is configured to use PulseAudio by default
javax.sound.sampled.Clip=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
javax.sound.sampled.Port=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
javax.sound.sampled.SourceDataLine=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
javax.sound.sampled.TargetDataLine=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider

# PulseAudio not running? Please give feedback on LP: #407299.
#javax.sound.sampled.Clip=com.sun.media.sound.DirectAudioDeviceProvider
#javax.sound.sampled.Port=com.sun.media.sound.PortMixerProvider
#javax.sound.sampled.SourceDataLine=com.sun.media.sound.DirectAudioDeviceProvider
#javax.sound.sampled.TargetDataLine=com.sun.media.sound.DirectAudioDeviceProvider

'''This will not work''', as OpenJDK's PulseAudio backend is buggy as hell. What you need to do is to comment out the PulseAudio and turn back on the old backend:

# OpenJDK on Ubuntu is configured to use PulseAudio by default
#javax.sound.sampled.Clip=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
#javax.sound.sampled.Port=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
#javax.sound.sampled.SourceDataLine=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider
#javax.sound.sampled.TargetDataLine=org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider

# PulseAudio not running? Please give feedback on LP: #407299.
javax.sound.sampled.Clip=com.sun.media.sound.DirectAudioDeviceProvider
javax.sound.sampled.Port=com.sun.media.sound.PortMixerProvider
javax.sound.sampled.SourceDataLine=com.sun.media.sound.DirectAudioDeviceProvider
javax.sound.sampled.TargetDataLine=com.sun.media.sound.DirectAudioDeviceProvider

This should make the sound work. (If you don't know how to edit this then try typing "sudo nano /etc/java-7-openjdk/sound.properties" in the terminal.)

If you're using Sun/Oracle's JRE then switch to OpenJDK. If you don't want to do that (not recommended) then you might try to use the padsp wrapper or install osspd. If the padsp wrapper will not work properly for you then osspd daemon might just do the trick. (''[https://wiki.archlinux.org/index.php/Pulseaudio#OSS Archlinux Pulseaudio user]'')

===Any Other Issues? Post Feedback===

There is a thread at the official Dwarf Fortress forums. Feel free to post any issues,
suggestions, and contributions there:
http://www.bay12forums.com/smf/index.php?topic=60287.0

When providing feedback about your experience with SoundSense, please specify which mods
(if any) you are using. If SoundSense seems to behave weirdly only for you, it just might
be from using certain mods.

==Customization==

You can insert additional sounds and music into SoundSense by adding entries to an .xml
configuration file. logPattern="regexp" is a regular expression which, if matched, will
cause a random soundFile from a list to be played. (Details on how java uses regular
expressions: http://download.oracle.com/javase/1.4.2/docs/api/java/util/regex/Pattern.html )

===Sound element attributes:===

* ''logPattern'' - regular expression matching log line (see link above)
* ''channel'' - string; Specifies a channel on which sound is played. Sounds played on a channel can be looped or stopped prematurely.
* ''loop'' - string; Specifying "start" will start looping a sound on a channel until an expression with "stop" is triggered or until a different loop sound is played on the same channel. (If a non-looped sound is triggered on the same channel, this loop will resume when the non-looped is done playing.)
* ''concurency'' - number; The number of concurrent (i.e., simultaneous) sounds allowed to be played besides this sound. If SoundSense is currently playing more than this, the sound is ignored. The default is unlimited.
* ''timeout'' - number; This initiates a time out during which this particular sound is prevented from playing again. This is measured in milliseconds and the default is 0.
* ''delay'' - number; Adds a delay before the sound is played. This is measured in milliseconds and the default is 0.
* ''haltOnMatch'' - boolean; If this is set to True and more than one equivalent logPattern exists, SoundSense will only process the first logPattern expression. If it is False, it will continue to process matching (e.g., identical) logPatterns. The default is True.
* ''speech'' - boolean; If this is set to True, SoundSense will echo the gamelog text line (containing the logPattern) with a speech synthesizer instead of playing a sound. The default is False.
* ''playbackThreshhold'' - number, 0-4, defines level of filter which is applied to this sound.

===SoundFile element attributes:===

* ''fileName'' - the path to and name of the sound/music file
* ''weight'' - number; This controls the likelihood of a sound being chosen. Default is 100.
* ''volumeAdjustment'' - number; This can be used to adjust the volume of the sample. The value can range from -40 to +6 decibles and the default is 0.
* ''randomBalance'' - boolean, if set to true will randomply distribute sound betweem stereo channels.
* ''balanceAdjustment'' - number, adjusts stereo channel, can range for -1 (full left) to 1 (full right).

SoundSense supports these audio formats for soundFiles:

* mp3 (SoundSense can normalize the sound volume with this format)
* ogg (works, but SoundSense can not normalize the sound volume)
* wav (See note below. SoundSense only supports "Windows PCM" encoded .wav files)
* aiff
* au

Note: Not all .wav files are supported...

SoundSense supports .wav encoded in the "Windows PCM" format. However, some files with the
.wav extention are actually encoded in some other proprietary format. A sound format
conversion utility (such as FormatFactory) could be used to fix them.

===Some Tips:===

; Control of Randomness: Each logPattern expression can contain several soundFile elements. When it is triggered, one of them is randomly chosen to play. You can control the probability of each sound being chosen by adding the weight="number" attribute.
; Simultaneous Sounds: By default, only one sound will play for a given logPattern, even if there are several expression using identical logPatterns. (Only the first expression is processed.) But you can allow more than one sound to be played for same pattern by giving the first one the haltOnMatch="false" attribute. They will all start at same time (unless one or more of them also has a delay). An example is in Seasons.
; Sequential Sounds: Two (or more) sounds can be played sequentially (one after the other) for the same logPattern by using the haltOnMatch="false" tip above and including a delay attribute for one of them with a delay that surpasses the length of the other.

===Helpful files:===

* packSkeletons.zip ( http://df.zweistein.cz/soundsense/packSkeletons.zip ) - This contains .xml files for all known gamelog lines currently without sounds. You can use this as a starting point to expand SoundSense.
* missingMessages.cmd - Run this program to parse your gamelog.txt file and output all lines your sound packs will not recognize.
* logging.properties - Edit this file to enable more debug messages from SoundSense. Set ".level = ALL" to view a very verbose output.

===Sources of sound & music:===

The following are some sites of interest, should you want additional sounds/music.
(Websites with free, creative commons, public domain, and/or GNU GPL licensed audio):

*http://soundbible.com/
*http://www.freesound.org/searchText.php
*http://www.musopen.org/
*http://opengameart.org/browse/audio
*http://www.incompetech.com/m/c/royalty-free/
*http://ccmixter.org
*http://free-loops.com/
*http://www.pdsounds.org/
*http://commons.wikimedia.org/wiki/Category:Sound
*http://www.archive.org/details/opensource_audio
*http://publicdomainaudiovideo.blogspot.com/

===How to add music to seasonal playlist:===

It is rather easy. Locate '''seasons.xml''' in ''soundpack/seasons'' directory.

This file contains definition of two sets of sounds: First, there are four definitions for playing voiced anouncements (''<sound logPattern="Spring has arrived!" haltOnMatch="false" playbackThreshhold="3">'') which are not interesting and should be left alone.

Seccond are main defintions of season music which start with ''<sound logPattern="(Spring has arrived!)|(Spring has arrived on the calendar\.)" loop="start" channel="music" playbackThreshhold="0">''.

You can simply add new ''<soundFile fileName="'''Name of your.mp3'''"/>'' and put it in seasons directory.
[[ru:SoundSense]]

v0.31:Sedimentary layer

2010-10-24T19:29:19Z

CJN: Link to main stone layers page.

{{av}}{{Quality|Exceptional}}
'''Sedimentary stone layers''' contain {{L|hematite}}, {{L|limonite}}, {{L|magnetite}}, {{L|tetrahedrite}},
{{L|bituminous coal}}, {{L|lignite}}, and {{L|gypsum}}.

{{L|Chalk}}*, {{L|chert}}, {{L|claystone}}, {{L|conglomerate}}, {{L|dolomite}}*, {{L|limestone}}*, {{L|mudstone}}, {{L|rock salt}}, {{L|sandstone}}, {{L|siltstone}} and {{L|shale}} layers are sedimentary.
:(* These also function as {{L|flux}}.)

The name of a sedimentary layer appears white on the embark menu.

Sedimentary layers are, on average, the most economically valuable of the four {{L|stone layers}}. They are your only source of {{L|bituminous coal}} and {{L|lignite}}, vital for fueling non-{{L|magma}} forges and for the {{L|coke}} {{L|steel}}-making requires (especially if you lack {{L|tree}}s). They are much richer in {{L|iron}} {{L|ore}}s than other rock formations. Several sedimentary rocks - {{L|dolomite}}, {{L|chalk}}, and {{L|limestone}} - are {{L|flux}}es, required for {{L|steel}}-making and also being twice as valuable as normal stone, making them useful for {{L|crafts|trade goods}} or {{L|furniture}}.

(In real world geology, sedimentary {{L|stone}} is formed by sediment. The sediment collects in constantly growing heaps and the pressure at the bottom eventually forms the sediment into stone.)

==Sedimentary layers==
{{Layerlookup/layers|SEDIMENTARY}}

==Stone found in sedimentary layers==
{{Layerlookup/stones|SEDIMENTARY}}

==Gems found in sedimentary layers==
{{Layerlookup/gems|SEDIMENTARY}}

* See also: {{l|stone found everywhere}}
{{Category|Stone Layers}}

v0.31:Stories

2010-10-19T20:11:05Z

CJN: Added link to Hall of Legends story collection.

{{av}}
[[category:Stories]]

== The Hall of Legends ==

[http://www.bay12forums.com/smf/index.php?topic=41896.0 The Hall of Legends] thread at the bay12games forums is an attempt to collect links to the best Dwarf Fortress stories.

== Individual stories ==

=== [[DF2010:Stories/Bronzemurder|Illustrated battle report: Bronzemurder vs. Oggez Rashas]] ===
A masterpiece engraving of dwarves and the forgotten beast Oggez Rashas. [http://forum.rpg.net/showthread.php?t=510839 This engraving relates to the battle of the fortress of Bronzemurder].

=== Legend of the Noble Staff of Whispermines ===
The mountain home of Crystalhaven was destroyed long ago by the shrew devil Eyuca Frightcrumble the Insensitive Goad, and their bodies assembled into a grotesque pillar by her henchmen. A band of giants ransacked the the mountain home of Rainedhammers, picking over it like vultures at a dead carcass. All that remains is the mountain home of Workenjoys, which dwindles in numbers at the hands of goblin snatchers and evil dwarves from the dark fortress of Haterampart.

Too many Nobles in the last of the mountain homes. I can feel political backbiting and carefully placed snide remarks working their vile magics, and it won't be long until the threat becomes a crossbow bolt from a masked assassin. The goblins of Haterampart must be stopped, but the nobles of Workenjoys are too absorbed in petty bickering to pay the matter its due attention. So I make plans to establish a new fortress east of the goblins, and build an army to defeat them. Thus is the beginning of Whispermines. [[User:AngleWyrm|- AngleWyrm]] 02:21, 28 April 2010 (UTC)

=== The Legendary Trio, Farmer, Fishery Worker and Armourer ===
The female dwarf adventurer Thikut Bufutast came across a huge pile of bodies outside of an abandoned fortress after she had read many notes on the battles that had happened there. The notes involved four people; a fishery Worker, a guard, a farmer (named Lor Zasitsil) and an Armourer. According to the notes, they had battle millions of enemies and slain that same amount minus a few who had run away in terror. The Guard was usually unconscious for the duration of the war, but he was alive.

The three dwarves battled against hoards of goblins, imps, magma men, troglodytes, antmen, rat, goblins, you name it, they killed it. Even a dragon was foolish enough to attack them. He was successful in killing the Fishery Worker, and the farmer was left with the Armourer. When Thikut reached the massacre, it was too late. The Farmer, guard, fishery worker, and armourer were all dead, the last bodies on the pile.
After grieving for a few minutes, Thikut noticed that Lor was not quite dead, so she dragged her away from the pile and brought her back. Once Lor had been revived she slept for a short while. In that time a giant rat attacked, and Thikut defended Lor to the death, dying in the process of killing the rat. Lor briefly grieved for Thikut, and then buried her next to the bodies of her friends. Lor was happy that she had survived, and set out on her new journey, she walked up onto the bridge leading over the great river nearby the fortress, and a lampray leapt up and ripped her brain out of the back of her skull.

I guess 'Those that live by the sword, die by the sword' is true.

Lor Zasitsil's Kills:
10342

Unknown's (Fishery Worker) Kills:
3764

Unknown's (Armourer) Kills:
20343

Unknown's (Guard) Kills:
217

Thikut Bufutast's Kills:
2

"Origin"
This originated as I watched a miner discover a new fortress near my own (This was Thikut). I also found a massacre of bodies, as listed above, with two dragons. By searching the fortress and coffins, I discovered that the four that died were the last ones of the 'Shadowspiral' fortress, as it was named. It was also caused by the fact that a minor malfunction happened where the game believed Lor to be dead, but Thikut fixed it by walking over Lor's corpse. Lor then went to sleep, Thikut died defending her, and then Lor died as she migrated across to my fortress from a lampray pulling her brain out of the back of her head. Not a very suitable death for one so great. (Btw the other dragon, Sarvesh the blazing flame incinerated the Armourer after the Armourer grappled him about fifty times.)

[[User:Thikut|- Thikut]] 3:51, 31 July 2010 (AU)

=== Dwarf Flume ===

A dwarf has died 'after colliding with an obstacle?' A glitch, surely. How could a dwarf run into a wall so fast as to be killed?
'''
But then another!'''

On the third I see what is going on. A forgotten beast had earlier gone on a rampage through the fortress, destroying a door keeping back the waters of an underground river. As part of an effort to reclaim the flooded territory, drainage tunnels had been dug. Dwarves, on their way to dig more relief tunnels, were being caught up in the flow while wading - sucked through a hole in the floor into a labyrinth-like tunnel, twisting around as the water changed directions, and finally launched by the hydraulic pressure into the former water store cistern - to be smashed against the opposite wall, then dropped five levels into a pit of water.

=== No that's YOUR job ===

Momuz and Rigoth are walking from the fields, back to the new settlement. Momuz rubs his head, scowling. "Armok, I'm thirsty."

Rigoth glares and flares his nostrils. "You never drink, that's why you're thirsty. You're always going on about the prickle berry season."

"Yes, well, that's because I care about my work. Not like those jokers that called themselves the '40d' dwarves that were in here. They'd walk half way out to the berry field, then say 'you know, it's time for a drink' and you wouldn't see them for hours. Me, I'm a herbalist, and I'm serious about it."

Rigoth grunts. "Yeah, those guys weren't worth much. Oh dwarf alive. I could use a drink too."

Both dwarves enter the dining hall / tavern. All around are half dead dwarves, crying for drink.

"WE'RE SO THIRSTY" they all say.

"Yeah, well, you guys are always thirsty. Still... you're in a TAVERN... why aren't you all drinking?"

"THERE'S NO ALCOHOL!"

"Really? I didn't see any notes about that.... Why didn't you drink water? What happened to the stored water we had?"

"Stored water? You mean that time we tried making a stairwell upwards under a lake? That stored water?"

"Well yes!"

"That's not a well, that's a flooded stairway. You can't expect me to drink water from a stairway. People walk there! YOUR CAT left a dead lizard on those stairs. Plus, I never did find out where you've been going to the bathroom..."

"Oh. Well. I guess someone should make alcohol then... who's job was that anyways?"

(both dwarves drop dead)

=== "Weaponsmith and Cave Crocodile", a poem by Urist McShakeSpear. ===

This is a story about a Cave Crocodile and Tulon Olonurrïth "GearedScarred", a Weaponsmithess, who were dramatically involved into fatal relationship.

'''Chapter 1.'''

Tulon rambled at a cavern forest, looking for logs that lazy woodcutter left laying on the ground. Suddenly an unknown voice called her - "Oh, lady dwarf, it must be Providence itself that led you here! I'm an ancient dwarven prince, who has been turned into a beast by evil witch, and only the kiss of charming dwarvess can transform me back!". And a large pale cave crocodile came out of the tower-cap tree. He crawled toward her and asked politely - "Oh, will you kiss me?" 
And Tulon replied - "WHEEEEEEEEWWW! A LIZARD!!! WHEEEEEWWW!!! DON'T COME!!! I HATE LIZARDS!!! HEEEEEEEEEELP!!!!" - and ran back toward stairs back to her safe home. 
Crocodile roared - "Wait! Wait!! You can't just run away and left me here! WAIT, YOU!!!" - and rushed after her. 
... 
After several hours of chase the Crocodile finally managed to knock her down on muddy floor and said - "Well, now you have no choise but to fulfill my needs. JUST. ONE. KISS. And you can leave safely wherever you want." 
''Tulon'' - "NO! NO! GET AWAY! GET AWAY YOU SLIMY LIZARD!" 
''Crocodile'' - " NO WAY! I'll get this damned kiss, even against your will! NOW!" 
Tulon managed to stand up, but Crocodile jumped towards her with intention to get this kiss by force. He grab her head with his jaws... 
...OOOOOPS... 
The headless body of Tulon Olonurrïth slided down the muddy slope... 
''Crocodile'' - "Oh f#$k. And what now? Centures of crawling at the darkness with only one hope, and now this imbecile riuned it all. Well, at least I hope she wasn't the only female at this hamlet above. And I hope they ain't such reptile-haters" 
And Crocodile crawled to the narrow corridor. Suddenly a cage fell from above, locking him inside. 
''Crocodile'' - "Oh, GREAT..."

'''Chapter 2.'''

After several hours of awaiting a dwarf peasant came. 
''Crocodile'' - "Hey! Hey! Come here! Help me! I'm an enchanted prince, I need a woman who kiss me and transform back to dwarf form!" 
''Peasant'' - "Talking beast?! Wow! Guys up there would be glad to see that.". He grabbed the cage and hauled it up to the quarters. 
''Crocodile'' - "Hey! Did you hear that i say?! I'm a dwarf like you! Witch turned me into this! Damn, dwarfes grown REALLY dull, while i loafed down there." 
... 
''Peasant'' - "Hey! Guys! Look that i got! He is talking!" 
''Crocodile'' - "Yes, talking, you dumbass! I'm telling you I'm dwarf, only looking like Crocodile! If a dwarf girl kiss me, I'll be dwarf again!" 
''Bookkeeper'' - "Oh, I remember... I was a little boy and my granny took me to puppet show, and the fairytale was about a prince turned into a beast, and a girl must kiss him to turn him dwarf again..." 
''Crocodile'' - "Oh, finally someone who shows a bit of common sence. That is exactly that happened to me! I need help!" 
''Bookkeeper'' - "Let's put him into our meeting room, he will tell fairytales. What can be better - a nice loaf of cheese and a tale!" 
''Crocodile'' - "OH SHI~" 
''Bookkeeper'' - "We'll call him Theater Romance, he's always telling that stuff about kisses, sorcery, fate and that crap... I'll tell my wife to make nice silk curtain for him, ho-ho!"

'''Chapter 3.'''

Some days later 
''Peasant'' - "Hey, that's with our Theater? He says no word other that "F#$K OFF!". Let he tell something funny - you know, dragons, knights and that crap..." 
''Caretaker'' - "Hey, Theater! Tell us something!" 
''Crocodile'' - "I SAID - F#$K OFF! Is it too difficult for your tiny oaken brain?!" 
''Crowd sadly'' - "Oooohhhh...." 
''Peasant'' - "What for we need him then? He just eats and shits, and does nothing!" 
''Broker'' - "Guys! Take him and bring to depot. That's gonna be a brillant deal! Those merchants got planty of delicious drinks..." 
''Crowd happily'' - "Hooray!" 
''Crocodile'' - "FUUUUUUUUU~" 
Crocodile breaks from his cage and runs away, and miners armed with their picks chase him all over the fortress. After a hours or rushing, beating, biting, wrestling the Crocodile falls down breathlessly. 
''Broker'' - "Damn! Drinks!" - to the merchants packing their goods "Hey, wait a bit! We've got a lot of other cool things! Cmon, let's trade a bit more!"

'''The End.'''

'''The origin.'''

A Weaponsmith (she realy detests lizards) went to cave forest to take a wod log to stockpile, and got chased by cave crocodile. Finally the crocodile torn her head apart in a single charge, and got the name Stinhädâbir, "Theaterromance". Then he got caught into a cage trap. Later, when i wanted to sell him to merchants, he broke out of cage while it was hauled, and i had to draft all miners into squad to struck him down. --[[User:Peregarrett|Peregarrett]] 12:07, 27 May 2010 (UTC)

=== Legend of the Misunderstood Hero===

In Early Spring of 1051 Human Adventurer Conrad Casser was given an arduous task. The task was to fell Ozor Sneakconfused the guise of seers. Ozor was a unique one of a kind skink brute. His enormous Skink body was twisted into the shape of a humanoid and lived in a nearby town. Well not willing to let a demon live Conrad set off to send this Demon back to hell. The fight was long and difficult. With every broken bone and limb Conrad delivered he received as well. Then the towns guard showed up. Thank heavens back up. But, No! it was to him that the guards fell upon. It Turned out the demon was a Law giver in the kingdom of guilds. The demon used this chance to release a blast of heat and steam throwing everyone nearby every which way. The Last thought to go through Conrad's head was "But he's a demon". The last thing to go through in head physically was the town guardsmen dead body thrown by the steam. The name of the city in which the humans unknowingly consort with a demon: Dotmerged.

it wasn't till later in legends mode that i read what my biggest mistake was. Listed in the demon's entry it stated,
"in 16 Ozor fooled the kingdom of guilds into believing it was a manifestation of the deity Bekor Cataura"

I had attacked their god, and until they had interrupted, came pretty close to killing it.

40d:Stories

2010-10-19T07:59:23Z

CJN: Note that Boatmurdered older than 40d. 23a?

{{av}}
==Something Awful - Let's Play Dwarf Fortress==
'''IMPORTANT: The amount of cursing used in the following stories <s>is very bad</s> would make a dwarf's head explode. READER DISCRETION IS ADVISED.'''

===Boatmurdered===
The one that started it all. Read it [http://lparchive.org/LetsPlay/Boatmurdered/intro.html here]. (Note that Boatmurdered is from a quite old 2d version of the game, and should probably be in [[23a:Stories]] if that page gets constructed.)

===Headshoots===
The modern equivalent of Boatmurdered. Read it [http://lparchive.org/LetsPlay/Headshoots here].

===Syrupleaf===
The sequel to Headshoots, being just as epic, and even longer. Read it [http://lparchive.org/LetsPlay/Syrupleaf/index.html here].

==Archives==
*{{L|Stories/Archive 1}}
*{{L|Stories/Archive 2}}
*{{L|Stories/Archive 3}}
*{{L|Stories/Archive 4}}
*{{L|Stories/Archive 5}}
*{{L|Stories/Archive 6}}
*{{L|Stories/Archive 7}}
*{{L|Stories/Archive 8}}
*{{L|Stories/Archive 9}}
*{{L|Stories/Archive 10}}
*{{L|Stories/Archive 11}}
*{{L|Stories/Archive 12}}
*{{L|Stories/Archive 13}}
*{{L|Stories/Archive 14}}
*{{L|Stories/Archive 15}}
*{{L|Stories/Archive 16}}

[[category:Stories]]

40d:Manager

2008-09-04T16:45:14Z

CJN: minor wikifications

{{Noble
| noble=Manager
| office=Meager Office
| function=
* Manage bulk job orders
}}
The '''Manager''' is an appointed [[noble]] position. To do his/her work he/she uses the [[Organizer]] skill.

When chosing a dwarf for the position the following skills are also listed as relevant:

* [[Comedian]]
* [[Consoler]]
* [[Flatterer]]
* [[Intimidator]]
* [[Judge of intent]]
* [[Liar]]
* [[Negotiator]]
* [[Pacifier]]
* [[Persuader]]

If this position is left vacant, the Manager screen at {{K|j}} -> {{K|m}} says "A manager is required to coordinate work orders", which seems to imply that they will not be performed. Without a manager the 'Workshop {{K|P}}rofile' option won't be available on workshops.

== Changing name ==

As the population of the outpost increases, the name of the Manager's job title also changes:

* Outpost Manager: <20 dwarves
* Hamlet Manager: 20+ dwarves
* Village Manager: 50+ dwarves{{verify}}
* Town Manager: 80+ dwarves{{verify}}
* City Manager: 150+ dwarves{{verify}}
* Metropolis Manager: 220+ dwarves{{verify}}

== Setting up work orders ==

The Manager screen ({{k|u}}{{k|m}} or {{k|j}}{{k|m}}) allows you to set up work orders. This can be handy if you want to specify a precise number of items to be created, more than the few that will fit in a workshop's queue, but not just an indefinite amount, as you'd get by specifying a workshop task as a repeating task. It can also be useful because, although work orders will still be canceled if the raw materials aren't currently available, they will be added back to the workshop queue regularly until the order is finished.

== Approval of work orders ==

When the Manager presides over an Outpost that has less than 20 dwarves, the {{K|j}}ob {{K|m}}anager screen allows all orders to be assigned automatically; the game simply abstracts out the order management and the Manager probably just discusses the jobs while everyone is downing their [[dwarven ale|ale]].

However, upon becoming a Hamlet Manager, the Manager must personally verify each and every task on the manager screen; by that time, the population has grown significantly enough that the Manager must devote at least some of his time to bureaucracy. The Manager then requires an [[Office]] to perform his or her duties.

The manager screen displays the tasks the Manager has approved with a green check mark, and displays the tasks the Manager has not yet approved with a red X. Approving these tasks occurs in the Manager's Office: the Manager receives a task automatically and, after spending a short amount of time scribbling furiously, the order is approved and the craftsdwarves can get to work! Naturally, the Manager cannot be otherwise busy or else he won't be able to approve the orders. The time taken to approve the order is dependent on the Manager's [[Organizer]] skill.

== Room requirements and consolidating nobles ==

* While this noble does not require a dining room, they may eat at the chair in their office, and if so will receive a negative [[thought]] about the lack of tables. For this reason, it may be advisable to assign them a small, personal dining room, or just build a table in their office by the chair.
* The manager has the same room and furniture requirements as the [[broker]] and [[bookkeeper]]. Because all three of these nobles tend to have periodic idle time, it may be possible to have one dwarf serve all three functions, especially in the early years of a fortress.
* A dwarf will receive a negative thought if they have to conduct a meeting in a [[bedroom]]. So make sure the office does not overlap their bedroom.
[[Category:Nobles]]

40d:Appraiser

2008-09-04T10:33:05Z

CJN: Added a wiki link

{{Skill
| color = #f0f
| skill = Appraiser
| speciality = Trader
| profession = Administrator
| job name = Admin/Noble
| tasks =
* Trade at Depot
}}The appraise skill is used by the [[Outpost Broker]] [[noble]]. If the broker doesn't have at least novice skill, then it is not possible to see the values of goods being traded, only their weight. Also, the {{key|z}} [[status]] window will say "You need a broker with the appraisal skill" to show [[created wealth]] and trade information, if your brokers skill is below novice. There is no apparent advantage in having more than novice skill level and the skill is learned very fast from just looking at goods in the trade window.

When the [[dwarven economy]] is activated, shopkeepers also use the appraisal skill when selling goods.

It is gained by:
* Seeing goods for trade at the [[trade depot]]
* Successful trades at the depot
* Trading in a [[shop]]

Notable ways that it is not gained include:
* Proposing an unsuccessful trade at the depot
* Offering goods to foreign traders
* Simply being assigned as the broker noble
* Sitting around at the depot, whether there are traders there or not
* Meeting with the outpost liaison

[[Category:Skills]]
[[Category:Noble Skills]]

40d:Wound

2008-09-03T14:37:20Z

CJN: Added some wiki links.

{{old|0.23.130.23a|, the 2D version}}

[[Creatures]] with severe '''wounds''' will flash with a yellow or red + icon; see [[status icons]] for a full list of status and injury indicators. A creature's injuries can be seen by pressing {{key|w}} while {{key|v}}iewing creature info in [[Fortress Mode]], or by {{key|l}}ooking at a creature and selecting their letter in [[Adventure Mode]]. Wounds are listed by body part and described by color, as displayed in the following table.

{| border=0 cellpadding=0 cellspacing=1 style="background: black"
|-
| unhurt
|-
| lightly wounded
|-
| moderately wounded
|-
| broken
|-
| mangled
|-
| lopped off
|}

== Wounding ==

This section is incomplete; much about the [[Combat| combat system]] is unknown.

If an attack connects, the target will be wounded in some part of the body. The severity of the wound depends on 1) the strength of the attack, 2) the protective value of any [[armor]] or other protection available for that body part, and 3) a (large) random factor. Wounds are cumulative: when an already wounded body part is hit the wound will worsen, even if in adventure mode it produces the same message about the condition of the body part more than once.

The mathematics are at present pure guesswork. However, we do know that armor value does not simply subtract from damage; you can be wounded (usually lightly) by an attack substantially weaker than the protective value of your armor. Armor is vital to survivability, but it can't make you immune. Creature size is also vital; larger creatures hit harder and can endure more base damage. Attacks, especially piercing attacks with critical boosts (e.g. arrows), can damage vital internal organs located in the area of that body part.

== Effects of wounds ==

When a wound is inflicted, no matter how lightly, it will usually bleed (even if only for one turn). In [[Fortress Mode]], wounded dwarves receive various unhappy [[thoughts]], but also some positive thoughts from the rescue and recovery process (see next section).

A wounded limb or organ becomes less effective. A severe wound to an arm or hand causes held items (weapons, shields) to be dropped from that hand. Wounds to either leg often cause the target to topple over, greatly slowing it down. Pierced lungs make it easier to become Winded. Damaged internal organs often cause the victim to periodically become stunned or unconscious until they heal (which in some cases never happens).

Death from [[Blood|blood]] loss will happen quickly whenever wounds to major internal organs occur, like the heart being pierced or "entrails shooting out through the wound". In [[Adventure Mode]], a "Mortal Wound" status indicator will appear when this happens to your adventurer. There is no way to avoid this. A pierced lung doesn't always result in bleeding to death, but it may eventually cause suffocation, or dying of thirst due to Drink actions being interrupted by falling unconscious. [[Attributes#Toughness|Toughness]] may be a factor in helping to prevent this.

Other effects of wounding (for most creatures) include pain, which can cause temporary paralysis due to fainting ("giving in to pain"), [[vomit]]ing, and stunning (slowing), especially if the creature is not very Tough.

Arrows and bolts can become stuck in limbs, showing up in the wounded dwarf's inventory. This seems to prevent the dwarf from resting and the wound from healing. It is unclear what is necessary to remove the item from the limb; like other shot ammo, it will initially be in forbidden state, so claiming it may help, as may marking it to be dumped{{verify}}.

=== On organs ===

When a creature is attacked with a piercing [[weapon]] or projectile, organs might take damage. This table shows most major organs, their functions, and what happens when they are damaged.

{| border="1" cellspacing="0" cellpadding="2"
|- style="background: grey; color: black;"
! Organ !! Function !! Lightly/moderately wounded effects !! Broken/mangled effects !! Lopped off effects
|- style="background: #eee; padding: 1px;"
|| Heart || Circulatory Organ || Not possible || Fatal Heavy Bleeding when pierced, death can occur fast. ''Can only be mangled.'' || Not possible
|- style="padding: 1px;"
|| Brain || Movement || Bleeding, possibly becoming Winded. Usually not fatal || Paralysis. Weapons get dropped, limbs become useless, inability to stand. The only attack possible is 'Push' || Decapitation, or other gory head explosion effects, naturally, cause instant death.
|- style="background: #eee; padding: 1px;"
|| Throat || Breathing || Bleeding, possibly becoming Winded || Heavy Bleeding and becoming Winded. Lethality depends on Toughness || Fatal Heavy Bleeding and/or suffocation, no chance of survival.
|- style="padding: 1px;"
|| Lung(s) || Respiratory Organ(s) || Not possible || Heavy Bleeding and becoming Winded. Possible suffocation depending on toughness and number of lungs pierced. ''Can only be mangled.'' || Not possible
|- style="background: #eee; padding: 1px;"
|| Eye(s) || Visuals || Bleeding, vision is impaired if all eyes are effected. || Not possible || Heavy Bleeding. Possible extreme pain depending on Toughness and number of eyes removed. Destroys accuracy and lessens vision permanently. If all eyes are removed, the creature is completely blind, and can only "see" what's next to it (other words, 3x3 vision).
|- style="background: #eee; padding: 1px;"
|| Guts || Not known || Not possible || Fatal Heavy Bleeding (on and off) as entrails spill out, extreme pain, and nausea. Can be a slow, painful death. ''Can only be mangled.'' || The entire lower body is severed from the rest of the body or it is completely destroyed. Instant death.
|}

== Wounds in Fortress Mode ==

=== Healing ===
Dwarves with yellow or red wounds will attempt to get to a bed to [[rest]], if possible. Civilian dwarves with the [[health care]] labor will drag severely wounded dwarves to a bed and bring them [[food]] and [[bucket]]s of [[water]] as they recover. A severely injured dwarf will stay in bed, and occasionally cancel tasks to rest their injury. [[Toady]] has stated that beds which are not in any defined [[room]] are considered hospital beds, and dwarves will recover faster when sleeping on them. Dwarves with light or moderate (medium grey to brown) wounds do not need to rest.

In the current version (39c), wounded dwarves who rest are automatically labelled as "unconscious". Unlike the previous versions, this does not prevent the other dwarves from bringing them food and water.

Generally, light or moderate wounds will be healed in a week at most, usually much faster. Broken body parts will likely take some months of bed rest to recover, and a mangled part can take years. Severed limbs do not grow back.

Yellow or red wounds have a chance to heal on [[season]] changes. The likelihood of yellow or red wounds making a recovery is quite variable. Limbs are more likely to eventually heal than internal organs. In some cases, a badly wounded dwarf will not recover at all.

Wounds to the nervous system (the neck, brain, or spine) will never heal. If these wounds are not too severe the dwarf will be able to continue his daily routine without any problems. Military dwarves with nervous wounds will never spar, however. Melee dwarves with nervous injuries may still be valulable as a Marksdwarf. If a dwarf has yellow or red nervous damage, he will be a permanent invalid, and you may wish to arrange for his demise so as to prevent him from forever requiring your other dwarves to bring him food and water.

Dwarves have various [[thoughts]] from injury, unconciousness, and the healing process. Injuries cause unhappy thoughts, but these are offset by happy thoughts from getting rescued, being able to rest and recuperate (i.e. stay in bed), and being given water and food. Check for unhappy patients, as wounded dwarves have been known to go berserk when unhappy thoughts accumulate (see below). If you cannot ensure their happiness, you may have to station armed guards nearby as a precaution, or even lock the wounded dwarf in his bedroom and write him off.

Since losing consciousness due to pain can be resisted by dwarves with high Toughness, very Tough dwarves tend to survive injuries more easily. Toughness also greatly speeds up the healing process, a superdwarvenly tough (super-)dwarf can heal yellow injuries in days. Losing a Limb, however, can make even the toughest creatures give in to pain.

== Wounds in Adventure Mode ==

Healing is much simpler in [[Adventure Mode]]; walking one space on the overland map will heal everything but severed limbs, including hunger and thirst. Your <strike>friends</strike> spear-catchers will also be healed, as long as they were reasonably close to you when you left the map. If you leave them bleeding and crawling in the cave below, however, they won't come with you.

In the current version, it is observed that beginning to freeze to death during a cold night will produce blood spatters on every surface of your body and inflict minor wounds to every organ and surface possible. This includes your eyes, limiting your vision to a single square around you. This is almost certainly because of wounds in the eyes, as if you {{k|T}}ravel away you will retain the blood in your eyes but regain normal vision. A similar effect is observed if you manage to set yourself on fire, although you are also blinded and suffocated by the smoke in this case.

== Descriptions ==

In Adventure Mode, wounds will generate messages when they are inflicted. The following table lists the various messages you'll see when a wound is received. Messages corresponding to immediately fatal blows to the three major body parts (head, upper body, and lower body) are also provided. Most of these messages are displayed for organic beings only, not for skeletal, mechanical, etc. creatures.

{| border="1" cellspacing="0" cellpadding="2"
|- style="background: grey; color: black;"
! Damage type !! Lightly wounded !! Moderately wounded !! Broken !! Mangled !! Instantly fatal (head) !! Instantly fatal (upper body) !! Instantly fatal (lower body)
|- style="background: #eee; padding: 1px;"
|| Pierce || "It is pierced!" || "It is badly pierced!" || "It is broken!" || "It is mangled!" || "It is pierced through entirely!" || "It is pierced through completely!" || "It is run through!"
|- style="padding: 1px;"
|| Bludgeon || "It is bruised!" || "It is battered!" || "It is broken!" || "It is mangled!" || "It is smashed into the body, an unrecognizable mass!" || "It collapses into a lump of gore!" || "It explodes in gore!"
|- style="background: #eee; padding: 1px;"
|| Slash || "It is cut!" || "It is badly gashed!" || "It is broken!" || "It is mangled!" || "It is split in half from the crown to the chin!" || "It is cloven asunder!" || "It is mostly cut away from the rest of the torso!"
|- style="padding: 1px;"
|| Gore || "It is torn!" || "It is badly ripped!" || "It is broken!" || "It is mangled!" || "It is torn apart!" || "It is torn into pieces!" || "It is ripped into loose shreds!"
|- style="background: #eee; padding: 1px;"
|| Burn || "It is singed!" || "It is burned!" || "It is cracked by the heat!" || "It is partially incinerated!" || "It is incinerated!" || "It is incinerated!" || "It is incinerated!"
|- style="padding: 1px;"
|| Cold || "It is chilled!" || "It is frostbitten!" || "It is cracked by the cold!" || "It is frozen through!" || "It is shattered!" || "It is shattered!" || "It is shattered!"
|- style="background: #eee; padding: 1px;"
|| Heat || "It is blistered!" || "It is charred!" || "It is cracked by the heat!" || "It is partially incinerated!" || "It is incinerated!" || "It is incinerated!" || "It is incinerated!"
|}

If the major body part was "lopped off", which is different than just having an instantly fatal wound, the message would say "The *Body part* flies off in a bloody arc!"

A creature inflicted with a fatal blow will be announced as "struck down" or, if a ranged weapon was used "shot and killed". Other death messages include "starved to death", "drowned", "fallen into a deep chasm", "burned to death", etc.

[[Category:Dwarves]]
[[Category:Military]]

40d:Dwarf fortress mode

2008-08-26T14:43:28Z

CJN: /* Compared to the 2d version */ 2d->2D

After creating a new world, most new users will play in '''fortress mode'''. In fortress mode, you pick a [[location]] in your world, then assign your seven initial [[dwarves]] some starting [[skills]] and pick items and [[animals]] to bring along. When the game starts, unlike previous versions, you will not be presented with the typical |river|field|cliff| layout that we are all used to, but instead with whatever area of the map you picked. There is a new Z axis (up and down) which you probably have to use if you picked a non mountainous area. You can get to the different layers using {{K|>}} (down) and {{K|<}} (up). To [[digging|dig]] to other layers first designate a down [[stair]]case, then go down a layer and designate and up staircase below it. You can then build [[buildings]] and [[workshops]] in the space you have dug out.

=== Selecting a site ===
The most important decision that will lead to success or failure of your fort is your starting [[location]]. Study carefully the options presented so that you select a site that you can confidently play in. Things to consider are vegetation ([[tree]]s, [[plants]]), [[water]] ([[river]]s or brooks), temperature (hot, warm, cold, freezing) and locale? (evil, terrifying, calm, sinister). There are [[volcano]]s, if you want [[magma]] then find a [[magma vent]] near a volcano. Is there an [[aquifer]] stopping you from reaching [[stone]]? What minerals do those stone layers contain?

=== Embarking ===
Selecting your dwarves and starting materials.

=== Playing ===
Your view of the in game world is that of a multi-layered environment which you can move up and down and left to right. Dwarves are represented by little smiles, rocks by blackness and sky by blueness. You have a command menu that lets you set commands that your dutiful dwarves will attempt to follow. The rest of this wiki is dedicated to helping you with these commands.

=== Losing ===
DEATH. Try to avoid this. But don't forget that [[losing]] is fun!

=== Winning ===
Not known! Set your own goals. Survival is one, set your score by how many years your dwarves can thrive for.

=== Goals ===
There aren't really many goals in this game. Any goal would be the ones you set for yourself. 
Here is a list of fun game goals to attempt: [[Game goals | List of Fun Goals]]

=== Compared to the 2D version ===
There is no promise of finding a [[underground river|Cave River]], however [[farming]] may now be performed in any [[soil]], such as loam or [[sand]]. Complex [[irrigation]] systems are required for farming on bare rock, which must first be covered in mud.

Rather than being able to expect better [[ore]] by simply digging to the right, it is now necessary to look at the geological formation of your potential fortress site to predict what kind of [[ore]], [[stone]], and [[gem]]s to expect.

[[category:Fortress mode]]

40d:Trade agreement

2008-08-22T19:51:26Z

CJN: Added category

'''Trade agreements''' are made with [[dwarf|dwarven]] and [[human]] [[civilization]]s, by meeting the [[liaison]].
Existing trade agreements can be checked by the {{k|c}} key.

[[Category:Trade]]

40d:Trade agreement

2008-08-22T19:50:13Z

CJN: New page

'''Trade agreements''' are made with [[dwarf|dwarven]] and [[human]] [[civilization]]s, by meeting the [[liaison]].
Existing trade agreements can be checked by the {{k|c}} key.

40d:Calendar

2008-08-22T19:40:29Z

CJN: /* Ages */ Removed outdated info. Added a comment on new age generation.

The dwarven '''calendar''' is used to display dates, and is visible in the upper right corner of the [[Overall Status]] screen ({{key|z}}). One year has 336 days and consists of twelve month in four seasons, with three months per season. Every month has 28 days. The months are named after kinds of [[stone]]s, [[ore]], [[gem]]s and [[wood]]. New Year's Day and the first day of [[spring]] both fall on the 1st of Granite. New Year's Eve and the last day of [[winter]] both fall on the 28th of Obsidian.

The game's first playable year begins whenever the world stops generating, due to certain parameters you or the game has set up. By default, the world will stop genning when a percentage of megabeasts are dead, currently resulting in the starting years being in the low 200s to mid 300s on average.

== Months and seasons ==

{| style="border-spacing: 0"
|-
| style="padding: 0.2em; background: #8f8" | {{tile|•|grey|#8f8}}
! style="padding: 0.2em; background: #cfc; width: 10em; text-align: left" | Granite
| style="padding: 0.2em; background: #cfc; font-size: 80%; vertical-align: middle; text-align: right" | Early-
| style="padding: 0.2em; background: #cfc" rowspan="3" | Spring
|-
| style="padding: 0.2em; background: #8f8" | {{tile|•|grey|#8f8}}
! style="padding: 0.2em; background: #cfc; width: 10em; text-align: left" | Slate
| style="padding: 0.2em; background: #cfc; font-size: 80%; vertical-align: middle; text-align: right" | Mid-
|-
|-
| style="padding: 0.2em; background: #8f8" | {{tile|•|grey|#8f8}}
! style="padding: 0.2em; background: #cfc; width: 10em; text-align: left" | Felsite
| style="padding: 0.2em; background: #cfc; font-size: 80%; vertical-align: middle; text-align: right" | Late-
|-
| style="padding: 0.2em; background: #ff8" | {{tile|*|#800|#ff8}}
! style="padding: 0.2em; background: #ffc; width: 10em; text-align: left" | Hematite
| style="padding: 0.2em; background: #ffc; font-size: 80%; vertical-align: middle; text-align: right" | Early-
| style="padding: 0.2em; background: #ffc" rowspan="3" | Summer
|-
| style="padding: 0.2em; background: #ff8" | {{tile|*|green|#ff8}}
! style="padding: 0.2em; background: #ffc; width: 10em; text-align: left" | Malachite
| style="padding: 0.2em; background: #ffc; font-size: 80%; vertical-align: middle; text-align: right" | Mid-
|-
| style="padding: 0.2em; background: #ff8" | {{tile|*|grey|#ff8}}
! style="padding: 0.2em; background: #ffc; width: 10em; text-align: left" | Galena
| style="padding: 0.2em; background: #ffc; font-size: 80%; vertical-align: middle; text-align: right" | Late-
|-
| style="padding: 0.2em; background: #f88" | {{tile|•|white|#f88}}
! style="padding: 0.2em; background: #fcc; width: 10em; text-align: left" | Limestone
| style="padding: 0.2em; background: #fcc; font-size: 80%; vertical-align: middle; text-align: right" | Early-
| style="padding: 0.2em; background: #fcc" rowspan="3" | Autumn
|-
| style="padding: 0.2em; background: #f88" | {{tile|•|grey|#f88}}
! style="padding: 0.2em; background: #fcc; width: 10em; text-align: left" | Sandstone
| style="padding: 0.2em; background: #fcc; font-size: 80%; vertical-align: middle; text-align: right" | Mid-
|-
| style="padding: 0.2em; background: #f88" | {{tile|▄|#770|#f88}}
! style="padding: 0.2em; background: #fcc; width: 10em; text-align: left" | Timber
| style="padding: 0.2em; background: #fcc; font-size: 80%; vertical-align: middle; text-align: right" | Late-
|-
| style="padding: 0.2em; background: #88f" | {{tile|•|white|#88f}}
! style="padding: 0.2em; background: #ccf; width: 10em; text-align: left" | Moonstone
| style="padding: 0.2em; background: #ccf; font-size: 80%; vertical-align: middle; text-align: right" | Early-
| style="padding: 0.2em; background: #ccf" rowspan="3" | Winter
|-
| style="padding: 0.2em; background: #88f" | {{tile|◆|white|#88f}}
! style="padding: 0.2em; background: #ccf; width: 10em; text-align: left" | Opal
| style="padding: 0.2em; background: #ccf; font-size: 80%; vertical-align: middle; text-align: right" | Mid-
|-
| style="padding: 0.2em; background: #88f" | {{tile|•|#444|#88f}}
! style="padding: 0.2em; background: #ccf; width: 10em; text-align: left" | Obsidian
| style="padding: 0.2em; background: #ccf; font-size: 80%; vertical-align: middle; text-align: right" | Late-
|}

== Ages ==

Ages are determined by the states of the world during world generation. Some of the known things that influence the ages are: number of [[megabeast]]s alive and dominant [[civilization]]s.

== Farming ==

With the changing seasons come different [[weather]] conditions, depending on your [[climate]]. A typical [[temperate]] [[mountain]]side fort will have snow in spring and winter, with warm [[summer]]s and colourful [[autumn]]s. The seasons correspond to growing seasons from the [[farm]] plot {{k|q}} menu, which dictate what can be grown when during the year. See the [[List of crops]].

[[Category:World]]