Editing Speech file

{{av}}
{{Modding}}
'''Speech files''' are text files that define sentences which can be spoken by people in [[adventure mode]] and phrases used to name [[books]]. Most of them are found in the <code>data/vanilla/vanilla_text/objects</code> folder, though the creature specific files can be found in <code>data/vanilla/vanilla_creatures/objects</code>. Like other raw files, mods can replace or introduce new sentences.

== List of files ==

{| class="wikitable"
! Textset ID !! Uses !! Example
|-
| {{text anchor|AB_SPECIFIC_HF_SEEKER}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|ANIMAL_SLAYER}}
|
| I have taken down [CONTEXT:NUMBER] [CONTEXT:RACE:NUMBERED_NAME] while stalking [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|ARCH_INFO_JUSTIFICATION}}
|
| It is said that the [CONTEXT:ARCH_ELEMENT] of [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] [CONTEXT:JUSTIFICATION] [CONTEXT:DEF_SPHERE] for the glory of [CONTEXT:HIST_FIG:TRANS_NAME].

|-
| {{text anchor|BOOK_ART}}
| Used when naming books.
| And [ANY_PRONOUN] Sang '[NAME]!'

|-
| {{text anchor|BOOK_INSTRUCTION}}
| Used when naming books.
| A Course on [NAME]

|-
| {{text anchor|CHILD_AGE_PROCLAMATION}}
|
| I'm [CONTEXT:NUMBER]!

|-
| {{text anchor|CURRENT_PROFESSION_NO_YEAR}}
|
| I am a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|CURRENT_PROFESSION_YEAR}}
|
| This is my [CONTEXT:ORDINAL] year as a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|CURSE}}
|
| Who dares to enter my house?  I curse you!

|-
| {{text anchor|SLAIN_DWARF}}
| Used when boasting about killing a [[dwarf]]. See also [[Creature token#SPEECH]].
| whose hammer shattered on the anvil of my power

|-
| {{text anchor|SLAIN_ELF}}
| Used when boasting about killing an [[elf]]. See also [[Creature token#SPEECH]].
| whose fragile bones shattered before the power of my contempt

|-
| {{text anchor|FAMILY_RELATIONSHIP_ADDITIONAL}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] is also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|FAMILY_RELATIONSHIP_ADDITIONAL_DEAD}}
|
| [CONTEXT:HIST_FIG:PRO_SUB] was also my [CONTEXT:FAMILY_RELATIONSHIP]

|-
| {{text anchor|FAMILY_RELATIONSHIP_NO_SPEC}}
|
| I have [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|FAMILY_RELATIONSHIP_NO_SPEC_DEAD}}
|
| I had [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|FAMILY_RELATIONSHIP_SPEC}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] is named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|FAMILY_RELATIONSHIP_SPEC_DEAD}}
|
| my [CONTEXT:FAMILY_RELATIONSHIP] was named [CONTEXT:HIST_FIG:TRANS_NAME]

|-
| {{text anchor|GENERAL}}
|
| who lies dead, now only an embarrassing memory

|-
| {{text anchor|GOODBYE_WORSHIP_1}}
|
| upon arising in the mornings,

|-
| {{text anchor|GOODBYE_WORSHIP_2}}
|
| always remember to

|-
| {{text anchor|GOODBYE_WORSHIP_3}}
|
| speak the praises of [SPEAKER:HF_LINK:DEITY:RANDOM_DEF_SPHERE]

|-
| {{text anchor|GREET}}
| Used when greeting another person.
| Greetings. My name is [SPEAKER:TRANS_NAME].

|-
| {{text anchor|GREET_BABY}}
| Used when greeting a [[baby]].
| A baby! How adorable!

|-
| {{text anchor|GREET_REPLY}}
| Used when replying to another person's greeting.
| Ah, hello. I'm [SPEAKER:TRANS_NAME].

|-
| {{text anchor|GREET_REPLY_AFTER_HERO}}
| Used by NPCs when replying to the player character's greeting after becoming a [[hero]].
| I am [SPEAKER:TRANS_NAME]. How can I be of service?

|-
| {{text anchor|GREET_REPLY_DIFF_LANGUAGE}}
| Used when replying to the greeting of a person who is of another race.
| Hello, [AUDIENCE:RACE]. I am [SPEAKER:TRANS_NAME].

|-
| {{text anchor|GREET_REPLY_UNUSUAL_FIRST}}
| Used when replying to the greeting of a person whose first name is unusual.{{verify|June 2015}}
| You know, you don't meet many people with the name [AUDIENCE:FIRST_NAME]

|-
| {{text anchor|GREET_WORSHIP}}
| Used for greetings by [[priest]]s and faithful people.{{verify|June 2015}}
| This servant of [SPEAKER:HF_LINK:DEITY:TRANS_NAME] greets you.

|-
| {{text anchor|GUARD_PROFESSION}}
| Used by guards when you ask them about their profession. See also [[#soldier_profession|soldier_profession]].
| I am a guard.

|-
| {{text anchor|GUARD_WARNING}}
|
| Don't start any trouble.

|-
| {{text anchor|HIST_FIG_SLAYER}}
|
| It is I that felled [CONTEXT:HIST_FIG:TRANS_NAME] the [CONTEXT:HIST_FIG:RACE].

|-
| {{text anchor|HUNTING_PROFESSION}}
|
| I hunt great beasts in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|HUNTING_PROFESSION_YEAR}}
|
| I have hunted great beasts in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|JUSTIFICATION_ANTITHETICAL}}
|
| can be thought of as the antithesis of

|-
| {{text anchor|JUSTIFICATION_EXPERIENCE}}
|
| can allow one to experience

|-
| {{text anchor|JUSTIFICATION_PROXIMITY}}
|
| can bring one near to

|-
| {{text anchor|JUSTIFICATION_REMINDER}}
|
| can remind one of

|-
| {{text anchor|JUSTIFICATION_REPRESENTATION}}
|
| can be thought of as a representation of

|-
| {{text anchor|LAIR_HUNTER_MINOTAUR}}
| Used by [[minotaur]]s while hunting adventures in their lairs. See also [[Creature token#LAIR_HUNTER_SPEECH]].
| I'll eat you whole!

|-
| {{text anchor|MERCENARY_PROFESSION}}
|
| I seek fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|MERCENARY_PROFESSION_YEAR}}
|
| I have sought fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.

|-
| {{text anchor|NO_FAMILY}}
| Used by NPCs when you ask them about their [[family]], but they don't have any.
| I have no family to speak of.

|-
| {{text anchor|PAST_HUNTING_PROFESSION}}
|
| In the past, I hunted great beasts.

|-
| {{text anchor|PAST_MERCENARY_PROFESSION}}
|
| In the past, I sought fortune and glory by offering my skill at arms.

|-
| {{text anchor|PAST_PROFESSION_NO_YEAR}}
|
| I was once a [CONTEXT:UNIT_NAME].

|-
| {{text anchor|PAST_PROFESSION_YEAR}}
|
| I was a [CONTEXT:UNIT_NAME] for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|PAST_SNATCHER_PROFESSION}}
|
| Once it was my calling to rescue lost children.

|-
| {{text anchor|PAST_THIEF_PROFESSION}}
|
| I once sought great treasures.

|-
| {{text anchor|PAST_WANDERING_PROFESSION}}
|
| I once wandered the wilds.

|-
| {{text anchor|POSITIVE}}
| Used to express positive [[feeling]]s.
| wonderful!<br/>fantastic!<br/>very good

|-
| {{text anchor|SAME_SITE_AB_SPECIFIC_HF_SEEKER}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME]

|-
| {{text anchor|SAME_SITE_SPECIFIC_HF_SEEKER}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|SITE_SPECIFIC_HF_SEEKER}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]

|-
| {{text anchor|SLAYER}}
|
| bane<br/>death<br/>nemesis<br/>vanquisher

|-
| {{text anchor|SNATCHER_PROFESSION}}
|
| I rescue lost children and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|SNATCHER_PROFESSION_YEAR}}
|
| For [CONTEXT:NUMBER] of my years, I have been rescuing lost children and bringing them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|SOLDIER_PROFESSION}}
| Used by [[soldier]]s when you ask them about their profession. See also [[#guard_profession|guard_profession]].
| I am a soldier.

|-
| {{text anchor|TASK_RECOMMENDATION}}
|
| [CONTEXT:ANY:TRANS_NAME] might have a task for you

|-
| {{text anchor|TEMPLE_ALREADY_MEMBER}}
|
| your task is simple;<br/>all you need is to

|-
| {{text anchor|TEMPLE_BECOME_MEMBER}}
|
| Welcome to [CONTEXT:ENTITY:TRANS_NAME].  Praise be to [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME]!<br/>As a member of [CONTEXT:ENTITY:TRANS_NAME], you can now seek the higher mysteries of [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME].

|-
| {{text anchor|THIEF_PROFESSION}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|THIEF_PROFESSION_YEAR}}
|
| I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME] and have done so for [CONTEXT:NUMBER] of the years of my life.

|-
| {{text anchor|THREAT}}
| Used by NPC [[bandit]]s{{verify|June 2015}} before attacking you.
| Prepare to die!

|-
| {{text anchor|UNKNOWN_HF_SEEKER}}
|
| seek out [CONTEXT:HIST_FIG:TRANS_NAME], wherever [CONTEXT:HIST_FIG:PRO_SUB] might be

|-
| {{text anchor|WANDERING_PROFESSION}}
|
| I wander [CONTEXT:PLACE:TRANS_NAME].

|-
| {{text anchor|WANDERING_PROFESSION_YEAR}}
|
| I have wandered [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.
|}

== Adding custom files ==

New speech tokens can be added with mods. It is also possible to add new files and associate them with custom creatures.

{| class="wikitable"
|+ [[Creature token]]s
! Token !! Example uses

|-
| [[Creature token#SLAIN_CASTE_SPEECH|SLAIN_CASTE_SPEECH]]
| Replaces [[DF2014:Creature token#CASTE_SPEECH|CASTE_SPEECH]], [[DF2014:Creature token#SPEECH_FEMALE|SPEECH_FEMALE]], and [[DF2014:Creature token#SPEECH_MALE|SPEECH_MALE]] from older versions.

|-
| [[Creature token#LAIR_HUNTER_SPEECH|LAIR_HUNTER_SPEECH]]
| [[Minotaur]] ([[#lair_hunter_minotaur|lair_hunter_minotaur.txt]])

|-
| [[Creature token#SPEECH|SPEECH]]
| [[Dwarf]] ([[text_dwarf.txt]]), [[Elf]] (text_elf.txt)
|}

== Special tokens ==

Speech files can contain tokens in square brackets (<code>[]</code>), which are replaced with context-specific strings before the speech is displayed.

=== Book title tokens ===

These tokens are used for [[Book#Titles|book titles]] and specific examples of [[Performer|performances]] such as songs, poems, or dances. It is unknown if the generating tokens can be used in other text sets to generate random words.

{| class="wikitable"
! Token !! Meaning !! Example

|-
| {{text anchor|NAME}}
| Inserts a name relevant to the book's [[topic]]. Notably, these may or may not be plural and/or have an article.
| The Tower, The Tree, Bronzemurdered, Likot Ubendeb, Animal Behaviours
|-
| {{text anchor|NO_ART_NAME}}
| "No article name." As [[Speech_file#NAME]], but never has an article.
| Tower, Tree, Bronzemurdered, Likot Ubendeb, Animal Behaviours
|-
| [{{text anchor|NOUN}}
| A random noun pulled from [[language_words.txt]] or a hardcoded list. May or may not be plural.
| 
|-
| {{text anchor|ADJ}}
| A random adjective from [[language_words.txt]].
| 
|-
| {{text anchor|ANY_AGE}}
| References an [[Calendar#Ages|age]] that has occurred in the world's [[Legends|history]].
| The Age Of Legends, The Age Of Hill Titan and Dragon 
|-
| {{text anchor|ANY_PRONOUN}}
| Generates singular and plural subject pronouns (not "Us" or "Them").
| He, She, We, They
|-
| {{text anchor|PHRASE}}
| A random phrase of a noun/pronoun, a verb, and some other words.
| The Fool Laughs, The Day Can Say It In The End, It Foretells Afterwards, The Day Mourns
|}

=== Context tokens ===

These give special information about the background of the conversation.

{| class="wikitable"
! Token !! Type !! Meaning

|-
| [CONTEXT:ABSTRACT_BUILDING]
| building
|
* [[#ab_specific_hf_seeker|ab_specific_hf_seeker]]: the building in which the historical figure that the speaker wants you to seek is

|-
| [CONTEXT:HIST_FIG]
| creature
|
* [[#ab_specific_hf_seeker|ab_specific_hf_seeker]]: the historical figure the speaker wants you to seek

|-
| [CONTEXT:NUMBER]
| number
|
* [[#animal_slayer|animal_slayer]]: number of animals slain
* [[#child_age_proclamation|child_age_proclamation]]: age in years of the child

|-
| [CONTEXT:ORDINAL]
| number
|
* [[#current_profession_year|current_profession_year]]: the number of years the speaker has had their profession

|-
| [CONTEXT:PLACE]
| site
|
* [[#animal_slayer|animal_slayer]]: the place where the speaker slew the animals

|-
| [CONTEXT:RACE]
| race
|
* [[#animal_slayer|animal_slayer]]: the race of the animals the speaker has slain

|-
| [CONTEXT:SITE]
| site
|
* [[#ab_specific_hf_seeker|ab_specific_hf_seeker]]: the site where the historical figure the speaker wants you to seek is

|-
| [CONTEXT:UNIT_NAME]
| text
|
* [[#current_profession_no_year|current_profession_no_year]]: the name of the speaker's profession
|}

== See also ==
* [[Speech mods]]

[[Category:Files]]
[[Category:Modding]]