Guide for Getting Started with AdvFort:
1) Option A: Install
DFHack using
these install instructions.
Option B: Download and use the
starter pack if you have Windows. There are others for Mac and Linux
here but I can't guarantee they'll work with this and anyways this entire guide is Windows-specific, sorry.
2) Save
this into hack/scripts/gui/advfort.lua (right click, save link as), overwriting any existing advfort.lua
3) Save
this into hack/scripts/gui/advfort_items.lua (right click, save link as), overwriting any existing advfort_items.lua
4) In the main DF folder, find dfhack.init and add the following near the top (for convenience's sake) like above Lethosor's scripts:
# keybinding for AdvFort
keybinding add Ctrl-T "gui/advfort"
5) Create file called init.lua (e.g. create empty text file and rename to init.lua) in df/raw/ folder if it does not already exist (it probably won't). There's usually not many other files in this folder, just folders like the objects folder. Don't put it in the objects folder.
6) Follow
these instructions. This can't be much simpler, because if you were given raw files to download they could overwrite other existing mods and you would be sad.
7) Create a new world. These things didn't apply to my current worlds, only new worlds, but then maybe I messed something up. To be safe, just do it.
<-- (#@*%ing emoticons) If you want immediate dig ability without having to luck into finding some guy's pick: When in game, go to DFHack and type createitem WEAPON:ITEM_WEAPON_PICK INORGANIC:IRON 1 All capital letters is important! It will appear in same space as you.
9) If you did not start as axeman and you want immediate wood cutting ability and don't want to wander around for 10 minutes to find an axe: When in game, go to DFHack and type createitem WEAPON:ITEM_WEAPON_AXE_BATTLE INORGANIC:IRON 1 All capital letters is important! It will appear in same space as you.
10) When in game, press Ctrl-T to open the menu. To get out just hit esc. If you see all black you are probably using TWBT, either you installed it yourself or you're using the starter pack. TWBT makes other levels visible, it's totally worth it when you're not using AdvFort. Anyway, you need to go to the graphics tab in the Lazy Newb Pack window and choose print mode: 2D before starting the game.
11) The very first thing you should do is press ? while in ctrl-T menu - this will explain how to do stuff in up or down directions. Don't go pressing alt-5 on numpad and thinking you'll carve a ramp down - alt 8 or 2 will careful move and do jobs in that direction, but ctrl-5 is down and ctrl-e is up. If you alt-5 it'll be all like "you need a wall!" which does not mean something to either side, it means wall/floor/ceiling. Also, if you have another item equipped as a weapon even with a pick out it won't work. You gotta have only the pick. And for a down staircase you create a down staircase where you are (just hit 5) then an updown staircase below it (ctrl-5), etc.
12) To change jobs you do not hit R or T, you hit shift-R or shift-T. These are the defaults. You'll need the correct tools for the jobs. See ITEM_WEAPON_PICK up there in that thing I said to do? If you want the tools without mining/creating in workshop, go to the page for said tool on DF wiki, scroll down to raws, and find the correct raw.
13) Warmist has a good rundown on how to do a buncha stuff. First go to DFHack and type createitem FIGURINE INORGANIC:IRON 1 (caps are important), then grab the figurine (make sure it isn't in your backpack) hit x and claim a proper site, then do that stuff. Oh wait, having trouble with, say, workshop? You gotta have the mats (and you'll need the anvil reaction for a smithy), then you gotta make the workshop, that only makes plans so you gotta careful move into it again to actually build it, then press . (period) once to go through the x amount of moves to do the job. Then you gotta press tab to use the workshop to build stuffs.