v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "Speech file"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
m (→‎Adding custom files: Updated filename references)
(Added alternative title, "text set" after the object type)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{av}}
 
{{av}}
 
{{Modding}}
 
{{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.
+
'''Speech files''', also known as '''text sets''', 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 ==
 
== List of files ==
Line 359: Line 359:
 
|}
 
|}
  
== Special tokens ==
+
== List of Tokens ==
  
 
Speech files can contain tokens in square brackets (<code>[]</code>), which are replaced with context-specific strings before the speech is displayed.
 
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]], or a random noun for art and star charts. Notably, these may or may not be plural and/or have an article.
 +
| The [[Tower_(necromancy)|Tower]], The [[Forest retreat|Tree]], [[v0.31:Stories/Bronzemurder|Bronzemurder]], [[Book#History|Likot Ubendeb]], [[Book#Nature|Animal Behaviours]]
 +
|-
 +
| {{text anchor|NO_ART_NAME}}
 +
| "No article name." As [[Speech_file#NAME|NAME]], but never has an article.
 +
| Tower, Tree, Bronzemurder, 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.
 +
| Despair, Roots, Scrolls, Wheel-and-axles
 +
|-
 +
| {{text anchor|ADJ}}
 +
| A random adjective from [[language_words.txt]].
 +
| Boyish, Inky, Angry, Bronzed
 +
|-
 +
| {{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}}
 +
| Chosen from among 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
 +
|}
 +
 +
=== Dialogue tokens ===
 +
 +
Character dialogue uses its own set of tokens to reference data.
 +
Scopes identify participants in a conversation and various forms of background information. They can be nested within each other in various cases. If the scopes refer to a historical object, it is expected [verify] that not using the TRANS_NAME argument will display the untranslated name.
 +
Strings are the arguments for scopes, outputting a specific word based on the conversation data. In certain files, they are used by themselves with an implied scope.
 +
 +
{| class="wikitable"
 +
! Token !! Type !! Meaning
 +
 +
|-
 +
| {{text anchor|SPEAKER}}
 +
| base scope
 +
| The person speaking the dialogue.
 +
|-
 +
| {{text anchor|AUDIENCE}}
 +
| base scope
 +
| The person receiving the dialogue. Has buggy behavior without a defined audience, such as when shouting out to everyone.
 +
|-
 +
| {{text anchor|CONTEXT}}
 +
| base scope
 +
| Holds additional information depending on the subject of conversation. Must use HIST_FIG as its argument to retrieve personal info from a creature that isn't present.
 +
|-
 +
| {{text anchor|HIST_FIG}}
 +
| scope
 +
| Usually written as [CONTEXT:HIST_FIG], this refers to a historical figure referenced by the speaker.
 +
|-
 +
| {{text anchor|PLACE}}
 +
| scope
 +
| A location, such as a biome.
 +
|-
 +
| {{text anchor|SITE}}
 +
| scope
 +
| A site given by the context.
 +
|-
 +
| {{text anchor|HF_LINK}}
 +
| scope
 +
| Looks for historical figures [[Relationship|associated]] with the scope.
 +
|-
 +
| {{text anchor|DEITY}}
 +
| scope
 +
| An argument for [HF_LINK], in this case referring to a (presumably, devoutly worshipped) [[deity]].
 +
|-
 +
| {{text anchor|TRANS_NAME}}
 +
| string
 +
| The full translated name of the referenced object.
 +
|-
 +
| {{text anchor|FIRST_NAME}}
 +
| string
 +
| The first name of the referenced creature.
 +
|-
 +
| {{text anchor|PRO_SUB}}
 +
| string
 +
| The referenced creature's subject pronoun (she, he, it).
 +
|-
 +
| {{text anchor|PRO_OBJ}}
 +
| string
 +
| The referenced creature's object pronoun (her, him, it).
 +
|-
 +
| {{text anchor|PRO_POS}}
 +
| string
 +
| The referenced creature's possessive pronoun (her, his, its).
 +
|-
 +
| {{text anchor|ABSTRACT_BUILDING}}
 +
| string
 +
| The first name of the referenced creature.
 +
|-
 +
| {{text anchor|RACE}}
 +
| string
 +
| The [[Creature token#NAME|name]] of the context's species.
 +
|-
 +
| {{text anchor|NUMBER}}
 +
| string
 +
| A number (expressed as plain text rather than numerals?).
 +
|-
 +
| {{text anchor|ORDINAL}}
 +
| string
 +
| An ordinal number, such as first or second.
 +
|-
 +
| {{text anchor|UNIT_NAME}}
 +
| string
 +
| The [[Unit type token|unit type]] of the referenced creature.
 +
|-
 +
| {{text anchor|ARCH_ELEMENT}}
 +
| string
 +
| An architectural element given by the context.
 +
|-
 +
| {{text anchor|ABSTRACT_BUILDING}}
 +
| string
 +
| A named building given by the context.
 +
|-
 +
| {{text anchor|JUSTIFICATION}}
 +
| string
 +
| A [[Speech file#JUSTIFICATION_ANTITHETICAL|justification]] chosen by the context.
 +
|-
 +
| {{text anchor|DEF_SPHERE}}
 +
| string
 +
| A divine [[sphere]] chosen by the context.
 +
|-
 +
| {{text anchor|RANDOM_DEF_SPHERE}}
 +
| string
 +
| A random [[sphere]] associated with the scope.
 +
|-
 +
| {{text anchor|FAMILY_RELATIONSHIP}}
 +
| string
 +
| The [[relationship]] given by the context.
 +
|}
  
 
=== Context tokens ===
 
=== Context tokens ===
Line 368: Line 512:
  
 
{| class="wikitable"
 
{| class="wikitable"
! Token !! Type !! Meaning
+
! Token !! Meaning !! Example
  
 
|-
 
|-
Line 419: Line 563:
 
* [[#current_profession_no_year|current_profession_no_year]]: the name of the speaker's profession
 
* [[#current_profession_no_year|current_profession_no_year]]: the name of the speaker's profession
 
|}
 
|}
 +
 
== See also ==
 
== See also ==
 
* [[Speech mods]]
 
* [[Speech mods]]

Latest revision as of 23:07, 1 November 2023

This article is about the current version of DF.
Note that some content may still need to be updated.


Speech files, also known as text sets, 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[edit]

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[edit]

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)

List of Tokens[edit]

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

Book title tokens[edit]

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, or a random noun for art and star charts. Notably, these may or may not be plural and/or have an article. The Tower, The Tree, Bronzemurder, Likot Ubendeb, Animal Behaviours
NO_ART_NAME "No article name." As NAME, but never has an article. Tower, Tree, Bronzemurder, 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

Dialogue tokens[edit]

Character dialogue uses its own set of tokens to reference data. Scopes identify participants in a conversation and various forms of background information. They can be nested within each other in various cases. If the scopes refer to a historical object, it is expected [verify] that not using the TRANS_NAME argument will display the untranslated name. Strings are the arguments for scopes, outputting a specific word based on the conversation data. In certain files, they are used by themselves with an implied scope.

Token Type Meaning
SPEAKER base scope The person speaking the dialogue.
AUDIENCE base scope The person receiving the dialogue. Has buggy behavior without a defined audience, such as when shouting out to everyone.
CONTEXT base scope Holds additional information depending on the subject of conversation. Must use HIST_FIG as its argument to retrieve personal info from a creature that isn't present.
HIST_FIG scope Usually written as [CONTEXT:HIST_FIG], this refers to a historical figure referenced by the speaker.
PLACE scope A location, such as a biome.
SITE scope A site given by the context.
HF_LINK scope Looks for historical figures associated with the scope.
DEITY scope An argument for [HF_LINK], in this case referring to a (presumably, devoutly worshipped) deity.
TRANS_NAME string The full translated name of the referenced object.
FIRST_NAME string The first name of the referenced creature.
PRO_SUB string The referenced creature's subject pronoun (she, he, it).
PRO_OBJ string The referenced creature's object pronoun (her, him, it).
PRO_POS string The referenced creature's possessive pronoun (her, his, its).
ABSTRACT_BUILDING string The first name of the referenced creature.
RACE string The name of the context's species.
NUMBER string A number (expressed as plain text rather than numerals?).
ORDINAL string An ordinal number, such as first or second.
UNIT_NAME string The unit type of the referenced creature.
ARCH_ELEMENT string An architectural element given by the context.
ABSTRACT_BUILDING string A named building given by the context.
JUSTIFICATION string A justification chosen by the context.
DEF_SPHERE string A divine sphere chosen by the context.
RANDOM_DEF_SPHERE string A random sphere associated with the scope.
FAMILY_RELATIONSHIP string The relationship given by the context.

Context tokens[edit]

These give special information about the background of the conversation.

Token Meaning Example
[CONTEXT:ABSTRACT_BUILDING] building
[CONTEXT:HIST_FIG] creature
[CONTEXT:NUMBER] number
[CONTEXT:ORDINAL] number
[CONTEXT:PLACE] site
[CONTEXT:RACE] race
[CONTEXT:SITE] site
[CONTEXT:UNIT_NAME] text

See also[edit]