Print

Please login or register.
1 Hour 1 Day 1 Week 1 Month Forever
Login with username, password and session length

[myk]

 

Is dfhack.world.cur_year_tick_advmode working as intended?

You mean df.global.world, not dfhack.world, right? cur_year_tick_advmode only exists in the former. Those variables are set by DF, not DFHack. They "work as intended" by definition. It's just that we might not fully understand what they mean.

[doublestrafe]

Is dfhack.world.cur_year_tick_advmode working as intended?

You mean df.global.world, not dfhack.world, right? cur_year_tick_advmode only exists in the former. Those variables are set by DF, not DFHack. They "work as intended" by definition. It's just that we might not fully understand what they mean.

Bleh. I was in fact thinking of df.global.cur_year_tick_advmode. Too many similarly named places and too much staring at them in the last few days. Think I was thinking of functions like dfhack.world.ReadCurrentTick(), which would be under your control and could theoretically be pointing at the wrong thing.

[myk]

Hi all! The first cycle of DFHack's usability overhaul is just about complete, and we're looking for beta testers.

Specifically, we're looking for feedback about:

1. The new in-game command launcher with autocomplete, history search, mouse controls, and integrated help (bring up the launcher from any screen with the backtick hotkey)

2. The contents, formatting, and readability of the help text that is displayed in the help area of the launcher

You should be able to do everything you want with DFHack and get all the help you need without having to leave the game to read online docs or type things in the DFHack terminal.

There are, of course, a few caveats. Number one is that mouse controls are fairly basic. You can click on "buttons" and move the text cursor with a mouse click, but scrolling with the mouse wheel, click-and-drag, and copy/pasting with the operating system-provided clipboard are just not possible in dwarf fortress. You scroll the help text in the launcher by left/right clicking to jump by half-pages or by using the Pgup/Pgdn keys. I'm not sure if we can do better than that right now. Maybe the next version of DF will provide a more consistent way to scroll. If it does, DFHack will be sure to integrate with it. (Note that you *can* map your scroll wheel in DF to simulate the keystrokes that would scroll the text, but this is not the default configuration)

The second caveat is that while we have rewritten hundreds of pages of documentation over the past few months, we haven't updated the devel or modtools script help yet. These scripts are hidden in the launcher by default, so you might not even notice, but if you do investigate those scripts and find some "TODO" notes, that's why.

Please DM me or reply to this post if you're interested in giving feedback!

[myk]

The steps to install the DFHack pre-release are:

• Delete the "hack" directory in your Dwarf Fortress folder
• Download the correct "Build artifact" (at the bottom of the page) for your platform from here
• Extract the archive to your Dwarf Fortress folder (see here for detailed installation instructions)

Note that the location of DFHack init files has changed from the root of the Dwarf Fortress folder to dfhack-config/init. If you have made custom changes to your DFHack init files, copy just your changes to dfhack-config/init. If you haven't made any custom changes to DFHack init files, you don't have to do anything.

Here are some things you can try:

• hit backtick (the other symbol on the tilde key) to bring up the in-game DFHack interface. Try to use it as your only way to run DFHack commands.
• start typing a command and then use Tab (or click on a list item) to autocomplete.
• start typing a command that you have run before and hit Alt-S (or click on the "Search" text button) to bring up an entire commandline from your history. Try pressing Alt-S multiple times to cycle through matches in your history if the first one isn't the one you want.
• Read the help text. Scroll down or up by left/right clicking on the help text area. You can also use Pgdn/Pgup or Ctrl-Down/Ctrl-Up for scrolling too.
• After you type a command you're familiar with, look at the autocomplete list to see related commands. Click on one of them and explore something new!

[Rumrusher]

ok so got around to finishing testing the latest version of the 'tofort for player forts only' script called topfort.

so far going from fort mode to adv mode would work, though probably best to make the player fort size around 3x3 until the day I/someone figures out how to adjust the size of the mapedge borders for the site size.

while I might say this version of warmist script is more stable than the previous one it still has some stuff that I probably missed in testing and some bugs that might come up during modded gameplay... or drinking in taverns.

Spoiler: "topfort6.lua" (click to show/hide)

Code: ("topfort6.lua") [Select]

-- changes from advmode to fort safely and back (hopefully) uhh this is version 6 of the alternate tofort script warmist made I been modifying called topfort
-- this version of the script is made for players to jump into their old player forts from adv mode as an alternative means to retiring... so far
-- this method of unretiring doesn't spill the fort's supply of goods...
-- oh yeah be careful on swapping around different player forts or going back to an old Player fort after making a new one as the game doesn't clear mapedge between game modes when retiring
-- so data in fort mode might be stored if retired in adv mode and vice versa
if df.global.gamemode==df.game_mode.ADVENTURE then
local adv=df.global.world.units.active[0]
local ui=df.global.ui
function advGlobalPos()
    local wd=df.global.world.world_data
    return wd.adv_region_x*16+wd.adv_emb_x,wd.adv_region_y*16+wd.adv_emb_y
end
function inSite()
    local tx,ty=advGlobalPos()
    for k,v in pairs(df.global.world.world_data.sites) do
        local tp2={v.global_min_x, v.global_min_y, v.global_max_x, v.global_max_y}
        if tx>=tp2[1] and tx<=tp2[3] and
            ty>=tp2[2] and ty<=tp2[4] then
            return v
        end
    end
end
local site=inSite()
if site==nil then
    qerror("No site you are in found.")
end
local h_ent
if ui.main.fortress_entity==nil or ui.main.fortress_entity.site_links[0].target~=inSite().id then
    for k,v in pairs(df.global.world.entities.all) do
        if v.type==df.historical_entity_type.SiteGovernment and v.site_links[0].target==inSite().id then --maybe match race too?
            h_ent=v
            break
        end
    end
    if h_ent==nil then
        qerror("Valid historical entity not found. sorry...")
    end
    ui.main.fortress_entity=h_ent
else
    h_ent=ui.main.fortress_entity
end
local carter={}
function addToEntity(entity,unit,addtoLead)
    local nem=dfhack.units.getNemesis(unit)
    local hfig=nem.figure
        for k,v in pairs(hfig.entity_links) do
if v.entity_id==entity.id then break else
carter=true
end
end
if carter==true then
    hfig.entity_links:insert("#",{new=df.histfig_entity_link_memberst,entity_id=entity.id,link_strength=100})
    entity.nemesis_ids:insert("#",nem.id)
    entity.nemesis:insert("#",nem)
    entity.histfig_ids:insert("#",hfig.id)
    entity.hist_figures:insert("#",hfig)
end
    if addtoLead then
        local lead_id
        for k,v in pairs(entity.positions.own) do
            if v.flags.IS_LEADER==true then
                lead_id=v.id
                break
            end
        end
        if lead_id~=nil then
            for k,v in pairs(entity.positions.assignments) do
                if v.position_id==lead_id  then
                        v.histfig=hfig.id
                    break
                end
            end
        end
    end
end
function cleardesignate(adv)
local adv=df.global.world.units.active[0]
df.global.ui.main.mode=10
df.global.selection_rect.start_x=0
df.global.selection_rect.start_y=0
df.global.selection_rect.start_z=610
df.global.selection_rect.end_x=-14300
df.global.selection_rect.end_y=9000
df.global.selection_rect.end_z=0
df.global.cursor.x=400
df.global.cursor.y=400
df.global.cursor.z=0
dfhack.gui.getCurViewscreen():feed_key(1)
df.global.cursor.x=adv.pos.x
df.global.cursor.y=adv.pos.y
df.global.cursor.z=adv.pos.z
dfhack.gui.getCurViewscreen():feed_key(1)
dfhack.run_command('revflood')

end


ui.civ_id=adv.civ_id
ui.race_id=adv.race
ui.unk_races:insert("#",adv.race)
--if ui.unk_races==0 then ui.unk_races:insert("#",adv.race) end
ui.site_id=site.id
if ui.main.fortress_site==nil or ui.main.fortress_site.id~=ui.site_id then ui.main.fortress_site=site end
--if ui.main.fortress_site==nil or ui.main.fortress_site~=site or ui.main.fortress_site.id~=ui.site_id then ui.main.fortress_site=site end
--if site.entity_links==nil then site.entity_links:insert("#", {new=true, df.entity_site_link, target=site.id, entity_id=ui.fortress_entity.id, flags[0]=true, flags[5]=true }) end end
if site.entity_links==nil then site.entity_links:insert("#", {new=true, df.entity_site_link, target=site.id, entity_id=ui.fortress_entity.id}) end
ui.group_id=h_ent.id
ui.game_state=2


    local nem2=dfhack.units.getNemesis(adv)
    local hfig2=nem2.figure
    local nomad2=hfig2.entity_links[0]
    local nomad3=hfig2.entity_links
    local Test={}
    for co2,mp2 in pairs(nomad3) do
--print(mp2.entity_id,h_ent.id)
        if mp2.entity_id~=h_ent.id then Test=true else
            Test=false
            end
        end   
        if Test==true then
            addToEntity(h_ent,adv,false)
        end
    for co,mp in pairs(df.global.world.units.active) do
if mp.population_id==h_ent.id then
mp.flags2.resident=false
end
if mp.civ_id==h_ent.id or adv.civ_id==mp.civ_id then
mp.flags2.resident=false
end
        if mp.relationship_ids.GroupLeader==adv.id then
            local comp=mp
        if test==true then
            addToEntity(h_ent,comp,false)
        end
    end
end

function filleco(tbl,low,high)
  for v =low, high do
    tbl.general_items:insert("#",2)
  end
     tbl.weapons:insert("#",2)
    tbl.armor:insert("#",2)
    tbl.handwear:insert("#",2)
    tbl.footwear:insert("#",2)
    tbl.legwear:insert("#",2)
    tbl.headwear:insert("#",2)
    tbl.prepared_food:insert("#",2)
    tbl.wood:insert("#",2)
    tbl.thread_cloth:insert("#",2)
    tbl.paper:insert("#",2)
    tbl.parchment:insert("#",2)
    tbl.bone:insert("#",2)
    tbl.tooth:insert("#",2)
    tbl.horn:insert("#",2)
    tbl.pearl:insert("#",2)
    tbl.shell:insert("#",2)
    tbl.leather:insert("#",2)
    tbl.silk:insert("#",2)
    tbl.yarn:insert("#",2)
    tbl.inorganic:insert("#",2)
    tbl.meat:insert("#",2)
    tbl.fish:insert("#",2)
    tbl.plants:insert("#",2)
    tbl.drinks:insert("#",2)
    tbl.extract_animal:insert("#",2)
    tbl.mill_animal:insert("#",2)
    tbl.cheese_animal:insert("#",2)
    tbl.extract_plant:insert("#",2)
    tbl.mill_plant:insert("#",2)
    tbl.cheese_plant:insert("#",2)
    tbl.pets:insert("#",2)

end
function filleco2(tbl,low,high)
  for v =low, high do
    --tbl[v].unk1=site.pos.x
    --tbl.unk1:insert("#",site.pos.x)
    --tbl.unk2:insert("#",site.pos.y)
    tbl.general_items:insert("#",nil)
     --tbl[v].unk2=site.pos.y
  end
 
     tbl.weapons:insert("#",nil)
    tbl.armor:insert("#",nil)
    tbl.handwear:insert("#",nil)
    tbl.footwear:insert("#",nil)
    tbl.legwear:insert("#",nil)
    tbl.headwear:insert("#",nil)
    tbl.prepared_food:insert("#",nil)
    tbl.wood:insert("#",nil)
    tbl.thread_cloth:insert("#",nil)
    tbl.paper:insert("#",nil)
    tbl.parchment:insert("#",nil)
    tbl.bone:insert("#",nil)
    tbl.tooth:insert("#",nil)
    tbl.horn:insert("#",nil)
    tbl.pearl:insert("#",nil)
    tbl.shell:insert("#",nil)
    tbl.leather:insert("#",nil)
    tbl.silk:insert("#",nil)
    tbl.yarn:insert("#",nil)
    tbl.inorganic:insert("#",nil)
    tbl.meat:insert("#",nil)
    tbl.fish:insert("#",nil)
    tbl.plants:insert("#",nil)
    tbl.drinks:insert("#",nil)
    tbl.extract_animal:insert("#",nil)
    tbl.mill_animal:insert("#",nil)
    tbl.cheese_animal:insert("#",nil)
    tbl.extract_plant:insert("#",nil)
    tbl.mill_plant:insert("#",nil)
    tbl.cheese_plant:insert("#",nil)
    tbl.pets:insert("#",nil)

end

function fill(tbl,low,high)
  for v =low, high do
    tbl:insert("#",0)
    tbl:insert("#",v)
    tbl:insert("#",143)
    tbl:insert("#",v)
  end
end
function fill2(tbl,low,high)
  for v =low, high do
    tbl:insert("#",v)
    tbl:insert("#",143)
    tbl:insert("#",v)
    tbl:insert("#",0)
  end
end
function fillz(tbl,low,high)
  for v =low, high do
    tbl:insert("#",adv.pos.z)
    tbl:insert("#",adv.pos.z)
    tbl:insert("#",adv.pos.z)
    tbl:insert("#",adv.pos.z)
  end
end
function fillunk(tbl,low,high)
  for v =low, high do
    tbl[v].unk1=site.pos.x
    tbl[v].unk2=site.pos.y
  end
end
function fillanimal(tbl,low,high)
  for v =low, high do
    tbl:insert("#",1)
  end
end
function fillstone(tbl,low,high)
  for v =low, high do
    tbl:insert("#",0)
  end
end


function mapcheck2()

fill(df.global.ui.unk_mapedge_x,0,143)
fill2(df.global.ui.unk_mapedge_y,0,143)
fillz(df.global.ui.unk_mapedge_z,0,143)

fill(df.global.ui.map_edge.surface_x,0,143)
fill2(df.global.ui.map_edge.surface_y,0,143)
fillz(df.global.ui.map_edge.surface_z,0,143)

for _,Lay in pairs(df.global.ui.map_edge.layer_x) do

fill(Lay,0,143)
end
for _,Lay in pairs(df.global.ui.map_edge.layer_y) do
fill2(Lay,0,143)
end
for _,Lay in pairs(df.global.ui.map_edge.layer_z) do
fillz(Lay,0,143)
end
end
function sigh()
 mapcheck()
 mapcheck2()
for k,v in pairs(df.global.ui.unk_mapedge_x) do

end
for k,v in pairs(df.global.ui.map_edge.surface_z) do
df.global.ui.map_edge.surface_z[k]=adv.pos.z
--v=152
end
end
function mapcheck()
fillunk(df.global.ui.unk2a8c[0],0,143)
fillunk(df.global.ui.unk2a8c[1],0,143)
fillunk(df.global.ui.unk2a8c[2],0,143)
fillunk(df.global.ui.unk2a8c[3],0,143)

end
Tab={}
Tab2={}
for k,Lay2 in pairs(df.global.ui.map_edge.layer_z) do
for k2,Lay3 in pairs(df.global.ui.unk2a8c[0]) do
if k then break else
Tab:insert("#",k)
end
Tab2:insert("#",k2)
return Tab,Tab2
end
end
if #df.global.ui.map_edge.layer_z[0] == 0 then
print("map edge empty proceed to fill")
sigh()
 else
print("welp map edge currently full")
 end


if ui.main.fortress_entity.squads==0 then
for Sqa,Ds in pairs (df.global.world.squads.all) do
if Ds.entity_id==ui.main.fortress_entity.id then
ui.main.fortress_entity.squads:insert("#",{new=true,Ds})
end
end
end

if #ui.tasks.discovered_plants==0 then

for k,Lay2 in ipairs(df.global.world.raws.creatures.all) do
fillanimal(df.global.ui.tasks.discovered_creatures,0,k)
--return k
end
for k,Lay2 in ipairs(df.global.world.raws.creatures.all) do
fillanimal(df.global.ui.tasks.discovered_creature_foods,0,k)
--return k
end

for k,Lay2 in ipairs(df.global.world.raws.plants.all) do
fillanimal(df.global.ui.tasks.discovered_plants,0,k)
--return k
end
for k,Lay2 in ipairs(df.global.world.raws.plants.all) do
fillanimal(df.global.ui.tasks.discovered_plant_foods,0,k)
--return k
end

end

if #ui.alerts.list==0 then
    ui.alerts.list:insert("#",{new=true,name="Dummy alert"})
    ui.alerts.next_id=1
end
if #ui.kitchen.item_types==0 then
ui.kitchen.item_types:insert("#",0)
ui.kitchen.item_subtypes:insert("#",0)
ui.kitchen.mat_types:insert("#",0)
ui.kitchen.mat_indices:insert("#",0)
ui.kitchen.exc_types:insert("#",0)
end
if #ui.unk_9==0 then
ui.unk_9:insert("#",0)
ui.unk_9:insert("#",0)
ui.unk_10:insert("#",0)
ui.unk_10:insert("#",0)
ui.unk_11:insert("#",0)
ui.unk_11:insert("#",0)
end
if #ui.economic_stone==0 then
for k,Lay2 in ipairs(df.global.world.raws.inorganics) do
fillstone(df.global.ui.economic_stone,0,k)
--return k
end
end

if ui.economy_prices.price_adjustment.general_items==0 then

filleco(df.global.ui.economy_prices.price_adjustment,0,114)
filleco2(df.global.ui.economy_prices.price_setter,0,114)

end

--fix training info
if h_ent.training_knowledge == nil then
    h_ent.training_knowledge={new=true}
end
df.global.gamemode=df.game_mode.DWARF
df.global.gametype=df.game_type.DWARF_MAIN
if df.global.gview.view.child.child==nil then df.global.gview.view.child=df.viewscreen_dwarfmodest:new()
df.global.gview.view.child.parent=df.global.gview.view
 end
 cleardesignate(adv)
    print("Mode change complete. Now save and load")
else
    local adv=dfhack.gui.getSelectedUnit(true)
    if adv then
        --swap units...
    end
    df.global.gamemode=df.game_mode.ADVENTURE
    df.global.gametype=df.game_type.ADVENTURE_MAIN
df.global.gview.view.child=df.viewscreen_dungeonmodest:new()
df.global.gview.view.child.parent=df.global.gview.view
    print("Mode change complete. Now save and load")
end


so probably best to use this script in the middle of your fort on the surface first if you're going from adv to fort mode, or you might set the mapedge to the middle of solid rock and soil if you do this underground.
that is if the mapedge is cleared.
and if there is any screw ups with fort mapedges at least there's the z level resetting script I made before.

oh yeah syndromes might linger indefintantly still with this use and probably get fixed on map unload via fast traveling... but doing that might cause you to re-set a bunch of fort settings like locations being not adjusted and some folks not having their beds assigned but this script does seem to make some assigned rooms stick so I don't know if that's due to stored ui data or what.

I probably stick with saving the game in the game mode you started in for sanity safety checks... and beware of important location overlaying your site when switching into the different game mode as it might pick up that site instead.
other than that have fun:
 using adv mode talking and personal actions in fort mode scenarios like convincing some guest their book they been carrying is worth the tradeexchange for a looted battleaxe from some random keep you visited, or applying a chokehold on someone who ambushed the site leading to someone jumping in to kill them for you.
or convince the local 'agent villian' to join your militia dwarves and send them off on a mission to fight some mercinaries and make bets on if they come back alive or not.
exchange goods with folks that trading prevents you too, like hauling corpses and rotting goods off your lands for charity.
be able to interrogate folks with out need of a crime to pin on them.

explore the world then use the discovered locations as prime invasion targets for your group of hand pick militia of different shapes and sizes and possibly use the event rumor of their arrival to mass rescue the locals of the location to then later convert them into another militia group to kickstart another invasion operation.

set up arenas where winner gets to join the fort and the loser gets to also join the fort just later after you resurrect them.

deal with vampires personally
and many more fort mode scenarios I could possibly think of that could use an adventurer's skill set.

edit: ok after some long period of testing I for sure figure out the issue with caravans.
I would have dump the code here but I already gone past the character limit so instead here's a Github link to both updated versions of Tofort and topfort ... called tofort16 and topfort7.
https://gist.github.com/Rumrusher/5a83f2bc103cc270f9bdf77c1f1dbd06
oh yeah

you probably want to use this for mapedge(and additional ui bonus) clearing though I should warn you run this in adv mode before running the tofort scripts. 

Code: ("ui-clean.lua") [Select]

while #df.global.ui.tasks.discovered_creatures > 0 do
df.global.ui.tasks.discovered_creatures:erase(#df.global.ui.tasks.discovered_creatures-1)
end
while #df.global.ui.tasks.discovered_creature_foods > 0 do
df.global.ui.tasks.discovered_creature_foods:erase(#df.global.ui.tasks.discovered_creature_foods-1)
end
while #df.global.ui.tasks.discovered_plants > 0 do
df.global.ui.tasks.discovered_plants:erase(#df.global.ui.tasks.discovered_plants-1)
end
while #df.global.ui.tasks.discovered_plant_foods > 0 do
df.global.ui.tasks.discovered_plant_foods:erase(#df.global.ui.tasks.discovered_plant_foods-1)
end
while #df.global.ui.unk_mapedge_x > 0 do
df.global.ui.unk_mapedge_x:erase(#df.global.ui.unk_mapedge_x-1)
end

   while #df.global.ui.unk_mapedge_y > 0 do
    df.global.ui.unk_mapedge_y:erase(#df.global.ui.unk_mapedge_y-1)
    end
   while #df.global.ui.unk_mapedge_z > 0 do
    df.global.ui.unk_mapedge_z:erase(#df.global.ui.unk_mapedge_z-1)
    end
while #df.global.ui.map_edge.surface_x > 0 do
    df.global.ui.map_edge.surface_x:erase(#df.global.ui.map_edge.surface_x-1)
    end
while #df.global.ui.map_edge.surface_y > 0 do
    df.global.ui.map_edge.surface_y:erase(#df.global.ui.map_edge.surface_y-1)
    end
while #df.global.ui.map_edge.surface_z > 0 do
    df.global.ui.map_edge.surface_z:erase(#df.global.ui.map_edge.surface_z-1)
    end
while #df.global.ui.map_edge.layer_z[0] > 0 do
    df.global.ui.map_edge.layer_z[0]:erase(#df.global.ui.map_edge.layer_z[0]-1)
    end
while #df.global.ui.map_edge.layer_z[1] > 0 do
    df.global.ui.map_edge.layer_z[1]:erase(#df.global.ui.map_edge.layer_z[1]-1)
    end
while #df.global.ui.map_edge.layer_z[2] > 0 do
    df.global.ui.map_edge.layer_z[2]:erase(#df.global.ui.map_edge.layer_z[2]-1)
    end
while #df.global.ui.map_edge.layer_z[3] > 0 do
    df.global.ui.map_edge.layer_z[3]:erase(#df.global.ui.map_edge.layer_z[3]-1)
    end
while #df.global.ui.map_edge.layer_z[4] > 0 do
    df.global.ui.map_edge.layer_z[4]:erase(#df.global.ui.map_edge.layer_z[4]-1)
    end
while #df.global.ui.map_edge.layer_x[0] > 0 do
    df.global.ui.map_edge.layer_x[0]:erase(#df.global.ui.map_edge.layer_x[0]-1)
    end
while #df.global.ui.map_edge.layer_x[1] > 0 do
    df.global.ui.map_edge.layer_x[1]:erase(#df.global.ui.map_edge.layer_x[1]-1)
    end
while #df.global.ui.map_edge.layer_x[2] > 0 do
    df.global.ui.map_edge.layer_x[2]:erase(#df.global.ui.map_edge.layer_x[2]-1)
    end
while #df.global.ui.map_edge.layer_x[3] > 0 do
    df.global.ui.map_edge.layer_x[3]:erase(#df.global.ui.map_edge.layer_x[3]-1)
    end
while #df.global.ui.map_edge.layer_x[4] > 0 do
    df.global.ui.map_edge.layer_x[4]:erase(#df.global.ui.map_edge.layer_x[4]-1)
    end
while #df.global.ui.map_edge.layer_y[0] > 0 do
    df.global.ui.map_edge.layer_y[0]:erase(#df.global.ui.map_edge.layer_y[0]-1)
    end
while #df.global.ui.map_edge.layer_y[1] > 0 do
    df.global.ui.map_edge.layer_y[1]:erase(#df.global.ui.map_edge.layer_y[1]-1)
    end
while #df.global.ui.map_edge.layer_y[2] > 0 do
    df.global.ui.map_edge.layer_y[2]:erase(#df.global.ui.map_edge.layer_y[2]-1)
    end
while #df.global.ui.map_edge.layer_y[3] > 0 do
    df.global.ui.map_edge.layer_y[3]:erase(#df.global.ui.map_edge.layer_y[3]-1)
    end
while #df.global.ui.map_edge.layer_y[4] > 0 do
    df.global.ui.map_edge.layer_y[4]:erase(#df.global.ui.map_edge.layer_y[4]-1)
    end

function fillunk(tbl,low,high)
  for v =low, high do
    tbl[v].unk1=0
    tbl[v].unk2=0
  end
end
fillunk(df.global.ui.unk2a8c[0],0,143)
fillunk(df.global.ui.unk2a8c[1],0,143)
fillunk(df.global.ui.unk2a8c[2],0,143)
fillunk(df.global.ui.unk2a8c[3],0,143)
so this mostly means switching between fort mode and adv mode is mostly stable.
like I could probably flip between the two and not have to worry about Too much stuff going wrong.

outside of like sending the adventurer on a raid which shuffles the active unit list and makes shifting into adv mode a risk where you could pop into the body of some cavern critter... but that' something that could be avoided with remembering that could happen.

[myk]

DFHack 0.47.05-r7 has been released!

Download it here!
This is the first usability-focused DFHack release. The major new feature is the in-game command launcher with integrated help, autocomplete, command history (including history search), related tools display, and mouse integration.

You can access the new command launcher by clicking on the "[ DFHack Launcher ]" button in the lower left corner of the screen or by tapping the backquote (`) key. If the backquote key isn't convenient or isn't available for your keyboard layout, there is an alternate hotkey of Ctrl-Shift-D.

You can type part of a command to see autocomplete options. Hit Tab or click on an option to autocomplete. To pull a full commandline from your history, hit Alt-S or click on the "history search" button instead. When you type a command, its help text will be displayed in the large panel at the bottom. Hit Enter or click on the 'run" button to run. That's it! More info on the launcher here (which you can also see in-game when you type "gui/launcher" in the command box : )

From the screenshots, you may notice that text areas now have scrollbars. Click on the arrows at the end to scroll by one line, or on the empty area above or below the green part of the bar to scroll by half pages. You can also click on the command text that you are writing to reposition the cursor for editing.

Many thanks to the community members and beta testers who provided feedback on the launcher! Many of the best usability features were suggested by them! In particular, u/ZergTDG, u/Skitlee5, u/Thebuda, and u/tmPreston. You're awesome! Also D.B. Cooper, Quietust, and everyone else on the DFHack discord who gave feedback throughout development.

DFHack help itself has also been overhauled. More than 300 pages of help text has been reformatted and rewritten to make them more informative, easier to read, and easier to understand. Moreover, all DFHack tools are now tagged so that you can find them easier. Try running the new tags command to explore the categories! These tags also control what is in the list of related tools that appears in the right panel of the launcher when you are running a command.

New stuff

Apart from the aforementioned gui/launcher and tags, there's a bunch of great new stuff in this release:

- u/wolfboyft wrote the DFHack modding guide, which will get you up to speed if you'd like to explore how to use DFHack to extend your raws modding.
- run enable gui/kitchen-info to add more info to the Kitchen screen, including what each ingredient is good for besides cooking.
- Hit "D" on the workorder details screen (where you can, say, set which kind of stone to use for a particular workorder) to get more control over the materials used to fulfill workorder jobs.
- We finally have a good way to dynamically limit the size of the next migration wave with max-wave and limit growth over time with pop-control (or even enforce a hermit challenge!).
- Get notified when creatures that may steal your food, drinks, or items become visible (e.g. keas) with warn-stealers.
- DFHack now comes with a super useful library of manager orders! See them with orders list and import them into your game with orders import. Try orders import library/basic to get a great set of orders for basic fort necessities! More info here.
- DFHack's implementation of DwarfTherapist (manipulator -- accessible from the u-l screen) now comes with a library of pre-made professions that you can apply to your dwarves. More info here.

We are also working mouse controls into more of the DFHack tools. For example, you can now move the blueprint preview around by clicking on the map when using gui/quickfort. You can interact with the map with the mouse in similar ways when using gui/quantum and gui/blueprint. Expect more mouse capabilities for DFHack tools in the future!

How to upgrade

A few files have moved around in this release, so if you're upgrading an existing installation, please read this section.

- When upgrading to this release, please *remove* the dfhack-config/dwarfmonitor.json file. It will get regenerated the next time you run DF. If you don't regenerate this file, the weather indicator (e.g. "Rain") will overlap with the new DFHack button in the lower left corner. If you have custom modifications to this file that you'd like to keep, please merge them back in once the file has been regenerated.
- DFHack init scripts (dfhack.init, onLoad.init, onMapLoad.init, etc.) have moved into dfhack-config/init/. If you have not made any custom modifications to these files, you don't need to do anything. Default configuration will be generated and used. If you have custom changes, please run DF once to generate the default config files and then move *just your custom changes* into the corresponding init files. See the docs for details.
- The history files for the various interactive DFHack commandline tools have moved into dfhack-config/. If you want to keep your command histories, please move your existing *.history files into dfhack-config/. Note that the new gui/launcher interface will make the commands in your old dfhack.history file available for searching even if you never get around to moving that file to the new directory.

And, just like every DFHack release, please remove the hack/ directory in your DF game folder before extracting the new version of DFHack into your DF folder. There were several scripts and other files that were removed in this release. If you don't remove the hack/ directory before upgrading, the old, unusable scripts will clutter the autocomplete list in the command launcher.

Screenshots

[myk]

Full changelog:

Spoiler (click to show/hide)

DFHack 0.47.05-r7
=================

New Plugins
-----------
- `autobutcher`: split off from `zone` into its own plugin. Note that to enable, the command has changed from ``autobutcher start`` to ``enable autobutcher``.
- `autonestbox`: split off from `zone` into its own plugin. Note that to enable, the command has changed from ``autonestbox start`` to ``enable autonestbox``.
- `overlay`: display a "DFHack" button in the lower left corner that you can click to start the new GUI command launcher. The `dwarfmonitor` weather display had to be moved to make room for the button. If you are seeing the weather indicator rendered over the overlay button, please remove the ``dfhack-config/dwarfmonitor.json`` file to fix the weather indicator display offset.

New Scripts
-----------
- `gui/kitchen-info`: adds more info to the Kitchen screen
- `gui/launcher`: in-game command launcher with autocomplete, history, and context-sensitive help
- `gui/workorder-details`: adjusts work orders' input item, material, traits
- `max-wave`: dynamically limit the next immigration wave, can be set to repeat
- `pop-control`: persistent per fortress population cap, `hermit`, and `max-wave` management
- `warn-stealers`: warn when creatures that may steal your food, drinks, or items become visible

New Internal Commands
---------------------
- `tags`: new built-in command to list the tool category tags and their definitions. tags associated with each tool are visible in the tool help and in the output of `ls`.

Fixes
-----
- `autochop`: designate largest trees for chopping first, instead of the smallest
- `devel/query`: fixed error when --tile is specified
- `dig-now`: Fix direction of smoothed walls when adjacent to a door or floodgate
- `dwarf-op`: fixed error when applying the Miner job to dwarves
- `emigration`: fix emigrant logic so unhappy dwarves leave as designed
- `gui/gm-unit`: allow ``+`` and ``-`` to adjust skill values as intended instead of letting the filter intercept the characters
- `gui/unit-info-viewer`: fix logic for displaying undead creature names
- `gui/workflow`: restore functionality to the add/remove/order hotkeys on the workflow status screen
- `quickfort`: `Dreamfort <quickfort-blueprint-guide>` blueprint set: declare the hospital zone before building the coffer; otherwise DF fails to stock the hospital with materials
- `view-item-info`: fixed a couple errors when viewing items without materials
- ``dfhack.buildings.findCivzonesAt``: no longer return duplicate civzones after loading a save with existing civzones
- ``dfhack.run_script``: ensure the arguments passed to scripts are always strings. This allows other scripts to call ``run_script`` with numeric args and it won't break parameter parsing.
- ``job.removeJob()``: ensure jobs are removed from the world list when they are canceled

Misc Improvements
-----------------
- History files: ``dfhack.history``, ``tiletypes.history``, ``lua.history``, and ``liquids.history`` have moved to the ``dfhack-config`` directory. If you'd like to keep the contents of your current history files, please move them to ``dfhack-config``.
- Init scripts: ``dfhack.init`` and other init scripts have moved to ``dfhack-config/init/``. If you have customized your ``dfhack.init`` file and want to keep your changes, please move the part that you have customized to the new location at ``dfhack-config/init/dfhack.init``. If you do not have changes that you want to keep, do not copy anything, and the new defaults will be used automatically.
- UX:
    - You can now move the cursor around in DFHack text fields in ``gui/`` scripts (e.g. `gui/blueprint`, `gui/quickfort`, or `gui/gm-editor`). You can move the cursor by clicking where you want it to go with the mouse or using the Left/Right arrow keys.  Ctrl+Left/Right will move one word at a time, and Alt+Left/Right will move to the beginning/end of the text.
    - You can now click on the hotkey hint text in many ``gui/`` script windows to activate the hotkey, like a button. Not all scripts have been updated to use the clickable widget yet, but you can try it in `gui/blueprint` or `gui/quickfort`.
    - Label widget scroll icons are replaced with scrollbars that represent the percentage of text on the screen and move with the position of the visible text, just like web browser scrollbars.
- `devel/query`:
    - inform the user when a query has been truncated due to ``--maxlength`` being hit.
    - increased default maxlength value from 257 to 2048
- `do-job-now`: new global keybinding for boosting the priority of the jobs associated with the selected building/work order/unit/item etc.: Alt-N
- `dwarf-op`: replaces [ a b c ] option lists with a,b,c option lists
- `gui/gm-unit`: don't clear the list filter when you adjust a skill value
- `gui/quickfort`:
    - better formatting for the generated manager orders report
    - you can now click on the map to move the blueprint anchor point to that tile instead of having to use the cursor movement keys
    - display an error message when the blueprints directory cannot be found
- `gui/workorder-details`: new keybinding on the workorder details screen: ``D``
- `keybinding`: support backquote (\`) as a hotkey (and assign the hotkey to the new `gui/launcher` interface)
- `ls`: can now filter tools by substring or tag. note that dev scripts are hidden by default. pass the ``--dev`` option to show them.
- `manipulator`:
    - add a library of useful default professions
    - move professions configuration from ``professions/`` to ``dfhack-config/professions/`` to keep it together with other dfhack configuration. If you have saved professions that you would like to keep, please manually move them to the new folder.
- `orders`: added useful library of manager orders. see them with ``orders list`` and import them with, for example, ``orders import library/basic``
- `prioritize`: new ``defaults`` keyword to prioritize the list of jobs that the community agrees should generally be prioritized. Run ``prioritize -a defaults`` to try it out in your fort!
- `prospect`: add new ``--show`` option to give the player control over which report sections are shown. e.g. ``prospect all --show ores`` will just show information on ores.
- `quickfort`:
    - `Dreamfort <quickfort-blueprint-guide>` blueprint set improvements: set traffic designations to encourage dwarves to eat cooked food instead of raw ingredients
    - library blueprints are now included by default in ``quickfort list`` output. Use the new ``--useronly`` (or just ``-u``) option to filter out library bluerpints.
    - better error message when the blueprints directory cannot be found
- `seedwatch`: ``seedwatch all`` now adds all plants with seeds to the watchlist, not just the "basic" crops.
- ``materials.ItemTraitsDialog``: added a default ``on_select``-handler which toggles the traits.

Removed
-------
- `fix/build-location`: The corresponding DF bug (5991) was fixed in DF 0.40.05
- `fix/diplomats`: DF bug 3295 fixed in 0.40.05
- `fix/fat-dwarves`: DF bug 5971 fixed in 0.40.05
- `fix/feeding-timers`: DF bug 2606 is fixed in 0.40.12
- `fix/merchants`: DF bug that prevents humans from making trade agreements has been fixed
- `gui/assign-rack`: No longer useful in current DF versions
- `gui/hack-wish`: Replaced by `gui/create-item`
- `gui/no-dfhack-init`: No longer useful since players don't have to create their own ``dfhack.init`` files anymore

API
---
- Removed "egg" ("eggy") hook support (Linux only). The only remaining method of hooking into DF is by interposing SDL calls, which has been the method used by all binary releases of DFHack.
- Removed ``Engravings`` module (C++-only). Access ``world.engravings`` directly instead.
- Removed ``Notes`` module (C++-only). Access ``ui.waypoints.points`` directly instead.
- Removed ``Windows`` module (C++-only) - unused.
- ``Constructions`` module (C++-only): removed ``t_construction``, ``isValid()``, ``getCount()``, ``getConstruction()``, and ``copyConstruction()``. Access ``world.constructions`` directly instead.
- ``Gui::getSelectedItem()``, ``Gui::getAnyItem()``: added support for the artifacts screen
- ``Units::teleport()``: now sets ``unit.idle_area`` to discourage units from walking back to their original location (or teleporting back, if using `fastdwarf`)

Lua
---
- Added ``dfhack.screen.hideGuard()``: exposes the C++ ``Screen::Hide`` to Lua
- History: added ``dfhack.getCommandHistory(history_id, history_filename)`` and ``dfhack.addCommandToHistory(history_id, history_filename, command)`` so gui scripts can access a commandline history without requiring a terminal.
- ``helpdb``: database and query interface for DFHack tool help text
- ``tile-material``: fix the order of declarations. The ``GetTileMat`` function now returns the material as intended (always returned nil before). Also changed the license info, with permission of the original author.
- ``utils.df_expr_to_ref()``: fixed some errors that could occur when navigating tables
- ``widgets.CycleHotkeyLabel``: clicking on the widget will now cycle the options and trigger ``on_change()``. This also applies to the ``ToggleHotkeyLabel`` subclass.
- ``widgets.EditField``:
    - new ``onsubmit2`` callback attribute is called when the user hits Shift-Enter.
    - new function: ``setCursor(position)`` sets the input cursor.
    - new attribute: ``ignore_keys`` lets you ignore specified characters if you want to use them as hotkeys
- ``widgets.FilteredList``: new attribute: ``edit_ignore_keys`` gets passed to the filter EditField as ``ignore_keys``
- ``widgets.HotkeyLabel``: clicking on the widget will now call ``on_activate()``.
- ``widgets.Label``: ``scroll`` function now interprets the keywords ``+page``, ``-page``, ``+halfpage``, and ``-halfpage`` in addition to simple positive and negative numbers.

Structures
----------
- Eliminate all "anon_X" names from structure fields
- ``army``: change ``squads`` vector type to ``world_site_inhabitant``, identify ``min_smell_trigger``+``max_odor_level``+``max_low_light_vision``+``sense_creature_classes``
- ``cave_column_rectangle``: identify coordinates
- ``cave_column``: identify Z coordinates
- ``embark_profile``: identify reclaim fields, add missing pet_count vector
- ``entity_population``: identify ``layer_id``
- ``feature``: identify "shiftCoords" vmethod, ``irritation_level`` and ``irritation_attacks`` fields
- ``flow_guide``: identify "shiftCoords" vmethod
- ``general_refst``: name parameters on ``getLocation`` and ``setLocation`` vmethods
- ``general_ref_locationst``: name member fields
- ``historical_entity``: confirm ``hostility_level`` and ``siege_tier``
- ``item``: identify method ``notifyCreatedMasterwork`` that is called when a masterwork is created.
- ``language_name_type``: identify ``ElfTree`` and ``SymbolArtifice`` thru ``SymbolFood``
- ``timed_event``: identify ``layer_id``
- ``ui_advmode``: identify several fields as containing coordinates
- ``ui``: identify actual contents of ``unk5b88`` field
- ``unitst``: identify ``histeventcol_id`` field inside status2
- ``viewscreen_barterst``: name member fields
- ``viewscreen_tradegoodsst``: rename trade_reply ``OffendedAnimal``+``OffendedAnimalAlt`` to ``OffendedBoth``+``OffendedAnimal``
- ``world_site_inhabitant``: rename ``outcast_id`` and ``founder_outcast_entity_id``, identify ``interaction_id`` and ``interaction_effect_idx``

Documentation
-------------
- Added `modding-guide`
- Group DFHack tools by `tag <tools>` so similar tools are grouped and easy to find
- Update all DFHack tool documentation (300+ pages) with standard syntax formatting, usage examples, and overall clarified text.

[A_Curious_Cat]

Full changelog:

Spoiler (click to show/hide)

DFHack 0.47.05-r7
=================

New Plugins
-----------
- `autobutcher`: split off from `zone` into its own plugin. Note that to enable, the command has changed from ``autobutcher start`` to ``enable autobutcher``.
- `autonestbox`: split off from `zone` into its own plugin. Note that to enable, the command has changed from ``autonestbox start`` to ``enable autonestbox``.
- `overlay`: display a "DFHack" button in the lower left corner that you can click to start the new GUI command launcher. The `dwarfmonitor` weather display had to be moved to make room for the button. If you are seeing the weather indicator rendered over the overlay button, please remove the ``dfhack-config/dwarfmonitor.json`` file to fix the weather indicator display offset.

New Scripts
-----------
- `gui/kitchen-info`: adds more info to the Kitchen screen
- `gui/launcher`: in-game command launcher with autocomplete, history, and context-sensitive help
- `gui/workorder-details`: adjusts work orders' input item, material, traits
- `max-wave`: dynamically limit the next immigration wave, can be set to repeat
- `pop-control`: persistent per fortress population cap, `hermit`, and `max-wave` management
- `warn-stealers`: warn when creatures that may steal your food, drinks, or items become visible

New Internal Commands
---------------------
- `tags`: new built-in command to list the tool category tags and their definitions. tags associated with each tool are visible in the tool help and in the output of `ls`.

Fixes
-----
- `autochop`: designate largest trees for chopping first, instead of the smallest
- `devel/query`: fixed error when --tile is specified
- `dig-now`: Fix direction of smoothed walls when adjacent to a door or floodgate
- `dwarf-op`: fixed error when applying the Miner job to dwarves
- `emigration`: fix emigrant logic so unhappy dwarves leave as designed
- `gui/gm-unit`: allow ``+`` and ``-`` to adjust skill values as intended instead of letting the filter intercept the characters
- `gui/unit-info-viewer`: fix logic for displaying undead creature names
- `gui/workflow`: restore functionality to the add/remove/order hotkeys on the workflow status screen
- `quickfort`: `Dreamfort <quickfort-blueprint-guide>` blueprint set: declare the hospital zone before building the coffer; otherwise DF fails to stock the hospital with materials
- `view-item-info`: fixed a couple errors when viewing items without materials
- ``dfhack.buildings.findCivzonesAt``: no longer return duplicate civzones after loading a save with existing civzones
- ``dfhack.run_script``: ensure the arguments passed to scripts are always strings. This allows other scripts to call ``run_script`` with numeric args and it won't break parameter parsing.
- ``job.removeJob()``: ensure jobs are removed from the world list when they are canceled

Misc Improvements
-----------------
- History files: ``dfhack.history``, ``tiletypes.history``, ``lua.history``, and ``liquids.history`` have moved to the ``dfhack-config`` directory. If you'd like to keep the contents of your current history files, please move them to ``dfhack-config``.
- Init scripts: ``dfhack.init`` and other init scripts have moved to ``dfhack-config/init/``. If you have customized your ``dfhack.init`` file and want to keep your changes, please move the part that you have customized to the new location at ``dfhack-config/init/dfhack.init``. If you do not have changes that you want to keep, do not copy anything, and the new defaults will be used automatically.
- UX:
    - You can now move the cursor around in DFHack text fields in ``gui/`` scripts (e.g. `gui/blueprint`, `gui/quickfort`, or `gui/gm-editor`). You can move the cursor by clicking where you want it to go with the mouse or using the Left/Right arrow keys.  Ctrl+Left/Right will move one word at a time, and Alt+Left/Right will move to the beginning/end of the text.
    - You can now click on the hotkey hint text in many ``gui/`` script windows to activate the hotkey, like a button. Not all scripts have been updated to use the clickable widget yet, but you can try it in `gui/blueprint` or `gui/quickfort`.
    - Label widget scroll icons are replaced with scrollbars that represent the percentage of text on the screen and move with the position of the visible text, just like web browser scrollbars.
- `devel/query`:
    - inform the user when a query has been truncated due to ``--maxlength`` being hit.
    - increased default maxlength value from 257 to 2048
- `do-job-now`: new global keybinding for boosting the priority of the jobs associated with the selected building/work order/unit/item etc.: Alt-N
- `dwarf-op`: replaces [ a b c ] option lists with a,b,c option lists
- `gui/gm-unit`: don't clear the list filter when you adjust a skill value
- `gui/quickfort`:
    - better formatting for the generated manager orders report
    - you can now click on the map to move the blueprint anchor point to that tile instead of having to use the cursor movement keys
    - display an error message when the blueprints directory cannot be found
- `gui/workorder-details`: new keybinding on the workorder details screen: ``D``
- `keybinding`: support backquote (\`) as a hotkey (and assign the hotkey to the new `gui/launcher` interface)
- `ls`: can now filter tools by substring or tag. note that dev scripts are hidden by default. pass the ``--dev`` option to show them.
- `manipulator`:
    - add a library of useful default professions
    - move professions configuration from ``professions/`` to ``dfhack-config/professions/`` to keep it together with other dfhack configuration. If you have saved professions that you would like to keep, please manually move them to the new folder.
- `orders`: added useful library of manager orders. see them with ``orders list`` and import them with, for example, ``orders import library/basic``
- `prioritize`: new ``defaults`` keyword to prioritize the list of jobs that the community agrees should generally be prioritized. Run ``prioritize -a defaults`` to try it out in your fort!
- `prospect`: add new ``--show`` option to give the player control over which report sections are shown. e.g. ``prospect all --show ores`` will just show information on ores.
- `quickfort`:
    - `Dreamfort <quickfort-blueprint-guide>` blueprint set improvements: set traffic designations to encourage dwarves to eat cooked food instead of raw ingredients
    - library blueprints are now included by default in ``quickfort list`` output. Use the new ``--useronly`` (or just ``-u``) option to filter out library bluerpints.
    - better error message when the blueprints directory cannot be found
- `seedwatch`: ``seedwatch all`` now adds all plants with seeds to the watchlist, not just the "basic" crops.
- ``materials.ItemTraitsDialog``: added a default ``on_select``-handler which toggles the traits.

Removed
-------
- `fix/build-location`: The corresponding DF bug (5991) was fixed in DF 0.40.05
- `fix/diplomats`: DF bug 3295 fixed in 0.40.05
- `fix/fat-dwarves`: DF bug 5971 fixed in 0.40.05
- `fix/feeding-timers`: DF bug 2606 is fixed in 0.40.12
- `fix/merchants`: DF bug that prevents humans from making trade agreements has been fixed
- `gui/assign-rack`: No longer useful in current DF versions
- `gui/hack-wish`: Replaced by `gui/create-item`
- `gui/no-dfhack-init`: No longer useful since players don't have to create their own ``dfhack.init`` files anymore

API
---
- Removed "egg" ("eggy") hook support (Linux only). The only remaining method of hooking into DF is by interposing SDL calls, which has been the method used by all binary releases of DFHack.
- Removed ``Engravings`` module (C++-only). Access ``world.engravings`` directly instead.
- Removed ``Notes`` module (C++-only). Access ``ui.waypoints.points`` directly instead.
- Removed ``Windows`` module (C++-only) - unused.
- ``Constructions`` module (C++-only): removed ``t_construction``, ``isValid()``, ``getCount()``, ``getConstruction()``, and ``copyConstruction()``. Access ``world.constructions`` directly instead.
- ``Gui::getSelectedItem()``, ``Gui::getAnyItem()``: added support for the artifacts screen
- ``Units::teleport()``: now sets ``unit.idle_area`` to discourage units from walking back to their original location (or teleporting back, if using `fastdwarf`)

Lua
---
- Added ``dfhack.screen.hideGuard()``: exposes the C++ ``Screen::Hide`` to Lua
- History: added ``dfhack.getCommandHistory(history_id, history_filename)`` and ``dfhack.addCommandToHistory(history_id, history_filename, command)`` so gui scripts can access a commandline history without requiring a terminal.
- ``helpdb``: database and query interface for DFHack tool help text
- ``tile-material``: fix the order of declarations. The ``GetTileMat`` function now returns the material as intended (always returned nil before). Also changed the license info, with permission of the original author.
- ``utils.df_expr_to_ref()``: fixed some errors that could occur when navigating tables
- ``widgets.CycleHotkeyLabel``: clicking on the widget will now cycle the options and trigger ``on_change()``. This also applies to the ``ToggleHotkeyLabel`` subclass.
- ``widgets.EditField``:
    - new ``onsubmit2`` callback attribute is called when the user hits Shift-Enter.
    - new function: ``setCursor(position)`` sets the input cursor.
    - new attribute: ``ignore_keys`` lets you ignore specified characters if you want to use them as hotkeys
- ``widgets.FilteredList``: new attribute: ``edit_ignore_keys`` gets passed to the filter EditField as ``ignore_keys``
- ``widgets.HotkeyLabel``: clicking on the widget will now call ``on_activate()``.
- ``widgets.Label``: ``scroll`` function now interprets the keywords ``+page``, ``-page``, ``+halfpage``, and ``-halfpage`` in addition to simple positive and negative numbers.

Structures
----------
- Eliminate all "anon_X" names from structure fields
- ``army``: change ``squads`` vector type to ``world_site_inhabitant``, identify ``min_smell_trigger``+``max_odor_level``+``max_low_light_vision``+``sense_creature_classes``
- ``cave_column_rectangle``: identify coordinates
- ``cave_column``: identify Z coordinates
- ``embark_profile``: identify reclaim fields, add missing pet_count vector
- ``entity_population``: identify ``layer_id``
- ``feature``: identify "shiftCoords" vmethod, ``irritation_level`` and ``irritation_attacks`` fields
- ``flow_guide``: identify "shiftCoords" vmethod
- ``general_refst``: name parameters on ``getLocation`` and ``setLocation`` vmethods
- ``general_ref_locationst``: name member fields
- ``historical_entity``: confirm ``hostility_level`` and ``siege_tier``
- ``item``: identify method ``notifyCreatedMasterwork`` that is called when a masterwork is created.
- ``language_name_type``: identify ``ElfTree`` and ``SymbolArtifice`` thru ``SymbolFood``
- ``timed_event``: identify ``layer_id``
- ``ui_advmode``: identify several fields as containing coordinates
- ``ui``: identify actual contents of ``unk5b88`` field
- ``unitst``: identify ``histeventcol_id`` field inside status2
- ``viewscreen_barterst``: name member fields
- ``viewscreen_tradegoodsst``: rename trade_reply ``OffendedAnimal``+``OffendedAnimalAlt`` to ``OffendedBoth``+``OffendedAnimal``
- ``world_site_inhabitant``: rename ``outcast_id`` and ``founder_outcast_entity_id``, identify ``interaction_id`` and ``interaction_effect_idx``

Documentation
-------------
- Added `modding-guide`
- Group DFHack tools by `tag <tools>` so similar tools are grouped and easy to find
- Update all DFHack tool documentation (300+ pages) with standard syntax formatting, usage examples, and overall clarified text.

Looks amazing!  Why did this have to come out when I’m really invested in my current fort?… 

[myk]

You can absolutely upgrade in the middle of a fort! You can just upgrade DFHack without touching anything else.

[A_Curious_Cat]

You can absolutely upgrade in the middle of a fort! You can just upgrade DFHack without touching anything else.

Yeah, but this particular update sounds like it’d be best to do a clean install.  I’m particularly concerned about the init files and history files…



I wonder if I can do a clean install and copy my save over…

[lethosor]

I wonder if I can do a clean install and copy my save over…

As long as you're already using 0.47.05, then this should absolutely work. DFHack itself doesn't break save compatibility. You could always make a backup copy of your save folder first to be safe, though.

[JPapas]

Sad to report that in the latest version, the behaviour of gui/gm-unit skill editor is still bugged, with + and - being picked up by the search filter instead of modifying values. Behaviour is happening in Adventurer mode, have not tested in Fortress mode.

[myk]

Just to be sure, you're using DFHack 0.47.05-r7, the version just released two days ago, correct? This issue was marked as fixed in -r7.

[JPapas]

Just to be sure, you're using DFHack 0.47.05-r7, the version just released two days ago, correct? This issue was marked as fixed in -r7.

Yes, I made a fresh install just today for the sole purpose of trying this out.

[A_Curious_Cat]

Alright, I’m doing a fresh install (I was told this embark had iron.  There’s no iron…) and I’ve got a question.  Where should I put .dfhackrc?  Does it still go in the main DF directory, or has it moved somewhere else?

Edit:

Never mind, I just looked in dfhack.  It looks like it first looks for $HOME/.dfhackrc and sources that, then looks for ./dfhackrc and sources that too.

Anyways, it’s working and I’m now generating a world!