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.

announcements.txt

From Dwarf Fortress Wiki
Revision as of 08:47, 4 May 2022 by Qeveren (talk | contribs) (→‎List of announcements: squads returning from missions trigger GUEST_ARRIVAL)
Jump to navigation Jump to search
This article is about the current version of DF.
Note that some content may still need to be updated.

File

Folder-orange.svg Dwarf Fortress

Folder.svg data

Folder.svg init

Text-x-generic.svg announcements.txt

The announcements.txt file can be used to control the types of announcements displayed in Dwarf Fortress, and how they are displayed in various modes, which can often be useful to stop recentering on birth announcements, for example.

Syntax

[ANNOUNCEMENT NAME:option:option...]

Available options

Option Description Notes
D_D or D_DISPLAY Causes the announcement to be displayed at the bottom of the screen in fortress mode (and be viewable in the announcements list). The default for minor announcements including profession changes, weather, job cancellations, and striking new minerals while mining.
A_D or A_DISPLAY Causes the announcement to be displayed at the bottom of the screen in adventure mode (and be viewable in the announcements list).
P or PAUSE Pauses the game when the announcement occurs.
R or RECENTER Recenters the game to the location of the announcement when the announcement occurs. Commonly used for births, caravan arrivals, and ambushes. Use of this without the pause option is not recommended, since your screen will recenter without warning.
BOX or DO_MEGA Causes a box to appear in the middle of the screen, requiring Enter to close it. This is often used with game-changing announcements.
UCR or UNIT_COMBAT_REPORT Causes the announcement to appear in all reports. A new report will be created if none are active. Commonly used for adventure mode combat moves.
UCR_A or UNIT_COMBAT_REPORT_ALL_ACTIVE Nearly identical to UNIT_COMBAT_REPORT, but does not create a new report if none are active.
NONE Specified announcements won't be displayed. Useful when you want to get rid of unwanted messages.

List of announcements

Announcement Example Description/Notes
REACHED_PEAK See calendar
ERA_CHANGE The world has passed into The Dwarven Age.
ENDGAME_EVENT_1 Discovery of the HFS
ENDGAME_EVENT_2
FEATURE_DISCOVERY You have discovered an expansive cavern deep underground. Discovery of caverns and their various features
STRUCK_DEEP_METAL Raw adamantine! Praise the miners! Striking adamantine
STRUCK_MINERAL You have struck mica! Striking a mineral while mining
STRUCK_ECONOMIC_MINERAL You have struck hematite!
COMBAT_TWIST_WEAPON Used in combat, most often in adventure mode (also in the arena)
COMBAT_LET_ITEM_DROP
COMBAT_START_CHARGE The Swordsdwarf charges at The Wolf!
COMBAT_SURPRISE_CHARGE The Wolf looks suprised by the ferocity of The Swordsdwarf's onslaught!
COMBAT_JUMP_DODGE_PROJ The Wolf jumps away from the flying +bronze bolt+!
COMBAT_JUMP_DODGE_STRIKE
COMBAT_DODGE
COMBAT_COUNTERSTRIKE
COMBAT_BLOCK
COMBAT_PARRY
COMBAT_CHARGE_COLLISION The Swordsdwarf collides with The Wolf!
COMBAT_CHARGE_DEFENDER_TUMBLES The Wolf is knocked over and tumbles backwards!
COMBAT_CHARGE_DEFENDER_KNOCKED_OVER The Wolf is knocked over!
COMBAT_CHARGE_ATTACKER_TUMBLES
COMBAT_CHARGE_ATTACKER_BOUNCE_BACK The Swordsdwarf bounces backwards!
COMBAT_CHARGE_TANGLE_TOGETHER
COMBAT_CHARGE_TANGLE_TUMBLE They tangle together and tumble forward!
COMBAT_CHARGE_RUSH_BY
COMBAT_CHARGE_MANAGE_STOP
COMBAT_CHARGE_OBSTACLE_SLAM
COMBAT_WRESTLE_LOCK
COMBAT_WRESTLE_CHOKEHOLD
COMBAT_WRESTLE_TAKEDOWN The Swordsdwarf takes The Wolf down by the neck with The Swordsdwarf's right lower arm!
COMBAT_WRESTLE_THROW The Swordsdwarf throws The Wolf by the neck with The Swordsdwarf's right lower arm!
COMBAT_WRESTLE_RELEASE_LOCK
COMBAT_WRESTLE_RELEASE_CHOKE
COMBAT_WRESTLE_RELEASE_GRIP
COMBAT_WRESTLE_STRUGGLE
COMBAT_WRESTLE_RELEASE_LATCH
COMBAT_WRESTLE_STRANGLE_KO
COMBAT_WRESTLE_ADJUST_GRIP
COMBAT_GRAB_TEAR
COMBAT_STRIKE_DETAILS
COMBAT_STRIKE_DETAILS_2
COMBAT_EVENT_ENRAGED The Wolf has become enraged!
COMBAT_EVENT_STUCKIN The *bronze spear* has lodged firmly in the wound!
COMBAT_EVENT_LATCH_BP
COMBAT_EVENT_LATCH_GENERAL The Wolf latches on firmly!
COMBAT_EVENT_PROPELLED_AWAY The Wolf is propelled away by the force of the blow!
COMBAT_EVENT_KNOCKED_OUT The Wolf has been knocked unconscious!
COMBAT_EVENT_STUNNED The Wolf has been stunned!
COMBAT_EVENT_WINDED The Wolf is having trouble breathing!
COMBAT_EVENT_NAUSEATED The Wolf looks sick!
MIGRANT_ARRIVAL_NAMED
MIGRANT_ARRIVAL The arrival of migrants
DIG_CANCEL_WARM Digging designation cancelled: warm stone located. The cancellation of a mining task due to potentially dangerous stone.
DIG_CANCEL_DAMP Digging designation cancelled: damp stone located.
AMBUSH_DEFENDER Discovering an ambush
AMBUSH_RESIDENT
AMBUSH_THIEF Thief! Protect the hoard from skulking filth!
AMBUSH_THIEF_SUPPORT_SKULKING
AMBUSH_THIEF_SUPPORT_NATURE
AMBUSH_THIEF_SUPPORT
AMBUSH_MISCHIEVOUS A gremlin! Drive it away!
AMBUSH_SNATCHER Snatcher! Protect the children!
AMBUSH_SNATCHER_SUPPORT
AMBUSH_AMBUSHER_NATURE
AMBUSH_AMBUSHER
AMBUSH_INJURED
AMBUSH_OTHER
AMBUSH_INCAPACITATED
CARAVAN_ARRIVAL A caravan from Sarvesh Langgud has arrived. Arrival of a caravan
NOBLE_ARRIVAL Arrival of a noble
D_MIGRANTS_ARRIVAL Some migrants have arrived. Arrival of a migrant wave
D_MIGRANT_ARRIVAL A migrant has arrived.
D_MIGRANT_ARRIVAL_DISCOURAGED Some migrants have arrived, despite the danger.
D_NO_MIGRANT_ARRIVAL The fortress attracted no migrants this season. The failure of migrants to show up in Fortress mode
ANIMAL_TRAP_CATCH A vermin was caught in an animal trap
ANIMAL_TRAP_ROBBED Failure to catch a vermin
MISCHIEF_LEVER Fun caused by a certain mischievous creature
MISCHIEF_PLATE
MISCHIEF_CAGE Something has emptied in a cage!
MISCHIEF_CHAIN
DIPLOMAT_ARRIVAL Arrival of a diplomat
LIAISON_ARRIVAL The outpost liaison Tun Unnostobul from Sarvesh Langgud has arrived. Arrival of an outpost liaison
TRADE_DIPLOMAT_ARRIVAL
CAVE_COLLAPSE A section of the cavern has collapsed!
BIRTH_CITIZEN Fath Ikudäs, Miner has given birth to a girl.
BIRTH_ANIMAL Stray Dog (Tame) has given birth to puppies.
STRANGE_MOOD Zon Urabasub, Metalcrafter is taken by a fey mood!
MADE_ARTIFACT Zon Urabasub, Metalcrafter has created Lonsust Stato, a platinum amulet!
NAMED_ARTIFACT Urdim Arbanerib, Mace Lord has bestowed the name Ostar Kinem upon a iron buckler! A soldier named their equipment.
ITEM_ATTACHMENT Kirkrost Inethnosig, mayor has grown attached to a steel crossbow!
VERMIN_CAGE_ESCAPE A vermin escapes from a cage/animal trap
TRIGGER_WEB
MOOD_BUILDING_CLAIMED Zon Urabasub, Metalcrafter has claimed a Metalsmith's Forge. A moody dwarf has claimed a workshop
ARTIFACT_BEGUN Zon Urabasub, Metalcrafter has begun a mysterious construction! A dwarf has begun construction of an artifact
MEGABEAST_ARRIVAL The Forgotten Beast Smespu has come! An enormous hairy ceratopsoid. It has an enormous shell and it is slavering. Its sea green hair is patchy. Beware its deadly dust! Arrival of a megabeast
BERSERK_CITIZEN Lòr Eralamug, Weaponsmith has gone berserk! A citizen has gone berserk
MAGMA_DEFACES_ENGRAVING An engraving has melted in magma
ENGRAVING_MELTS
MASTERPIECE_ARCHITECTURE Construction of a masterpiece building
MASTERPIECE_CONSTRUCTION
MASTER_ARCHITECTURE_LOST A masterpiece building has been destroyed
MASTER_CONSTRUCTION_LOST
ADV_AWAKEN
ADV_SLEEP_INTERRUPTED
ADV_REACTION_PRODUCTS
CANCEL_JOB Sibrek ùshrireshon, Mechanic cancels Load Cage Trap: Needs empty cage.
ADV_CREATURE_DEATH The Wolf has been struck down.
CITIZEN_DEATH Lòr Eralamug, Weaponsmith has been found dead. Death of a citizen in fortress mode
PET_DEATH The death of a pet, causing a negative thought for its owner
FALL_OVER The Wolf falls over.
CAUGHT_IN_FLAMES The Swordsdwarf is caught in a burst of forgotten beast flames! Also used when a creature is caught in poison gas/vapors or cave-in dust.
CAUGHT_IN_WEB The Wolf is caught up in a web!
UNIT_PROJECTILE_SLAM_BLOW_APART The Wolf slams into an obstacle and blows apart!
UNIT_PROJECTILE_SLAM The Wolf slams into an obstacle!
UNIT_PROJECTILE_SLAM_INTO_UNIT The Wolf slams into the Wolf!
VOMIT The Wolf vomits.
LOSE_HOLD_OF_ITEM The Goblin Bowman loses the hold of the (bismuth bronze bow).
REGAIN_CONSCIOUSNESS The Wolf regains consciousness.
FREE_FROM_WEB The Wolf is partially free from the web.
PARALYZED The Wolf is completely paralyzed!
OVERCOME_PARALYSIS A creature is no longer paralyzed
NOT_STUNNED The Wolf is no longer stunned. A creature is no longer stunned
EXHAUSTION Exhaustion
PAIN_KO The Wolf gives in to pain.
BREAK_GRIP The Swordsdwarf breaks the grip of the Wolf's teeth on the Swordsdwarf's left upper arm.
NO_BREAK_GRIP The Swordsdwarf struggles in vain against the grip of the Wolf's teeth on the Swordsdwarf's left upper arm.
BLOCK_FIRE Blocking a fire attack
BREATHE_FIRE The Fire Imp breathes fire! A creature breathes fire
SHOOT_WEB The Giant Cave Spider shoots out thick strands of webbing!
PULL_OUT_DROP
STAND_UP The Wolf stands up.
MARTIAL_TRANCE Mörul Bardumoslan, Hammerdwarf has entered a martial trance!
MAT_BREATH The Forgotten Beast breathes a cloud of Mirgur Sealhorse the Infinite Shadows's forgotten beast extract!
NIGHT_ATTACK_STARTS You are surrounded by incessant cackling. Bogeymen attack
NIGHT_ATTACK_ENDS The cackling fades away.
NIGHT_ATTACK_TRAVEL You are still surrounded by cackling.
GHOST_ATTACK Lòr Eralamug, Ghostly Weaponsmith has arisen and is haunting the fortress!
LAIR_HUNTER
TRAVEL_SITE_DISCOVERY You have discovered a lair.
TRAVEL_SITE_BUMP You cannot travel through the Lair.
ADVENTURE_INTRO You've finally got your equipment together, such as it is. Now it's time for action and adventure! In the rush of excitement, you've forgotten where you're going to go. Perhaps some of your friends might have ideas. Beginning adventure mode
CREATURE_SOUND The capybara barks.
CREATURE_STEALS_OBJECT A gray langur has stolen a -giant bat bone amulet-!
FOUND_TRAP Discovery of a trap in adventure mode
BODY_TRANSFORMATION Iden Ustuthod, Fisherdwarf has transformed into a wereskink!
INTERACTION_ACTOR See Interaction token#VERB
INTERACTION_TARGET See Interaction token#TARGET_VERB
UNDEAD_ATTACK
CITIZEN_MISSING Lòr Eralamug, Weaponsmith has been missing for a week.
PET_MISSING A pet has gone missing
MARKET_CHATTER
STRANGE_RAIN_SNOW It is raining rotten sludge! The appearance of unusual weather
STRANGE_CLOUD A cloud of haunting fog has drifted nearby!
SIMPLE_ANIMAL_ACTION
FLOUNDER_IN_LIQUID You flounder in the water!
TRAINING_DOWN_TO_SEMI_WILD The Stray war Cave Dragon (Semi-Wild) has forgotten its training! A trained animal has reverted to a semi-wild state (Fortress mode). If the animal is not trained properly, it will become wild and possibly attack your dwarves.
TRAINING_FULL_REVERSION The war Cave Dragon has reverted to a wild state! An animal has reverted to a wild state (follows the previous announcement)
ANIMAL_TRAINING_KNOWLEDGE The dwarves of the Monastery of Tin are now quite knowledgable cave dragon trainers. See Animal trainer
SKIP_ON_LIQUID
DODGE_FLYING_OBJECT Dodging a shot arrow
REGULAR_CONVERSATION Caspa Linkon, Human Swordsman: I must pray to Uspram Boldyell the Contest of Stability. I'm uneasy.
CONFLICT_CONVERSATION Caspa Linkon, Human Swordsman: This is my fight too. I will take revenge!
FLAME_HIT
EMBRACE
BANDIT_EMPTY_CONTAINER
BANDIT_GRAB_ITEM
COMBAT_EVENT_ATTACK_INTERRUPTED The Wolf's attack is interrupted! Wrestling interrupts opponent's attack
COMBAT_WRESTLE_CATCH_ATTACK
FAIL_TO_GRAB_SURFACE Failing to grab a tile
LOSE_HOLD_OF_SURFACE Losing hold of a surface while climbing
TRAVEL_COMPLAINT
LOSE_EMOTION
REORGANIZE_POSSESSIONS The Human Pikeman reorganizes his possessions.
PUSH_ITEM
DRAW_ITEM
STRAP_ITEM
GAIN_SITE_CONTROL You are now in control of Tanfield, ruling The Ignition of Churches from The Holy Saturninity.
FORT_POSITION_SUCCESSION
STRESSED_CITIZEN Lòr Eralamug, Weaponsmith is stumbling obliviously!
CITIZEN_LOST_TO_STRESS Lòr Eralamug, Weaponsmith has gone stark raving mad!
CITIZEN_TANTRUM Lòr Eralamug, Weaponsmith is throwing a tantrum!
MOVED_OUT_OF_RANGE The Wolf has moved out of range! An attacked creature has moved out of range
CANNOT_JUMP You cannot jump while prone.
NO_TRACKS
ALREADY_SEARCHED_AREA You've already searched this area recently.
SEARCH_FOUND_SOMETHING
SEARCH_FOUND_NOTHING Your intense search turns up nothing.
NOTHING_TO_INTERACT You have nothing with which to interact.
NOTHING_TO_EXAMINE You have nothing to examine.
YOU_YIELDED You assume a submissive posture. Yielding in adventure mode
YOU_UNYIELDED You no longer assume a submissive posture.
YOU_STRAP_ITEM You strap the steel short sword to your Upper body.
YOU_DRAW_ITEM You draw the steel short sword with your Right hand.
NO_GRASP_TO_DRAW_ITEM You do not have a free grasp for the steel short sword.
NO_ITEM_TO_STRAP You have nothing left to draw or put away.
NO_INV_TO_REMOVE You have nothing left to remove.
NO_INV_TO_WEAR You have nothing left to wear.
NO_INV_TO_EAT You have nothing left to eat or drink.
NO_INV_TO_CONTAIN You have nothing to put inside a container.
NO_INV_TO_DROP You have nothing left to drop.
NOTHING_TO_PICK_UP There is nothing to pick up here.
NO_INV_TO_THROW You have nothing left to throw.
NO_INV_TO_FIRE You have nothing left to fire.
CURRENT_SMELL Smelling in adventure mode
CURRENT_WEATHER The sky is clear above you. Checking weather in adventure mode
CURRENT_TEMPERATURE Checking temperature in adventure mode
CURRENT_DATE It is the 14th of Granite, 250. Checking time in adventure mode
NO_GRASP_FOR_PICKUP You do not have a free grasp.
TRAVEL_ADVISORY
CANNOT_CLIMB You are unable to climb
CANNOT_STAND You are unable to stand up
MUST_UNRETRACT_FIRST You must unroll.
CANNOT_REST
CANNOT_MAKE_CAMPFIRE
MADE_CAMPFIRE You make a campfire
CANNOT_SET_FIRE
SET_FIRE You set a fire
DAWN_BREAKS The dawn is breaking. Change of the time of day
NOON
NIGHTFALL The night is falling.
NO_INV_INTERACTION
EMPTY_CONTAINER You empty your giant moon snail leather backpack. Emptying a container in adventure mode
TAKE_OUT_OF_CONTAINER Taking an item out of container in adventure mode
NO_CONTAINER_FOR_ITEM You don't have a suitable container.
PUT_INTO_CONTAINER
EAT_ITEM You eat an item
DRINK_ITEM You drink an item
CONSUME_FAILURE You lick an item
DROP_ITEM You drop an item
PICK_UP_ITEM You pick up an item
YOU_BUILDING_INTERACTION Interaction with a building in adventure mode
YOU_ITEM_INTERACTION Interaction with an item in adventure mode
YOU_TEMPERATURE_EFFECTS You are melting!
RESOLVE_SHARED_ITEMS
COUGH_BLOOD Coughing blood
VOMIT_BLOOD Vomiting blood
POWER_LEARNED Learning a new power
YOU_FEED_ON_SUCKEE Sucking blood
PROFESSION_CHANGES Changing a profession
RECRUIT_PROMOTED
SOLDIER_BECOMES_MASTER A soldier has mastered a weapon skill
MERCHANTS_UNLOADING The merchants from Sarvesh Langgud have arrived and are unloading their goods.
MERCHANTS_NEED_DEPOT The merchants need a trade depot to unload their goods.
MERCHANT_WAGONS_BYPASSED The merchants' wagons have bypassed the site
MERCHANTS_LEAVING_SOON The merchants from Sarvesh Langgud will be leaving soon.
MERCHANTS_EMBARKED The merchants from Sarvesh Langgud have embarked on their journey.
PET_LOSES_DEAD_OWNER
PET_ADOPTS_OWNER
VERMIN_BITE The Stray Cow (Tame) has been stung by a honey bee! A vermin bites/stings a creature
UNABLE_TO_COMPLETE_BUILDING The dwarves were unable to complete the Wall.
JOBS_REMOVED_FROM_UNPOWERED_BUILDING
CITIZEN_SNATCHED A kidnapper has made off with the Dwarven child Ustuth Therlethendok!
VERMIN_DISTURBED
LAND_GAINS_STATUS
LAND_ELEVATED_STATUS
MASTERPIECE_CRAFTED Fikod Razulban has created a masterpiece ☼Juwog Minedscratch's forgotten beast silk cloth☼
ARTWORK_DEFACED A foolish builder defaced a Edëm Stinzas! A masterwork was destroyed
ANIMAL_TRAINED An animal has become a Stray war Dog.
DYED_MASTERPIECE An item has been masterfully dyed
COOKED_MASTERPIECE Cooking a masterful meal
MANDATE_ENDS A noble ended a mandate
SLOWDOWN_ENDS
FAREWELL_HELPER
ELECTION_RESULTS
SITE_PRESENT
CONSTRUCTION_SUSPENDED Construction of a building was suspended
LINKAGE_SUSPENDED
QUOTA_FILLED A work order was completed
JOB_OVERWRITTEN
NOTHING_TO_CATCH_IN_WATER There is nothing to catch in the river.
DEMAND_FORGOTTEN
NEW_DEMAND
NEW_MANDATE
PRICES_ALTERED
NAMED_RESIDENT_CREATURE
SOMEBODY_GROWS_UP Somebody has grown up
GUILD_REQUEST_TAKEN
GUILD_WAGES_CHANGED
NEW_WORK_MANDATE
CITIZEN_BECOMES_SOLDIER
CITIZEN_BECOMES_NONSOLDIER
PARTY_ORGANIZED
POSSESSED_TANTRUM A dwarf possessed by a ghost is throwing a tantrum
BUILDING_TOPPLED_BY_GHOST A building was toppled by a ghost
MASTERFUL_IMPROVEMENT An item has been masterfully decorated
MASTERPIECE_ENGRAVING A masterpiece engraving was created
MARRIAGE
NO_MARRIAGE_CELEBRATION
CURIOUS_GUZZLER An animal drank stockpiled booze
WEATHER_BECOMES_CLEAR The weather has cleared.
WEATHER_BECOMES_SNOW A snow storm has come.
WEATHER_BECOMES_RAIN It has started raining.
SEASON_WET
SEASON_DRY
SEASON_SPRING Spring has arrived! Change of a season
SEASON_SUMMER It is now summer.
SEASON_AUTUMN Autumn has come.
SEASON_WINTER Winter is here.
GUEST_ARRIVAL Vusdom Ilerane, Human Spearman is visiting. Arrival of visitors, and also squads returning from missions.
CANNOT_SPEAK A troglodyte cannot speak. When playing adventure mode as a creature that doesn't speak.
RESEARCH_BREAKTHROUGH
SERVICE_ORDER_DELIVERY
PERFORMANCE_START_FAILURE
BEGIN_ACTIVITY
MIDDLE_OF_ACTIVITY
ACTIVITY_SECTION_CHANGE
CONCLUDE_ACTIVITY
LEARNED_WRITTEN_CONTENT
LEARNED_ART_FORM
PERFORMER_UPDATE
BUILDING_DESTROYED_OR_TOPPLED A creature destroyed a building
DEITY_CURSE Being cursed by a deity
COMPOSITION_COMPLETE
COMPOSITION_FAILED
NEW_APPRENTICESHIP
PETITION_IGNORED The petition of Vusdom Ilerane, Human Spearman has been ignored.
CANNOT_CHOP_TREE You cannot fell trees in the arena.
CHOP_TREE Chopping trees in adventure mode
CANNOT_CONSTRUCT You cannot construct at this site.
RUMOR_SPREAD
SERVICE_ORDER_RUMOR_RECEIVED
RETURNING_RUMOR_RECEIVED
NEW_HOLDING
NEW_MARKET_LINK
EMERGENCY_TACTICAL_CONTROL
AGREEMENT_SATISFIED
AGREEMENT_WARNING
AGREEMENT_ABANDONED
NEW_GUILD
CRIME_WITNESS_HANDOFF
CRIME_WITNESS_STOLEN
CRIME_WITNESS_ITEM_MOVED
CRIME_WITNESS_ITEM_MISSING
MOUNT
CANNOT_MOUNT
FAILED_MOUNT
DISMOUNT
FAILED_DISMOUNT
Notes
  • GUEST_ARRIVAL - PETITION_IGNORED added in v0.42.01
  • CANNOT_CHOP_TREE - CANNOT_CONSTRUCT added in v0.43.01
  • RUMOR_SPREAD - FAILED_DISMOUNT new
Settings
Gameplay settings
Log files
Other