Editing v0.31:Military interface

{{av}}
This is a hands-on walkthrough of the '''[[military]]''' screens.


=Walkthrough=

So, you've just [[embark]]ed to a dangerous region and need to set up your military while you set up camp. You press {{k|m}} to open the military screen so you can recruit some dwarves and... whoa! ''What kind of menu '''is''' this?!''

This is a typical reaction to the military interface in DF v0.31. This guide will take you through a step-by-step process of each and every screen in the military and squad menus and get your military on its feet.

The military screen and all its tabs are mouse-compatible, and can be navigated through mouse clicks rather than strictly keys (when in windowed mode).

==Squad Positions==

Our brand new fortress at Shotweakens needs a military. Let's open up the '''military screen''' with {{k|m}}.



[[File:Military positions 1.png]]

This is the '''positions tab'''. It opens with the military menu by default; if you're looking at another tab you can press {{k|p}} to return here. At the bottom of the screen you can see the keys to open the different tabs in the menu. Each tab has three '''panes''' - a left, center, and right. These may also be referred to as the first, second and third panes. The left/right keys will take you between panes; keep in mind which one your selector is in, as the same key will often do something different depending on what pane you're in.

All screens will list what keypresses are needed to do what task, but as the menus are confusing to read, I'll list many of them as well. If you're ever stuck, take the time to really read through the options presented - often the answer is before you and it's simply too difficult to immediately see.

The positions tab lists squads and dwarves assigned to squads. You'll notice that presently there are no squads listed - you have yet to create one using {{k|c}}. Before we do that, we'll close the military screen ({{k|esc}}) and open the '''nobles screen''' ({{k|n}}).



[[File:Military nobles 1.png]]

See the slot for '''[[militia commander]]'''? That's the head of our military. We'll put Wrestler 1 into this slot (with {{k|enter}}). Keep in mind you cannot assign your expedition leader as the militia leader. Now we'll go back to the positions screen.



[[File:Military positions 2.png]]

We press {{k|c}} to create a new squad. The default '''uniform templates''' are listed for us to choose from - for now, we'll just select 'leather armor'; we can change this later.



[[File:Military positions 3.png]]

Now we have a squad! Wrestler 1 has decided to call it Barricaded Morals, as the squad leader chooses the squad name. Go back to the nobles screen for a moment.



[[File:Military nobles 2.png]]

See where it says '''militia captain'''? This is any squad leader with a position under your militia commander. There can be any amount of these. Squad leaders will be listed here automatically. You can also create a squad ''before'' assigning a militia commander; your first squad's leader will automatically assume the role. We're done with the nobles screen; let's return to the military screen and finish up with the positions tab.



[[File:Military positions 4.png]]

I've put Wrestlers 1-3, Hammerdwarf 1 and Shieldsdwarf 1 into Barricaded Morals as our melee squad (by selecting them from the right pane while highlighting the correct squad in the left pane) and created a second squad (with {{k|l}}) for our ranged forces, Marksdwarves 1 and 2. Marksdwarf 1 calls this the Granite Parity. I've given them the generic 'leather armor' uniform as well.

We're done with the positions tab. Press {{k|a}} to bring up the '''alert tab''', our next destination.

==Alerts==

The '''alerts tab''' is where you can create [[alerts]] for your squads. Alerts function as your effective schedules - you can toggle individual squads between alerts easily - while the '''schedules''' tab allows you to edit the content of each alert (confusing, I know). Pretend that alerts ''are'' the schedules and the scheduling itself is simply how you edit them.

The alert system is primarily for the military; however, a generic '''civilian alert level''' is used to restrict civilians via alert. You can tell them what alert to follow by pressing {{k|enter}} while highlighting one in the left pane, or (once we have burrows) you can restrict them to a burrow (or multiple burrows) by pressing {{k|enter}} while highlighting one in the right pane.



[[File:Military alerts 1.png]]

By default there are two alerts - Inactive and Active/Training. Inactive is a full schedule of empty orders, causing your dwarves to do nothing but sit around and individually train if they are a certain military skill level (otherwise they'll retain their civilian jobs). Active/Training is a full schedule of Train orders, which will keep them in your Barracks doing demonstrations and sparring. Both of these alerts are entirely editable in name and scheduling (though we'll get to the latter later). I'm going to rename these two alerts as well as add a third, using {{k|c}} to add one, and {{k|N}} to name them.



[[File:Military alerts 2.png]]

We now have Off-Duty (formerly Inactive), Training (formerly Active/Training because that name is far too misleading) and Patrolling, which currently has no orders, but we can add some later. Patrolling is going to be our 'patrolling around camp / dangerous areas' alert. None of this is strictly necessary to do, I'm simply demonstrating the capability.

We're done with alerts for now. Press {{k|e}} to bring up the '''equipment tab'''.

==Equipment==

The '''equipment tab''' is where you suit up your dwarves with armor and a weapon. There are three windows within this tab:



===View/Customize===

[[File:Military equipment 1.png]]

The '''view/customize''' window, opened by default in the equipment tab, is where you can select individual pieces of equipment for individual dwarves. When in another equipment window it is accessible through {{k|V}}. You can add equipment by pressing the corresponding capital letter displayed at the top of the screen and then selecting from the options in the right pane, and edit an item's material or color by highlighting said item in the right pane and then pressing {{k|M}} or {{k|C}}. Be careful while doing this - if you accidentally press {{k|enter}} while ''not'' selecting new equipment, material, or colors, you'll delete that item. You can also toggle between your dwarves wearing only their armor or wearing it over their civilian clothes with {{k|r}}. Pressing {{k|m}} to toggle between partial match and exact match seems to give or restrict your dwarves' equipment-selecting privileges {{verify}}.



[[File:Military equipment 5.png]]

I've edited the equipment of each dwarf in the squad so that the wrestlers have no weapon or shield, the shieldsdwarf has a shield but no weapon, and the hammerdwarf has a hammer but no shield. Keep in mind I'm just demonstrating; should my dwarves actually go into combat so poorly equipped they'd get torn apart.

===Assign Uniforms===

[[File:Military equipment 2.png]]

The '''assign uniforms''' window (opened with {{k|U}}) allows to you apply '''uniform templates''' to a single dwarf or an entire squad at once. It is important to remember that the equipment/assign uniforms window is '''not''' the same as the uniforms ''tab'', which is directly accessed in the military screen. Right now our options are the default templates of 'leather armor', 'metal armor', and 'archer'. We'll make our own shortly.



===Priority/Assignments===

[[File:Military equipment 3.png]]

The '''pri/assignments''' window (opened with {{k|P}}) allows you to rearrange your squads. The right pane lists assigned equipment on each dwarf. This does not necessarily mean that the dwarf is carrying it, merely that it's been assigned and should, theoretically, pick it up. If there are more requests for a given type of equipment than there are items, the squad at the top of the list will have first pick out of the available gear, and the next squad the second, and so on. Moving on to the '''uniforms tab''' ({{k|n}})

==Uniforms==

The '''uniforms tab''' is where you create '''uniform templates''' that can be applied to your dwarves in the equipment tab's assign uniforms window (which we were at moments ago). Again, it is important to remember that the uniforms tab is '''not''' the same as the equipment/assign uniforms ''window''.



[[File:Military uniforms 1.png]]

The leather armor, metal armor, and archer templates are listed by default. Leather is fine for a beginning military, especially as we don't yet have any metal, but for demonstrative purposes let's make a new template.



[[File:Military uniforms 2.png]]

Now we have 'Naked Time,' a template that will cause dwarves to pick up leather high boots and gloves, as well as a pink silk thong if available. Thankfully we only have basic leather clothing with us, so they won't (though they'll grab one if one becomes available). To truly be a 'naked' uniform we need to press {{k|r}} to replace regular civilian clothing with this uniform (rather than wearing it overtop like some kind of weird superhero costume). Now we need to apply this template in the equipment/assign uniforms window.



[[File:Military equipment 4.png]]

The Granite Parity has now been assigned the Naked Time uniform. We're done with our uniform work; let's move on to the '''supplies''' tab.

==Supplies==

[[File:Military supplies.png]]

The '''supplies tab''' is where you can decide which squad carries what using the secondary up/down keys. Note that this has bugs as of 31.25 ({{bug|2008}}). The default settings should be fine for now; let's continue on.

Should you want to change any (or see what you can do), you can toggle through the drink orders by pressing {{k|-}} and  {{k|+}}, and through the food amount by pressing {{k|/}} and {{k|*}}.

==Ammunition==

[[File:Military ammunition 1.png]]

The '''ammunition tab''' is where you can select what squad uses what types of bolts for what. 'Hunters' are also listed for civilian dwarves tracking wild animals.



[[File:Military ammunition 2.png]]

We'll give The Granite Parity our supply of copper bolts to train and combat with, since we don't have anything else. However, when you start carving bone or wooden bolts, you can assign those to be training bolts instead of metal ones. We'll need to return to the equipment tab one last time.



[[File:Military equipment 6.png]]

In the '''view/customize''' window we've given our marksdwarves crossbows. This should cause them to pick up a quiver and then begin stocking bolts. Finally, it's time for the '''schedules''' tab.



==Schedules==

[[File:Military schedule 1.png]]

The '''schedules tab''' is where you can assign scheduling items for each month by squad and alert. This is where your military gets all its passive orders that tells it what to do on a yearly basis. Unlike the other military tabs, you will need to press {{k|esc}} to exit the scheduling tab. Note that by using the secondary page up/down keys you can swap alert schedules to edit. As you can see, the Training alert consists of nothing but Train orders.



[[File:Military schedule 2.png]]

By pressing {{k|shift}}+{{k|tab}} you can flip the screen so that rather than looking at all the months and two squads, you can see all the squads and the next three months. This is more effective if you have many squads, and as we don't we'll just put it back. The next step to do is to create scheduling for our new Patrolling alert, but to do so we'll have to create stations, routes, and burrows. Without them there is nothing to assign our orders to.



===Burrows, stations, and routes===

Exit the military menu and press {{k|w}} to bring up the '''burrows menu'''. We're going to designate two new burrows for our military to play with.



[[File:Military burrows 1.png]]

I've selected an area away from the river and called it ''Home''. I've left it with the default shape/color, a blue plus sign. You can use the secondary up/down keys to pick a different shape and {{k|c}} to switch colours.



[[File:Military burrows 2.png]]

For the second burrow I've selected the river and called it ''ohgodcarp'', using a red fish selector. Exit this menu and bring up the '''alerts tab''' again to see something.



[[File:Military alerts 3.png]]

Now that we have burrows, we can select the option in the right pane to restrict civilians to certain burrows. Don't forget that civilians can not be broken up by group; either all civilians are restricted or none are. Exit this menu and press {{k|N}} to bring up the '''points/routes/notes menu'''.



[[File:Military stations.png]]

Using {{k|p}} I've placed a number of points around our future campsite (where ''Home'' is). Some of them are on the next z-level up. I've named them 'perimeter#' as I intend to use them as station points to watch our perimeter. Once you have placed some station points, let's press {{k|r}} to open the '''routes window'''.



[[File:Military routes 1.png]]

Here you can press {{k|a}} to add a route (or multiple). To edit waypoints, or the stations that the route passes through, press {{k|e}}. When you want to return to the route editing screen, just press {{k|e}} again.



[[File:Military routes 2.png]]

By selecting all five of our perimeter# stations, I've created a new route called Perimeter. Similar to points, you can rename routes by pressing {{k|n}}. Dwarves assigned to this route will go through stations 1-5 and then return to station 1, creating a loop. Let's return to the scheduling tab. (In case you've forgotten, {{k|m}} then {{k|s}}!)

===Give orders===

[[File:Military giveorders 1.png]]

The '''give orders window''' is accessed through the scheduling tab. When selecting a scheduling item, press {{k|o}} to create a new order. We can choose between 'Train,' 'Defend burrows,' 'Patrol route,' and 'Station.' If you don't want a scheduling item to have any orders, delete them in the main scheduling menu. An important note: You must press {{k|shift}}+{{k|enter}} to save an order - pressing {{k|esc}} will only return to the scheduling tab without saving your progress.



[[File:Military giveorders 2.png]]

We'll give Barricaded Morals a defend burrows order in the Patrolling alert, to defend the ''ohgodcarp'' burrow. They'll watch for enemies in that area, and likely end up engage the foul water beasties. I've also selected Wrester 1, our militia commander, and set the required dwarf number to 3. Now the order will keep three of the five dwarves in the squad busy defending the burrows, and try to switch out soldiers in favour of Wrestler 1 when possible.



[[File:Military schedule 3.png]]

Saving our order, we'll return to the scheduling tab. Barricaded Morals now has a single Defend burrows order. Let's make it a little more creative, and use the copy/paste function to copy the schedule for the entire year.

For reference, the give orders window is not used to ''edit'' orders - that is done by pressing {{k|tab}} when looking at scheduling items and then using {{k|e}} to edit an order. Keep in mind scheduling items listed can have multiple orders, selected using the secondary selectors - if you haven't named a scheduling item it'll change the item's name to either whatever the order is or 'Mixed,' but if you've named it, even if there's no orders for it, it'll retain the name; don't get mistaken and think that an empty named scheduling item still has your deleted orders and copy it around.



[[File:Military schedule 4.png]]

There! Now Barricaded Morals will partake in the War on Fish all year so long as they are set to the Patrolling alert. Let's select The Granite Parity and give them different orders.



[[File:Military giveorders 3.png]]

The Granite Parity has been ordered to patrol the Perimeter route we created - only one dwarf of the two is needed, and the order will prefer to use Marksdwarf 1 if it can.



[[File:Military schedule 5.png]]

Saving the order and returning to the scheduling tab one last time, we edit The Granite Parity's schedule so that they patrol the perimeter for a month, hang out and casually train for another month, and then defend the ''Home'' burrow for a month - and repeat this every season. I'll set both squads to the Patrolling alert to make sure they follow out these orders.

We are now done with the '''military menu'''. Exit all windows and we'll get started with the '''squads menu'''.

=Squads=

:''This section of the walkthrough is still in progress. For now, relevant information is located on the [[Squads]] page.''

==Move order==

==Attack order==

=Military=

The '''military screen''' is brought up by using {{k|m}} in the main menu.

==Positions==

The '''positions tab''' is opened with the {{k|p}} key, though when opening the military screen it is the initially displayed tab.

==Alerts==

The '''alerts''' tab is opened with the {{k|a}} key.

==Equipment==

The '''equipment''' tab is opened with the {{k|e}} key

===View/Customize===

The '''view/customize''' window is opened with the {{k|V}} key, though when opening the equipment tab it is the initially displayed window.

===Uniforms===

The '''uniforms''' windows is opened with the {{k|U}} key.

:'''''Note:''' The uniforms window within the equipment tab is not the same as the uniform tab within the main military menu.''

===Priority/Assignments===

The '''pri/assignments''' window is opened with the {{k|P}} key.

==Uniforms==

The '''uniforms''' tab is opened with the {{k|n}} key.

:'''''Note:''' The uniforms tab within the main military menu is not the same as the uniform window within the equipment tab.''

==Supplies==

The '''supplies'' tab is opened with the {{k|u}} key.

==Ammunition==

The '''ammunition''' tab is opened with the {{k|f}} key.

==Schedules==

The '''schedules''' menu is opened with the {{k|s}} key. To return to the main menu you must press {{k|esc}}.

===Give Orders===

The '''give orders''' screen is opened with the {{k|o}} screen when highlighting the correct squad/month scheduling slot.

=Squads=

The '''squads''' menu is opened by using {{k|s}} in the main menu. Squads are selected using {{k|a}}, {{k|b}}, {{k|c}}, etc; {{k|shift}} can be held to select multiple squads at once. {{k|p}} can be pressed to toggle between selecting individual dwarves and entire squads.

===Move Order===

'''Move orders''' can be given with {{k|m}} once dwarves are selected.

===Attack Order===

'''Attack orders''' can be given with {{k|k}} once dwarves are selected.

{{Military}}

{{Category|Interface}}