Editing v0.31:Military interface

{{elven}}
<!--
NOTE TO EDITORS: I'm still working on this page, incomplete as it may look at any given point. Please do not edit this page until this note has been removed, no matter how minor - even a grammar fix will cause an editing conflict. --Retro
-->
This is a hands-on walkthrough of the new '''{{l|military}}''' and '''{{l|squads|squad}}''' screens.

::'''''Editor's note:''' This walkthrough is currently in the process of being created. For clarity purposes it is being put together by one person. Please wait until it is finished before you edit it --[[User:Retro|Retro]] 19:28, 12 April 2010 (UTC)''


=Walkthrough=

So, you've just {{l|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 new military setup. 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.

==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 up/down keys will take you between panes; keep in mind which one your selector is in, as the same key may do something different depending on what pane you're in.

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. 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 '''{{l|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 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. 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 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 {{l|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).



[[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 right now, are buggy (v0.31.02). 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.



[[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. You can use the various letter shown to choose what type of equipment you want to apply and then selecting it with {{k|enter}} in the right pane - be careful with this, as if you're not actively selecting armour, you'll delete whatever is selected with {{k|enter}} as well. 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}}.



[[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. Nobody is quite sure what the right pane's assignment listing does yet, but as we've yet to find a use for it, you don't need to worry about it. Moving on to the '''uniforms tab'''!



==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 doesn't work in 31.02 and 31.01. The default settings should be fine for now; let's continue on.

==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 by 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 two 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 {{|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. 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.



===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.



[[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 {{l|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 v0.31}}