				Sturmbot 1.5 Readme for dod 3.1 beta


Table of Contents

1. Introduction
  a. How Sturmbot Works

2. Installation
  a. Before You Start
  b. Sturmbot Loader
  c. Installing Sturmbots
    i.  Windows
    ii. Linux
  d. Listenservers
  e. Dedicated Servers
  f. Sturmbots and Adminmod
    i.  Windows
    ii. Linux

3. Controlling Sturmbots with Sturmbot Menus, Commands and Cvars
  a. Diving Right In
  b. Sturmbots on a Dedicated Server
  c. Sturmbot Menus
  d. Sturmbot Commands
  e. The "bot.cfg" File
  f. Sturmbots and Adminmod

4.  Installing New Maps and Waypoints
  a.  Installing Maps
  b.  Installing Waypoints
  c.  Mapcycle.txt file

5. Vocal Commands

6. FAQ

7. Useful URL's

8. Credits


1. Introduction

Sturmbot 1.5 is a "bot" plugin for the Half-Life mod, Day of Defeat version 2.0 or greater (called DOD from now on).  Sturmbot generates computer controlled players called "bots".  This allows a single player to play against the bots, or teams in multiplayer games to be "filled out" with bots, to even up sides, or to add more players.  It is also useful for "seeding" servers, the bots show up as players on the server list, which can help attract players to your server.  Nobody wants to be the only player on a server.  Sturmbot can be used on lan games, on "listenservers" (multiplayer games where the host is playing the game) or on dedicated DOD servers.  It can be used with Windows servers, or Linux servers.  This readme will tell you how to set up and use Sturmbots in various DOD server configurations but it is not intended to be an instruction manual on Half-Life and DOD servers in general.

a. How Sturmbot Works

Sturmbot adds bots to your map, then uses a file called a waypoint file to tell them where to go, and what to do.  It also uses the game console and a file called bot.cfg to add and delete bots and to control their behavior.  We will talk about the game console and the bot.cfg file more later on.  Sturmbots also respond to commands in the three DOD vocal commands menus.  We won't be going into a lot of detail on how the Sturmbots respond to the various vocal commands, we will leave that up to you to have fun experimenting with.  However, we will explain how the sturmbots respond to one or two of the less obvious commands and give you a general idea on what to expect from your friendly neighborhood Sturmbot squad.


2. Installation


a. Before You Start

This guide assumes that you already have installed the appropriate versions of Half-Life, or Counter-Strike, and DOD.  In order to use Sturmbot 1.5 you will have to have installed DOD version 3.0 or higher.  The most recent version of DOD can be found at the following url:

http://www.dayofdefeatmod.com/files/game/mirrors.html

Sturmbot is relatively simple to set up but you will find it easier if you already have some knowledge of how to set up a Half-Life server.  This readme has been written with intention of helping those who know very little about setting up a DOD server, however, we can't promise that we will cover every possible configuration or answer every question that you may have.  If you have further questions you may find additional help at the Sturmbot Forums.  The Sturmbot Forums can be found at the following url:http://www.wantahome.com/cgi-bin/ultimatebb.pl

While the developers of Sturmbot, and the authors of this readme, have gone to great deal of trouble to ensure that the program works as intended, and that the instructions are clear and accurate, none of us accept any responsibility for any damage it may do to your Half-Life installation, or, heaven forbid, to any part of your computer or its software.  This project was a labour of love, and it is free, you are getting a great deal more than you paid for, one way or the other.

At this time you may want to make a backup of the "liblist.gam" file located in the "dod" folder which you will find in your main Half-Life directory.  This is especially true if you have installed Adminmod.  The default path for your Half-Life directory is "C:\Sierra\Half-Life".  Depending on the version of the game you purchased or how you installed the game your Half-Life directory may be called "Counter-Strike".


b. Installing Sturmbot

Installing Sturmbot is very straight forward.  This section deals with installing Sturmbot without Adminmod.  See item 2.f. for information on using Sturmbot with AdminMod


i.  Windows Installation

To install Sturmbot simply double click on the sturmbot14.exe and enter the path for the "dod" directory located in your root "Half-Life" folder.  Your Half-Life directory may be named "Counter-Strike", depending on the version of the game you own.  The default directory is already entered for your convenience.



ii.  Linux Installation.

Copy the Sturmbot Linux file (be sure it end with .tar.gz) to the directory where you installed DoD.  Next, unzip the file by typing:

tar -vxzf  <filename>

For example, if the file name is sturmbot-1.5.tar.gz, then type:

tar -vxzf  sturmbot-1.5.tar.gz

then press enter. 
You have now completed installing Stumbot on your Linux PC.

c. Sturmbot Loader

Sturmbot Loader is an application that provides a user friendly interface for setting up Sturmbots.  If you are going to use it, it should be installed after you have installed Sturmbot.  It is designed specifically with LAN games in mind, however a new version is in the works, which may well be out by the time you read this, that will be adding dedicated server support.  We will not be going into any detail on Sturmbot Loader and how it is used but you may want to check it out.  It can be found at the following url:

http://www.wantahome.com/sturmbot/files.html


d.  Listenservers

A "Listenserver" is a multiplayer Half-Life game that can be played over the internet where the person hosting the game plays the game on the same computer.  It is the simplest kind of game to set up Sturmbots for.  If you are running a listenserver and you have already installed Sturmbots you should be able to proceed directly to section 3. of this readme.


e.  Dedicated Servers

A dedicated server runs the multiplayer Half-Life game and allows other players to play the game over the internet on the host machine in the same way that a listenserver does.  However, the host cannot play the game from the same program in the same way that the host can with a listenserver.  Dedicated servers tend to be more reliable and require fewer resources than listenservers.  A dedicated server also provides more flexibility for the host in that there are more plugins and other applications designed specifically for use on dedicated servers than there are for listenservers.  While a listenserver uses the same executable as you play the game with (hl.exe or cstrike.exe, depending on the version of the game you are using), a dedicated server uses a stripped down version of the game program (hlds.exe) designed specifically to run as a server.

This section assumes you already have a server with an IP address accessable via the internet to use.  It does not deal with setting up IP addresses, installing operating systems, etc.  While we will explain some of the basics involved in setting up a dedicated server this is not meant to be a guide for setting up and maintaining dedicated servers specifically.  We will only go into the specifics of dedicated servers as they relate to setting up and controlling Sturmbots.

There are two versions of hlds.exe, one is designed to be used with Windows, the other with Linux.  If you already own and have installed Half-Life or Counterstrike then you already have installed the hlds program that you need to operate a dedicated server.  If you are looking for a standalone version of hlds for Windows, or the Linux version of hlds, you can find it at the following url:

http://www.unitedadmins.com/HLDS_x110_DL.aspx

This readme also assumes that you have downloaded and installed DOD version 3.0 or greater and is not intended to be a guide for DOD.  Once again, we will only deal with the DOD specifically as it relates to setting up and controlling Sturmbots.  There are two versions of DOD and you will have to installed the appropriate one for your operating system.  If you are looking for the latest version of DOD for Windows or Linux, you can find it at the following url:

http://www.dayofdefeatmod.com/files/game/mirrors.html

If you have not installed Adminmod and you have installed Sturmbots you may proceed to section 3.


f. Sturmbots and Adminmod

Remember that backup copy you made of your "liblist.gam" file?  What you need to do is take that copy and replace the current one which was created when you installed Sturmbots with the old "liblist.gam" file that you backed up.  If you did not make a backup copy of your old "liblist.gam" file you will need to edit it manually.

To edit it manually open it up with Notepad and replace the lines that read

gamedll "sturmbot\dlls\STURM_bot.dll"
gamedll_linux "sturmbot/dlls/sturmbot-i486.so"

with these lines,

gamedll "dlls\metamod.dll"
gamedll_linux "dlls/dod_i386.so"
 
If you are running your dedicated server with Adminmod you will need to use a shortcut to start up your server with Sturmbots.  Either create or copy a DOD shortcut then proceed to section i. if your server runs Windows, and proceed to section ii. if your server is a Linux server.


i.  Windows

Now, you need to right click on the new icon you just made.  Select the Properties menu item.  Click on the tab that says shortcut.  Look for the line that says "Target". Click on that line and make sure that the line reads as follows:

C:\Sierra\Half-Life\hlds.exe -game dod -port 27016 +maxplayers 10 +map dod_caen2 +localinfo mm_gamedll sturmbot/dlls/STURM_bot.dll

The portion of this line that is specific to Sturmbot is the following:
 +localinfo mm_gamedll sturmbot/dlls/STURM_bot.dll

If you already have a shortcut with which you start your dedicated server, all you will need to do is add this to the target line of that shortcut.

The portion that reads "C:\Sierra\Half-Life\" should point to your root Half-Life directory.  If the version of the game that you own is Counter-Strike the directory may be "C:\Sierra\Counter-Strike\".

The "-port 27016" portion is only necessary if you wish to designate which port your server runs on.  If you do not designate the port your server will use the default port which is port 27015.

The portion of the line that reads "+maxplayers 10" will be set to whatever the maximum number of players you wish your server to play host to, and the "+map dod_caen2" portion should point to whatever map you wish your server to start out with.

You should be all set at this point to start having some fun with your new Sturmbots.  You may now proceed to section 3.


ii. Linux

Note:  There is an error in the way that the localinfo command below interacts on Linux.  (Thanks to several people who posted their debug file results on the Sturmbot forums.  We could not have figured out a work around without that information.)  So, the first thing you need to do when using Adminmod and Sturmbot together with linux is to go to your sturmbot/dlls directory.  There, type in this line:

cp sturmbot-i486.so sturmbot

This makes a new file called sturmbot.  The localinfo command looks for a file called sturmbot when the game starts, even though you specify the other file name on the command line as outlined in the rest of this setup section.

It is easiest to start the DoD server in Linux using a file that you can remember the name of.  So, use a text editor such as vi to create a file called "withbots.sh" in your hlds_l directory, or to whatever you may have named the directory you installed your hlds to.  In this file, type the following command:

./hlds_run -game dod  -port 27016 +maxplayers 10 +map dod_caen2 +localinfo mm_gamedll sturmbot/dlls/sturmbot-i486.so

The portion of this line that is specific to Sturmbot is the following:

+localinfo mm_gamedll sturmbot/dlls/sturmbot-i486.so

The portion that reads "./hlds_run -game dod" tells your server to run the hlds file using the DoD modification.

The "-port 27016" portion is only necessary if you wish to designate which port your server runs on.  If you do not designate the port your server will use the default port which is port 27015.

The portion of the line that reads "+maxplayers 10" will be set to whatever the maximum number of players you wish your server to play host to, and the "+map dod_caen2" portion should point to whatever map you wish your server to start out with.

Next, if you are going to start the game while logged in as the user "root" then type in:
Chmod 500 withbots.sh

If you will be starting the game logged in as any other user than root, type in:

Chmod 755 withbots.sh

Now, whenever you want to start a game with the bots, go to the directory where you installed hlds and type:

./withbots.sh

and press enter.  


3. Controlling Sturmbots with Sturmbot Menus, Commands and Cvars


a. Diving Right In

You now have Stumbot installed, but you will not have any bots on your server until you add them.  There are a number of ways to do this but for now, so you can play around, you can use this next section as a quick start to add some bots to your server.

First, use Windows or NT explorer to go the the directory where Sturmbot is installed, for example c:\Sierra\Half-Life\dod\sturmbot.  Find the file called bot.cfg.  Open it with notepad.  Type in the following lines:

min_bots 0
max_bots 8
throw_grenade 9000

Now save the file.  

And that is it.  Now, when you start your DOD server it will load 4 bots on each side and you are ready to play.


b. Sturmbots on a Dedicated Server

If you are not running a dedicated server you can skip right to section b.  If you are running a dedicated server you will need to set up a password for your in-game Sturmbot menus and commands before you can use them.

You will need to find and edit your "bot.cfg" file in order to do this.  This file is located in the "sturmbot" folder which should have been installed into the "dod" directory located in your root "half-life" directory.

Open the "bot.cfg" file with Notepad and place the following line in it:

select_password yourpasshere

This is important - make sure that you don't use any quotes.

Once you have joined your game pull down the console and enter the following:

sturmbot_password yourpasshere

Again, no quotes.

You should now be able to access all of your sturmbot commands directly without prefixing them in any way in the console.  You can also assign your menus and commands to hot keys.  We will go into some detail on all of this in the following sections.




c. Sturmbot Menus

The most basic level of control for the bots can be accessed via the Sturmbot menu.  There are two ways to gain access to the Sturmbot menu.  One is through the console, the other is to create a shortcut key that will allow you to access the menu with a single key stroke.  We will not go into any detail on the sturmbot menu items themselves as they are fairly self explanatory.

You can gain access to your sturmbot menu through the console by entering the command "sturmbotmenu".

Creating a shortcut key to access the sturmbot menu can be done three ways.  One way is to start up DoD, then go to the "Configuration" menu, then to the "Controls" menu.  Scroll down until you see the entry for Sturmbot Menu.  Double click on it then press the key you want to use to bring up the sturmbot menu.  Now hit done and you can start playing and use the key you chose to bring up the menu.

You can also add this key or change it from the conslole.  To do this, pick a key that you are not using for the game.  For example, the "i" key.  Pull down the console, by default you can do this by pressing the "~" key.  Enter this line:

bind i sturmbotmenu

The third way to create a shortcut key to access your Sturmbot menu is to manually edit the "config.cfg" file.  You will find this file in the "dod" folder located in your root "Half-Life" directory.  Open the file with Notepad and enter the following line:

bind "i" "sturmbotmenu"

This will give you access to the in-game Sturmbot menu using the "i" key.

Note: You should not attempt to bind the F1 and F2 keys to any command, they are already, intentionally or unintentionally, hard-coded to other functions in Half-Life.


d. Sturmbot Commands

The following is a list of Sturmbot commands that can be entered through the Half-Life console, along with a brief explanation of what they do.  Any square brackets indicate a variable that can be added to the command.  Variables should be separated by a space.  Do not use the square brackets in your commands. Note that this list does not include the waypoint commands.  For more information on waypoints see the waypoint tutorial.

Command Usage/Effects

addbot [team] [class] [skill] [name]
This command will add a random bot to the team with the fewest players if used without any variables.  The team variable is 1 for Allies, 2 for Axis, classes range from 1 to 5, the skill level ranges from 1 to 8 with 8 being the most skilled.

addbotmenu
This command will bring up the addbot menu.

botchat [off/limited/full]
off: bots will not talk.
limited: bots will talk a little.
full: bots will talk to each other and humans a lot.

bloodmode [0-3]
This command controls the level of gore.
 Level 0 shows no blood at all when players are injured.
At level 1 blood will be left on walls and ground when players are injured
At level 2 Like level 1 but players also leave behind corpses when they die, which can be controlled by the "maxbodies" command. 
At level 3 players will explode when they die and blood and limbs will fly in every direction.   

botdontshoot [on/off]
Does exactly what it says.  Useful for testing purposes.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

cyclefreq [number in seconds]
This command controls the how much processing power the Sturmbots' AI will use by controlling how often the AI may query the processor to compute possible paths.  The default is "0.05".  If you find that the sturmbots are slowing your machine down setting the number to "0.1" may lessen the load on your processor.  Setting this number too high will cause the Sturmbots to stop.

dangerfactor [1-5]
This controls the chance that Sturmbots will avoid paths where they were killed.  All of the "learn" commands are best left alone unless you really know what you are doing and have some specific technical reason for using them.  Sturmbots manages all of the "learning" functions by default at the recommended settings.

fillserver [number] [team] [skill]
This command will add the number of bots indicated to your server, distributing them evenly to each side unless you direct them to a specific team.  See the "addbot" command for [team] and [skill] explanations.  Note that if you completely fill your server with bots no one else will be able to join your server.

formsquad [on/off]
This command causes the Sturmbots to work in squads rather than as individuals.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

friendlyfiremode [on/off]
The standarc server command "mp_friendlyfire [1/0]"  will make the bots able to be damaged by friendly fire.  Friendlyfiremode on means that bots will shoot ANYONE they see, even bots on their own team.  Basically, it makes the game a free for all for everyone.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

ghostmode [0-3]
This command makes everyone appear as "ghosts", the higher the number, the more translucent they will appear.

grenadeonly [on/off]
Will force your bots to use only their grenades.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

gunmode [on/off]
When you use this command your Sturmbots will leave behind weapons when they die which can be picked up and used by players.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

help
This command provides some information on various commands.

killall
This very useful command will kill all the bots on your server.  This command will not, however, kick them.  They will respawn as soon as you kill them.

knifeonly [on/off]
This command forces your Sturmbots to use melee weapons in combat, either knives or spades.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

learn init
This command resets the Sturmbot's learning.  All of the "learn" commands are best left alone unless you really know what you are doing and have some specific technical reason for using them.  Sturmbots manages all of the "learning" functions by default at the recommended settings.

learn load
learn save
These two commands load and save the Sturmbot's learning.  All of the "learn" commands are best left alone unless you really know what you are doing and have some specific technical reason for using them.  Sturmbots manages all of the "learning" functions by default at the recommended settings.

learnrate [1-5]
This command controls how quickly Sturmbots "learn" and how quickly they forget.  All of the "learn" commands are best left alone unless you really know what you are doing and have some specific technical reason for using them.  Sturmbots manages all of the "learning" functions by default at the recommended settings.  Apparrently "learnrate 5" should not be used with less than 24 Sturmbots.

maxbodies [0-64]
This controls the maximum number of bodies that will be left on your server when Sturmbots are killed when "bloodmode" is set to 2.

max_bots [a number]
Fills the server with the given number of Sturmbots, distributing them evenly between the two teams.  This command will include the number of human players in that number.  This command must be used with the "min_bots" command in order to work properly.  If you use the "max_bots" command without the "min_bots" command your server will eventually crash.
When the "max_bots" command is working properly it will automatically kick the bots and create them as players join and leave the server.  If there are more players playing than the "max_bots" number, no Sturmbots will be created.  Note that this command can behave strangely sometimes.  If the command is not working properly (this will generally mean that you have too many bots in the game, or the sides are uneven), using the Sturmbot menu to kick all the bots will generally straighten the problem  out.
Note that if you completely fill your server with bots no one else will be able to join your server.

max_reaction [a number]
This command sets the Sturmbots maximum reaction time in hundredths of a second.  The default setting is if you do not use this command is 120.  See "min_reaction".

maxteamkills [a number]
This sets the number of Sturmbots from his or her own team that a player may kill before the Sturmbots react against that player.

min_bots [a number]
This command doesn't seem to work precisely as intended.  It is supposed to ensure that there are always at least the given number of bots in the game, evenly distributed between the teams.  However, at this time, the only function it seems to serve is to prevent "max_bots" from causing the server to crash.  See "max_bots" for more information.

min_reaction [a number]
This command sets the Sturmbots minimum reaction time in hundredths of a second.  The default setting if you do not use this command is 70.  See the "max_reaction" command

monsterbot [Bot number]
This command will turn the bot you choose, by number, into a monster able to absorb a tremendous amount of damage.  You can obtain the number for your bots by using the rcon "users" command, or the Adminmod "admin_userlist" command.

observer [on/off]
This command will cause the Sturmbots to ignore your presence.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

pistolonly [on/off]
This command forces the Sturmbots to use only their pistols in combat.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

rank [on/off]
This command will give the Sturmbots ranks based on their skill levels.  This can be helpful in keeping straight who is a bot and who is not, as long as the human players don't give themselves similar ranks.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

robotmode [on/off]
This command causes everyone who is killed to explode in the same way as "bloodmode 3" causes the Sturmbots to explode.  Apparrently "robotmode" is not very stable and may cause your server to crash.  You may use "on" or "off" as the variables, or "0" as off and "1" as on.

scorefactor [1-5]
This command controls the chances that a Sturmbot will choose a path where it made kills.  All of the "learn" commands are best left alone unless you really know what you are doing and have some specific technical reason for using them.  Sturmbots manages all of the "learning" functions by default at the recommended settings.

select_password [password]
See section "3. a." of this manual, "Sturmbots on a Dedicated Server", for information on this command.

sturmbotmenu
This command will bring up the Sturmbot menu where you can access certain basic commands by number.

sturmbot_password [password]
See section "3. a." of this manual, "Sturmbots on a Dedicated Server", for information on this command.

throw_grenade [a number between 0 and 10000]
This will set how often, out of 10000 times, Sturmbots will throw grenades when they have an opportunity.  The higher the number used, the more often they will throw a grenade.

e. The "bot.cfg" File

You were already introduced to the "bot.cfg" file in the "Diving Right In" section, now we will go into a bit more detail.  As already noted, the "bot.cfg" file can be found in "sturmbot" folder located in your "dod" directory.  You can open and edit your "bot.cfg" file with Notepad, or any text editor.

The "bot.cfg" allows you to configure Sturmbots so that they load in the way that you want every time you start your DOD server.  All of the commands listed above in the "Sturmbot Commands" section, with a few fairly obvious exceptions, can be entered as lines in your "bot.cfg" file.

IMPORTANT NOTE: The only difference in format between the way commands are entered in the console, and the way the command lines are entered into the "bot.cfg" file is that you must use "1" for "on" and "0" for "off".  Every place where the command section indicates "[on/off]", "1" and "0" must be used in "bot.cfg" file.


f. Sturmbots and Adminmod

If you are running Adminmod on your server with sturmbots you don't need to use the "admin_rcon" command with any of your sturmbot commands including "sturmbot_password". Sturmbots isn't a Metamod plugin so it operates entirely outside of Metamod and Adminmod's command structure.

4.  Installing Maps and Waypoints

Note:  This manual will not go into the nuts and bolts of creating and editing waypoint files.  If this interests you there is an html Waypoint Tutorial that can be found in the "WaypointTutorial" folder located in your "Sturmbot" directory.

There are always new maps coming out for use with DoD.  Many of your fellow Stumbot users take lots of their valuable spare time and make waypoint files for these maps.  You need to download both of them in order to use the new maps and to have the bots know where to go on them.

You can find many maps and waypoint files for Sturmbots here:

http://www.houstondod.com
http://www.sturmbot.houstondod.com


Note that installing maps and waypoints uses the same procedure on listen servers and dedicated servers.
a.  Installing a Map

Some maps come as ready to install file.  These end with ".exe".  For example dod_flak88.exe.  To install these, you do not need any other software on your computer.  To install these maps, just double click on the file and an installer will run.  The installer will try and install it to the default DoD folder, by default, C:\SIERRA\Half-Life\.  Hit browse and give it the correct directory if you did not install to the default directory.  To double check that the map was properly installed look in the "dod\maps" directory for a file that has the name of the map with the suffix ".bsp".  If you were installing "dod_flak88", there should be a file called "dod_flak88.bsp" in the "maps" directory.

Other maps come in a "zip" file to make them smaller, and thus faster to download.  These usually end with ".zip".  For example "dod_fabrik.zip."  Before you try and add these maps, make sure you have a program like winzip installed on your computer to unzip the map files.  Note that if you are using Windows XP you do not need any additional software.  You can download an evaluation version of Winzip for free from:

http://www.winzip.com.

If you are using Windows XP you will need to right click on the file and choose the "Extract All" option, Winzip may be used to extract files in a similar fashion.  You may want to view the files before you extract them.  Look for a readme file that for instructions.  Most often, however, you may simply extract the contents of your "zip" file into the "dod" folder located in your root "Half-Life" directory.  Note that your root "Half-Life" directory may actually be called "Counter-Strike" depending on the version of the game you own.  As with the ".exe" installation, you can tell if the map was properly installed by looking for the ".bsp" file in the "maps" directory.


b.  Installing a Waypoint file

OK, so you have a new map installed.  In order to actually use Sturmbot on these new maps, you must install a waypoing file for the map.  First off, download the waypoint file.  You can find waypoint files for many maps here:

http://www.sturmbot.com/maps.html

Next, cut or copy the waypoint file in the waypoint directory under the Sturmbot directory.  For example, if you used the default installation settings for Half Life and DoD, then you would put them in this directory:
C:\SIERRA\Half-Life\dod\sturmbot\waypoints

As long as you have waypoints in this directory, you will be able to play with bots on the custom maps you install.

Note:  If you experience crashes when you start up a map, try deleting the files that pertain to the map in the "\sturmbot\temp" folder, and the "\sturmbot\learn" folder.


c.  Mapcycle.txt

In your "dod" directory, you will find a file called mapcycle.txt.  This tells DoD what maps you want to play and in what order you want to play them.  Note that in order to use this file you must have the following line in the "server.cfg" or "listenserver.cfg" file, depending on the kind of server you are running.

mp_timelimit 30

You will find these files in the "dod" folder located in your root "Half-Life" directory.  Note that your root "Half-Life" directory may actually be called "Counter-Strike" depending on the version of the game you own.  You may open and edite these files with Notepad or any text editor.  This command will set up your server so that it will play each map in the "mapcycle.txt" file, in order, for 30 minutes each.

If you want to add your new custom map to the rotation, then use Notepad to open the "mapcycle.txt" file.  Add the name of the map you want to add to the cycle in the place you want to play it.  For example, say your mapcyle.cfg has these two lines at the top of the file:

dod_caen2
para_kraftstoff

Now lets say you downloaded and installed a new map called dod_flak88.  You want to start that map after Caen2 and before para_kraftstoff.  Just insert a line and add the name of the map.  Your file would then look like this:

dod_caen2
dod_flak88
para_kraftstoff

Save the file, and from that point on, the new map will be included in  your game rotation.  One note of caution:  make sure you type the name of the map correctly or it will not load properly.


5. Vocal Commands

Sturmbots will respond to commands from the three DOD Vocal Commands menus.  We will not be going into much detail here on how the Sturmbots respond to the various commands other than to highlight a couple of the, perhaps, less obvious and more important commands.  It will suffice to say that you can effectively control your Sturmbots within hearing range using the vocal commands.

If you want the Sturmbots to follow you, use the "Stick together men!" command.  If you need machine gun ammo, yell out "I need ammo!" and the bots will try and drop you more ammo. If you are attempting to take an objective that requires more than one person to capture, "I need backup!" will cause any Sturmbots within hearing range on your team to come to your aid..  In fact "I need backup!" may be the most popular and useful command in the menus


6.  Frequently Asked Questions (FAQ)

 
Q: Can I run Sturmbot on my dedicated server?  

A: Yes 

 
Q: Can I run Sturmbot with Admin Mod and other plugins? 

A: Yes. We run it with Admin Mod, HLGuard, HL Boost, Blatt Rate, Sank Consgreet, and LogD with no problem.


Q: How do I access Sturmbot menus and commands on my dedicated server?

A: See section 3. b. "Sturmbots on a Dedicated Server".


Q: How do I get Sturmbots to follow me?

A: The vocal command "Stick together men!" will cause the Sturmbots to follow you.
 

Q: Can I keep the bots from showing up in my Psychostats stats pages?

A: A: Yes. Keeping the Sturmbots from showing up in Psychostats is simple. Find a file called "deny.cfg" in your main Psychostats directory. Open it with notepad.  Add this line:
 
won: BOT

Save the file.  Stats for the bots will now be excluded from your Psychostats pages.

Q: Do you have a list of all of the commands for Sturmbot?
 
A: See the section 3. d., "Sturmbot Commands", of this manual.  There is a list of the commands and what they do there.  Note that this list does not include waypoint commands.  See the Waypoint Tutorial for more information on waypoints.

 
Q: Can I change the bot settings in game?

A: Yes.  See the sections 3. b. and 3. d. of this manual.

Q: I downloaded a map, but I cannot get the bots to show up.  A message appears that says "no waypoints for this map".

A:  You must install waypoints for each map that you want to use Sturmbots in.  See sections 4. a. and 4. b. of this manual.


Q: My server keeps crashing, any suggestions?

A: Sturmbots has proven itself to be a fairly stable program, however nothing is perfect.  Using the "max_bots" command without using the "min_bots" command will probably cause your server to crash eventually.  The only other advice that can be offered here is to try and isolate the cause of the crash.  Try running your game over night without any additional programs.  If it is stable and you are using Adminmod, try adding that to see if you can get your server to run overnight without any crashes.  If it proves to be stable then, add Sturmbots.  If it is still stable, you know that the problem is not Sturmbots and from there it will continue to be a process of elimination, adding one plugin or setting at a time to try and isolate the cause of the problem.

The Sturmbot forums may be a useful place to turn for help:

http://sturmbot.houstondod.com/forum/index.php

Other useful places to turn for help are the United Admins forums:

http://forums.unitedadmins.com/

or the Adminmod forums:

http://www.adminmod.org/


7. Useful URL's


Adminmod Website

http://www.adminmod.org/


DOD Download

http://www.dayofdefeatmod.com/files/game/mirrors.html


DOD Server Guide

http://forums.dayofdefeatmodums/showthread.php?=f2fc9c91d6cfe12a395b32572fe4f9f1&threadid=42150


HLDS Download

http://www.unitedadmins.com/HLDS_x110_DL.aspx



Map and Waypoint Files

http://www.sturmbot.com/


Sturmbot Forums

http://sturmbot.houstondod.com/forum/index.php


Sturmbot Download

http://sturmbot.houstondod.com


Sturmbot Loader Download

http://sturmbotloader.houstondod.com


United Admins Website

http://www.unitedadmins.com/News.aspx


Winzip

http://www.winzip.com.


8. Credits

Thanks to:

Dod team

Botman
Houstondod

Signit
Sydslag
Sgt. Slaughter
IC Stoned
Smitty
Envinyatar
Bad_Dude
Phuzzy
Pinkerton 
JCoquillon
Manic
Stoffer

And everyone else that I have forgotten to mention.

email:  jowo@houstondod.com


SturmBot Loader

Ken Lowe


Thanks to Owen Lee Stairs and Stuart Thayn for all the work they put into this manual.
