Speech file

v50.14 · v0.47.05 This article is about the current version of DF. Note that some content may still need to be updated. More Info · V

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 data/vanilla/vanilla_text/objects folder, though the creature specific files can be found in data/vanilla/vanilla_creatures/objects. Like other raw files, mods can replace or introduce new sentences.

List of files

Textset ID	Uses	Example
AB_SPECIFIC_HF_SEEKER		seek out [CONTEXT:HIST_FIG:TRANS_NAME] at [CONTEXT:ABSTRACT_BUILDING:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]
ANIMAL_SLAYER		I have taken down [CONTEXT:NUMBER] [CONTEXT:RACE:NUMBERED_NAME] while stalking [CONTEXT:PLACE:TRANS_NAME].
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].
BOOK_ART	Used when naming books.	And [ANY_PRONOUN] Sang '[NAME]!'
BOOK_INSTRUCTION	Used when naming books.	A Course on [NAME]
CHILD_AGE_PROCLAMATION		I'm [CONTEXT:NUMBER]!
CURRENT_PROFESSION_NO_YEAR		I am a [CONTEXT:UNIT_NAME].
CURRENT_PROFESSION_YEAR		This is my [CONTEXT:ORDINAL] year as a [CONTEXT:UNIT_NAME].
CURSE		Who dares to enter my house? I curse you!
SLAIN_DWARF	Used when boasting about killing a dwarf. See also Creature token#SPEECH.	whose hammer shattered on the anvil of my power
SLAIN_ELF	Used when boasting about killing an elf. See also Creature token#SPEECH.	whose fragile bones shattered before the power of my contempt
FAMILY_RELATIONSHIP_ADDITIONAL		[CONTEXT:HIST_FIG:PRO_SUB] is also my [CONTEXT:FAMILY_RELATIONSHIP]
FAMILY_RELATIONSHIP_ADDITIONAL_DEAD		[CONTEXT:HIST_FIG:PRO_SUB] was also my [CONTEXT:FAMILY_RELATIONSHIP]
FAMILY_RELATIONSHIP_NO_SPEC		I have [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]
FAMILY_RELATIONSHIP_NO_SPEC_DEAD		I had [CONTEXT:INDEF_FAMILY_RELATIONSHIP] named [CONTEXT:HIST_FIG:TRANS_NAME]
FAMILY_RELATIONSHIP_SPEC		my [CONTEXT:FAMILY_RELATIONSHIP] is named [CONTEXT:HIST_FIG:TRANS_NAME]
FAMILY_RELATIONSHIP_SPEC_DEAD		my [CONTEXT:FAMILY_RELATIONSHIP] was named [CONTEXT:HIST_FIG:TRANS_NAME]
GENERAL		who lies dead, now only an embarrassing memory
GOODBYE_WORSHIP_1		upon arising in the mornings,
GOODBYE_WORSHIP_2		always remember to
GOODBYE_WORSHIP_3		speak the praises of [SPEAKER:HF_LINK:DEITY:RANDOM_DEF_SPHERE]
GREET	Used when greeting another person.	Greetings. My name is [SPEAKER:TRANS_NAME].
GREET_BABY	Used when greeting a baby.	A baby! How adorable!
GREET_REPLY	Used when replying to another person's greeting.	Ah, hello. I'm [SPEAKER:TRANS_NAME].
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?
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].
GREET_REPLY_UNUSUAL_FIRST	Used when replying to the greeting of a person whose first name is unusual.[Verify]	You know, you don't meet many people with the name [AUDIENCE:FIRST_NAME]
GREET_WORSHIP	Used for greetings by priests and faithful people.[Verify]	This servant of [SPEAKER:HF_LINK:DEITY:TRANS_NAME] greets you.
GUARD_PROFESSION	Used by guards when you ask them about their profession. See also soldier_profession.	I am a guard.
GUARD_WARNING		Don't start any trouble.
HIST_FIG_SLAYER		It is I that felled [CONTEXT:HIST_FIG:TRANS_NAME] the [CONTEXT:HIST_FIG:RACE].
HUNTING_PROFESSION		I hunt great beasts in [CONTEXT:PLACE:TRANS_NAME].
HUNTING_PROFESSION_YEAR		I have hunted great beasts in [CONTEXT:PLACE:TRANS_NAME] for [CONTEXT:NUMBER] of my years.
JUSTIFICATION_ANTITHETICAL		can be thought of as the antithesis of
JUSTIFICATION_EXPERIENCE		can allow one to experience
JUSTIFICATION_PROXIMITY		can bring one near to
JUSTIFICATION_REMINDER		can remind one of
JUSTIFICATION_REPRESENTATION		can be thought of as a representation of
LAIR_HUNTER_MINOTAUR	Used by minotaurs while hunting adventures in their lairs. See also Creature token#LAIR_HUNTER_SPEECH.	I'll eat you whole!
MERCENARY_PROFESSION		I seek fortune and glory by offering my skill at arms in [CONTEXT:PLACE:TRANS_NAME].
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.
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.
PAST_HUNTING_PROFESSION		In the past, I hunted great beasts.
PAST_MERCENARY_PROFESSION		In the past, I sought fortune and glory by offering my skill at arms.
PAST_PROFESSION_NO_YEAR		I was once a [CONTEXT:UNIT_NAME].
PAST_PROFESSION_YEAR		I was a [CONTEXT:UNIT_NAME] for [CONTEXT:NUMBER] of the years of my life.
PAST_SNATCHER_PROFESSION		Once it was my calling to rescue lost children.
PAST_THIEF_PROFESSION		I once sought great treasures.
PAST_WANDERING_PROFESSION		I once wandered the wilds.
POSITIVE	Used to express positive feelings.	wonderful! fantastic! very good
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]
SAME_SITE_SPECIFIC_HF_SEEKER		seek out [CONTEXT:HIST_FIG:TRANS_NAME] here in [CONTEXT:SITE:TRANS_NAME]
SITE_SPECIFIC_HF_SEEKER		seek out [CONTEXT:HIST_FIG:TRANS_NAME] over in [CONTEXT:SITE:TRANS_NAME]
SLAYER		bane death nemesis vanquisher
SNATCHER_PROFESSION		I rescue lost children and bring them back to [CONTEXT:PLACE:TRANS_NAME].
SNATCHER_PROFESSION_YEAR		For [CONTEXT:NUMBER] of my years, I have been rescuing lost children and bringing them back to [CONTEXT:PLACE:TRANS_NAME].
SOLDIER_PROFESSION	Used by soldiers when you ask them about their profession. See also guard_profession.	I am a soldier.
TASK_RECOMMENDATION		[CONTEXT:ANY:TRANS_NAME] might have a task for you
TEMPLE_ALREADY_MEMBER		your task is simple; all you need is to
TEMPLE_BECOME_MEMBER		Welcome to [CONTEXT:ENTITY:TRANS_NAME]. Praise be to [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME]! As a member of [CONTEXT:ENTITY:TRANS_NAME], you can now seek the higher mysteries of [CONTEXT:ENTITY:WORSHIP_HF:TRANS_NAME].
THIEF_PROFESSION		I seek treasures and bring them back to [CONTEXT:PLACE:TRANS_NAME].
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.
THREAT	Used by NPC bandits[Verify] before attacking you.	Prepare to die!
UNKNOWN_HF_SEEKER		seek out [CONTEXT:HIST_FIG:TRANS_NAME], wherever [CONTEXT:HIST_FIG:PRO_SUB] might be
WANDERING_PROFESSION		I wander [CONTEXT:PLACE:TRANS_NAME].
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.

Creature tokens

Token	Example uses
SLAIN_CASTE_SPEECH	Replaces CASTE_SPEECH, SPEECH_FEMALE, and SPEECH_MALE from older versions.
LAIR_HUNTER_SPEECH	Minotaur (lair_hunter_minotaur.txt)
SPEECH	Dwarf (text_dwarf.txt), Elf (text_elf.txt)

Special tokens

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

Book title tokens

These tokens are used for book titles and specific examples of 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.

Token	Meaning	Example
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
NO_ART_NAME	"No article name." As Speech_file#NAME, but never has an article.	Tower, Tree, Bronzemurdered, Likot Ubendeb, Animal Behaviours
NOUN	A random noun pulled from language_words.txt or a hardcoded list. May or may not be plural.	Despair, Roots, Scrolls, Wheel-and-axles
ADJ	A random adjective from language_words.txt.	Boyish, Inky, Angry, Bronzed
ANY_AGE	References an age that has occurred in the world's history.	The Age Of Legends, The Age Of Hill Titan and Dragon
ANY_PRONOUN	Chosen from among singular and plural subject pronouns (not "Us" or "Them").	He, She, We, They
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.

Token	Type	Meaning
[CONTEXT:ABSTRACT_BUILDING]	building	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: the historical figure the speaker wants you to seek
[CONTEXT:NUMBER]	number	animal_slayer: number of animals slain child_age_proclamation: age in years of the child
[CONTEXT:ORDINAL]	number	current_profession_year: the number of years the speaker has had their profession
[CONTEXT:PLACE]	site	animal_slayer: the place where the speaker slew the animals
[CONTEXT:RACE]	race	animal_slayer: the race of the animals the speaker has slain
[CONTEXT:SITE]	site	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: the name of the speaker's profession

See also

• Speech mods