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 "Memory hacking"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(→‎Flags: flags2)
(→‎Flags: flags3)
Line 116: Line 116:
 
| ``flags1``
 
| ``flags1``
 
| ``hidden_in_ambush``
 
| ``hidden_in_ambush``
−
| The creature is [[ambusher|stealthed]] and not visible until noticed by someone. Used by [[gremlin]]s, [[werebeast]]s, [[ambush]]ing invaders, and [[adventure mode]] sneaking.
+
| The creature is [[ambusher|stealthed]] and not visible until noticed by someone. Used by [[gremlin]]s, [[werebeast]]s, [[ambush]]ing invaders, and [[adventure mode]] {{Adv menu icon|S}} sneaking.
  
 
|-
 
|-
Line 175: Line 175:
 
|-
 
|-
 
| ``flags1``
 
| ``flags1``
−
| ``supress_wield``
+
| ``suppress_wield``
 
|
 
|
  
Line 341: Line 341:
 
| ``flags2``
 
| ``flags2``
 
| ``roaming_wilderness_population_source_not_a_map_feature``
 
| ``roaming_wilderness_population_source_not_a_map_feature``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``body_part_relsize_computed``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``size_modifier_computed``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``stuck_weapon_computed``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``compute_health``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``announce_titan``
 +
| Displays a pop-up message announcing the arrival of a [[megabeast]].
 +
:{{dftext|The Forgotten Beast Juwog has come! A towering blob composed of flame. It has a stubby tail and it has a bloated body. Beware its fire!|4:1}}
 +
 +
|-
 +
| ``flags3``
 +
| ``training_tired_wait``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``on_crutch``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``weight_computed``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``body_temp_in_range``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``wait_until_reveal``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``scuttle``
 +
| Used on caravan [[wagon]]s. When set on anything else, turns the creature into a "wagon" which in [[fortress mode]] is instantly scuttled, insta-killing said creature.
 +
 +
|-
 +
| ``flags3``
 +
| ``verify_personal_training``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``ghostly``
 +
| Turns the creature into a [[ghost]].
 +
 +
|-
 +
| ``flags3``
 +
| ``just_sprung_ambush``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``disturbed_from_death``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``diving``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``flee_if_birth_race``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``no_meandering``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``floundering``
 +
| Creature flounders in the [[water]] due to insufficient [[swimming]] skill.
 +
 +
|-
 +
| ``flags3``
 +
| ``exit_vehicle1``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``exit_vehicle2``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``dangerous_terrain``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``adv_yield``
 +
| Creature is [[File:status_yielded_icon.png]] [[surrender]]ing. Used in [[adventure mode]].
 +
 +
|-
 +
| ``flags3``
 +
| ``vision_cone_set``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``multipart_vision_have_at_least_damaged``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``emotionally_overloaded``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``check_reorganize_possessions``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``available_for_adoption``
 +
| The animal is allowed to be adopted as a [[pet]] in [[fortress mode]].
 +
 +
|-
 +
| ``flags3``
 +
| ``gelded``
 +
| Creature has been [[gelder|gelded]] and cannot reproduce anymore.
 +
 +
|-
 +
| ``flags3``
 +
| ``marked_for_gelding``
 +
| The animal is queued to be gelded in fortress mode.
 +
 +
|-
 +
| ``flags3``
 +
| ``injury_thought``
 +
|
 +
 +
|-
 +
| ``flags3``
 +
| ``guest``
 
|
 
|
  

Revision as of 19:58, 11 November 2026

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

Memory hacking means editing the game's memory data directly, unlike modding. The most prevalent tool for hacking the memory is DFHack, which provides access to internal data in a human-readable form, unlike most utilities which display binary values only.

DFHack offers two primary commands for accessing the memory data, gui/gm-editor which displays and allows editing the data for the selected object (creature, item, job, etc), and gui/gm-editor world which allows editing global variables.


Job ingredient definition viewed with gui/gm-editor.


Hacking with gui/gm-editor

Creature hacking

Flags

Creature flags are boolean true/false values, split into four arrays named flags1 - flags4.

Array Name Effect
flags1 move_state
flags1 inactive Marks the creature as Deceased (dead) and no longer an active unit.
flags1 has_mood
flags1 had_mood
flags1 marauder
flags1 drowning
flags1 merchant Set on caravan Merchants and their pack animals.
flags1 forest The creature is a Friendly npc and not a citizen of the fortress. Set on caravan guards, for instance.
flags1 left
flags1 rider
flags1 incoming
flags1 diplomat
flags1 temp_flag
flags1 check_active_heist
flags1 can_swap
flags1 on_ground Whether the creature is ☺ lying prone on the ground.
flags1 projectile Used for creatures in ☺ projectile status (thrown, falling, or jumping).
flags1 active_invader
flags1 hidden_in_ambush The creature is stealthed and not visible until noticed by someone. Used by gremlins, werebeasts, ambushing invaders, and adventure mode Adv ui S.pngS sneaking.
flags1 invader_origin
flags1 coward
flags1 hidden_ambusher
flags1 invades
flags1 check_flows
flags1 ridden
flags1 caged
flags1 tame
flags1 chained
flags1 royal_guard
flags1 fortress_guard
flags1 suppress_wield
flags1 important_historical_figure
flags2 swimming
flags2 sparring
flags2 no_notify
flags2 uniquebody
flags2 calculated_nerves
flags2 calculated_bodyparts
flags2 important_historical_figure
flags2 killed
flags2 cleanup_1
flags2 cleanup_2
flags2 cleanup_3
flags2 for_trade
flags2 trade_resolved
flags2 has_breaks
flags2 gutted Creature has its guts spilled, which incurs a movement penalty and counts as a major injury.
flags2 must_forget_completely_keep_rooms
flags2 locked_in_for_trading
flags2 slaughter The animal is queued for being slaughtered in fortress mode.
flags2 underworld Marks the creature as an Underworld demon.
flags2 resident Creature is a hostile Current Resident, for example if you happen to embark on a dragon lair, or unretire a fortress with a forgotten beast already present.
flags2 cleanup_4
flags2 calculated_insulation
flags2 visitor_uninvited Creature is a hostile Uninvited Guest. Used on rampaging megabeasts.
flags2 visitor Creature is a visitor in fortress mode.
flags2 calculated_inventory
flags2 vision_good
flags2 vision_damaged
flags2 vision_missing
flags2 breathing_good
flags2 breathing_problem
flags2 roaming_wilderness_population_source
flags2 roaming_wilderness_population_source_not_a_map_feature
flags3 body_part_relsize_computed
flags3 size_modifier_computed
flags3 stuck_weapon_computed
flags3 compute_health
flags3 announce_titan Displays a pop-up message announcing the arrival of a megabeast.
The Forgotten Beast Juwog has come! A towering blob composed of flame. It has a stubby tail and it has a bloated body. Beware its fire!
flags3 training_tired_wait
flags3 on_crutch
flags3 weight_computed
flags3 body_temp_in_range
flags3 wait_until_reveal
flags3 scuttle Used on caravan wagons. When set on anything else, turns the creature into a "wagon" which in fortress mode is instantly scuttled, insta-killing said creature.
flags3 verify_personal_training
flags3 ghostly Turns the creature into a ghost.
flags3 just_sprung_ambush
flags3 disturbed_from_death
flags3 diving
flags3 flee_if_birth_race
flags3 no_meandering
flags3 floundering Creature flounders in the water due to insufficient swimming skill.
flags3 exit_vehicle1
flags3 exit_vehicle2
flags3 dangerous_terrain
flags3 adv_yield Creature is Status yielded icon.png surrendering. Used in adventure mode.
flags3 vision_cone_set
flags3 multipart_vision_have_at_least_damaged
flags3 emotionally_overloaded
flags3 check_reorganize_possessions
flags3 available_for_adoption The animal is allowed to be adopted as a pet in fortress mode.
flags3 gelded Creature has been gelded and cannot reproduce anymore.
flags3 marked_for_gelding The animal is queued to be gelded in fortress mode.
flags3 injury_thought
flags3 guest

Legacy hacking

The following information is mostly obsolete and superseded by df-structures.

Version identification

Version MD5 hash PE timestamp
0.40.01 legacy
0.40.01 SDL
0.40.02 legacy
0.40.02 SDL 11a7da1fda05dfc826655d8aff4e9f9b 53BEF285
0.47.04 SDL x86 6df64d9f3b413e6ad436e718ebeee070 5E5B11F9

General offsets

Legacy versions

Description 0.40.01 legacy 0.40.02 legacy
cursor_xyz
mouse_x
mouse_y
mouse_z
window_dims
window_grid_x
window_grid_y
window_x (viewport_x)
window_y (viewport_y)


window_z (viewport_z)



SDL versions

Description 0.40.01 SDL 0.40.02 SDL 0.47.04 SDL x86
cursor_xyz 1D0CD40 20f8bc8
mouse_x
mouse_y 1D0CD44 20f8bcc
mouse_z 1D0CD48 20f8bd0
window_dims 20f8cd0
window_grid_x
window_grid_y 20f8cd8
window_x (viewport_x) 2a9a2f0
window_y (viewport_y) 2a9a314


window_z (viewport_z) 2976dac


Map data

Legacy versions

Description 0.40.01 legacy 0.40.02 legacy
map_data


map_info



SDL versions

Description 0.40.01 SDL 0.40.02 SDL 0.47.04 SDL x86
map_data 2996f24 2be609c


map_info 2996f3c ?

map_info struct

Type Name Description
int32 block_count_x Size of the current map region in 16x16 blocks.
int32 block_count_y
int32 block_count_z Should be the same as tile_count_z
int32 tile_count_x Size of the current map region in tiles.
int32 tile_count_y
int32 tile_count_z
int32 region_x Position of the current map region within the world as a whole.
int32 region_y
int32 region_z Base Z-level - add this to Z coordinates to get the Z-level displayed on the screen

Map block data offsets

Description 0.40.01–02 0.47.04 SDL x86
map_data_map_x_offset 0060 0054
map_data_map_y_offset 0062 0056
map_data_map_z_offset 0064 0058
map_data_tiletype_offset 006a 005e
map_data_designation_offset 026c 0260
map_data_occupancy_offset 066c 0660
map_data_0a60_offset 0A6c 0A60
map_data_pathfinding_offset 0D6c 0D60
map_data_1160_offset 116c 1160
map_data_1360_offset 136c 1360
map_data_temperature1_offset 156c 1560
map_data_temperature2_offset 176c 1760
map_data_1960_offset 196c 1960
map_data_1b60_offset 1B6c 1B60