Welcome to Marine Bot homepage
a bot for Firearms mod


Install instructions

Follow these steps exactly the way they are written here in order to install the bot correctly.

Using the .exe installer program

  1. run the installation utility and follow the instructions (be sure to read the information on the second page)
  2. that's all, run the game and a few bots will join you

Using the .zip or .rar archive

  1. unpack the archive into your ...\half-life\firearms folder
  2. run the ...\half-life\firearms\liblist_install_mb.exe
  3. that's all, run the game and a few bots will join you

Additional steps if you are running Adminmod/Metamod

  1. open the file 'liblist.gam' in your ...\half-life\firearms folder using notepad
  2. comment out the line under 'MarineBot LAN' using '//' at the start of the line
  3. uncomment the line under 'MarineBot AdminMod' by deleting the '//'
  4. add '+localinfo mm_gamedll marine_bot/marine_bot.dll' in the properties of the shortcut you use to start your game or server

Uninstall instructions

Follow these steps exactly the way they are written here in order to uninstall the bot correctly.

If you used the .exe installer program to install Marine Bot

  1. run the ...\half-life\Uninstall_MB091.exe (or use the Add/Remove Programs from your Control Panel in Windows OS)
  2. erase the whole marine_bot folder inside your ...\half-life\firearms folder
  3. run the ...\half-life\firearms\liblist_uninstall_mb.exe
  4. erase both ...\half-life\firearms\liblist_install_mb.exe and ...\half-life\firearms\liblist_uninstall_mb.exe files
  5. that's all

If you used the .zip or .rar archive to install Marine Bot

  1. erase the whole marine_bot folder inside your ...\half-life\firearms folder
  2. run the ...\half-life\firearms\liblist_uninstall_mb.exe
  3. erase both ...\half-life\firearms\liblist_install_mb.exe and ...\half-life\firearms\liblist_uninstall_mb.exe files
  4. that's all

Supported maps

Well the bot can be used on any map, but with supported I mean maps that have waypoints ie. maps the bot can play with some sort of wisdom. You know where the bot won't just blindly roam, but where he will try to visit important locations like the map pushpoints, objective item locations, places where you usually meet others and so on. Anyways here's the default waypoint list.

Waypointing instructions (ie. how you can make a unsupported map a supported one)

What are the waypoints for?

The bot is using waypoints to navigate through the map. Waypoint is a location in the map (in the 3d space), which the bot will use when navigating. The bot has no eyes so the waypoint will tell him that this location is a walkable space and not a solid wall. The most simple description of a waypoint is that it is a 'hint', which guides the bot.
When editing waypoints, you can see the waypoints drawn with an orange beam. Some special waypoints are displayed in other colors. Waypoints are being stored as a 'mapname.wpt' file in your Marine Bot waypoints folder (ie. marine_bot\defaultwpts). As a addition to the waypoints there are waypoint paths. The path is a connection between two or more waypoints and it tells the bot that there's a clear way between these waypoints. Waypoint paths are being stored in 'mapname.pth'. Unlike the waypoints the paths aren't necessary. However paths improve the navigation and open a lot of possibilities. Therefore we recommend using them.

A few basic waypointing console commands:

wpt showshows the waypoints (displays them using a colored beams). It toggles between show and hide waypoint.
wpt addadds a waypoint to your location
wpt deletedeletes a waypoint you're standing by
wpt movemoves/repositions close waypoint to your location (you have to be quite close to a waypoint)
wpt infodisplays number and properties (if available) of the waypoint you're standing by

pathwpt showshows/hides the waypoint paths (displays vertical lines between waypoints)
pathwpt startstarts a new path on the waypoint you're standing by
pathwpt stopends the path (you can use it anywhere, because it only stops adding any new waypoint in the path)
pathwpt addadds a waypoint you are standing by to the path
pathwpt autoaddtoggles between automatic pathwaypointing (automatically adds any waypoint you touch to the path) and manual path building by using the command from above
pathwpt deletedeletes the path on the waypoint you're standing by

wpt savewrites the waypoints and paths into mapname.wpt and mapname.pth files
wpt loadreads the waypoints and paths from the files (it can also be used as one step undo feature when you're working on the waypoints)

Special waypoints:

You can assign a special tag/flag/type to any waypoint. All you need to do is get close to the waypoint you want to make special and use 'wpt change argument' command. Where the argument is the new type of the waypoint. You can use one of the following options:
  1. aim
  2. ammobox
  3. claymore
  4. cross
  5. crouch
  6. door
  7. duckjump
  8. goback
  9. jump
  10. ladder
  11. normal
  12. parachute
  13. prone
  14. pushpoint
  15. shoot
  16. sniper
  17. sprint
  18. trigger
  19. use
  20. usedoor
For more info check the waypointing documentation where you can get detailed explanation.

Okay I know the commands now. What do I have to do to start the waypointing?

The only thing you should do is kick all the bots off the game. The bots may behave strange and/or even crash the game. So type this command 'kickbot all' into the console. Then you can use the 'pathwpt show' command to display waypoints and paths (if there are any).

So how do I add a new waypoint?

Just type the 'wpt add' command and a new waypoint will appear at your position. You can use argument to specify the waypoint type if you wish. I mean you can add a cross waypoint by typing 'wpt add cross' into the console. This is a faster way than adding standard waypoints and then changing them to special types using the 'wpt change argument' command. You do it all using just one command.

I see blue, yellow, green and other color beams instead of the orange beam waypoints. What they are for?

These are the special waypoint types mentioned above. They tell the bot to do some kind of a action there. Or they inform the bot that there's something he would like to have/do there. See the 'special waypoints' paragraph for more info.

I used the 'pathwpt show' command, but I don't see any paths. What's wrong?

Sometimes you have to be close to a waypoint in order to see the path. Once you're standing close enough the paths on the waypoint will appear. There can also be a problem with the other waypoint in the path. I mean the other waypoint is simply too far to draw it and draw the path beam as well.

I see some of the paths are different in color or appearance. What does this mean?

There are more types of paths. The fact that some of the paths are red for example means that they are assigned for the red team only. On the other hand green path beam tells you the path is assigned for a sniper (light green) or machine gunner (dark green).

I don't like certain path. Can I get rid of it?

Yes of course. You can use the 'pathwpt delete' command to erase any path you don't like. Get close to one of its waypoints and type the command. Or if there are more paths on the waypoint you can use the argument ('pathwpt delete argument') to specify the exact path number (e.g. pathwpt delete 12). The path matching this number will be erased.

Okay so how do I find out the path number then?

Pretty simple. You can use the 'pathwpt info' command which will tell you all about the path including its unique number. Get close to one of its waypoints and type the command.
Tip: If you want to see all the paths on the waypoint you can use 'pathwpt printall argument' command where the argument is the unique number of your waypoint.

And what have to I do to add a new path?

Use the 'pathwpt start' command while standing by the 1st waypoint. Then get to the 2nd waypoint and use the 'pathwpt add' command there. You've just connected the two waypoints with the shortest possible path. If you want to continue adding more waypoints you'll have to get close to each of them and use the 'pathwpt add' command there. Whenever you wish to end the path you can just type the 'pathwpt stop' command into the console.
Tip: You can also make your life a bit easier by using 'pathwpt autoadd' command. Then all you need to do to add another waypoint in a path is getting close enough to it to literally touch it. It will be added automatically. Just be careful when there are many waypoints close, because you may then add even those waypoints you didn't want in this path.

Is there any waypointing tutorial or any guidelines I should follow?

Of course. Reading this step-by-step manual should help you undestand what lies behind the waypoint navigation.

FAQ (Frequently Asked Questions)

What does FAQ mean?

It's an acronym for Frequently Asked Questions.

Is there any in-game help?

Yes, access it by opening the console and entering 'help' or '?' (no quotation marks).

So I will have to use the console commands to control Marine Bot?

Yes full control can only be done using the console commands. However there is a version of the Firearms command menu included with Marine Bot that gives you control over your bots in Firearms 2.8 and above. You can access this menu by pressing the command menu key (by default 'p') ingame. You can change this key in the Options screen for Firearms. Note that this is for a listenserver only, see the 'hlds_cmds.txt' file for a full listing of all commands available on a dedicated server. If you are running Firearms 2.7 or below, you can control Marine Bot using the menu bound to your END key.

When I start a game with Marine Bot I get the message 'Host_Error: Couldn't get DLL API from...'. What’s wrong?

This error occurs when Half-Life can’t find the correct Marine Bot files, usually due to problems with your 'liblist.gam' file. Make sure you have Marine Bot properly installed. Scroll at the top of this page or see the ‘readme.txt’ file for details on how to do this.

Why does Half-Life crash when I use the 'wpt save' command to save my waypoints?

Sorry that you lost your work, but you don't have Marine Bot properly installed. This error will result if there is no marine_bot/defaultwpts folder, which should be created during a correct installation.

While the map is loading, I get an error along the lines of 'NULL entity ...', but the game still loads, and certain gameplay features don’t work. How can I fix this?

If you are using Firearms in version 2.4 up to latest 3.0 this shouldn't happen. If this does happen please let us know using the contact information below. If you are using any other version then you can do the same, but we can't promise that we can do anything about it, because our programmers tend to use the latest full version of Firearms (currently 3.0).

How do I add bots into my game?

Can I arrange it so that bots automatically join the game instead of having to add them one by one?

Bots appear to be stuck, moving blindly between corners. They don’t seem to be able to find their way around the map at all, why is this?

Can I change the names the bots use ingame?

Yes, in the 'marine_dog-tags.txt' file. Be sure to read and follow the instuctions there otherwise things may not work.

Can I change the gear the bots use ingame?

I have waypoints for a map, but they don't work. Why?

Marine Bot automatically converts waypoints from the previous version into its current version. Try typing ‘wpt load’ in the console (no quotation marks), or if that doesn’t work try ‘wpt loadunsupported’, or if that doesn’t work try ‘wpt loadunsupportedversion5’. If either of these works, use ‘wpt save’ to save them. If all return an error, then your waypoint file is probably corrupt, try downloading it again. Alternatively, make sure your waypoint file is of the same name as the map, note that some official maps change names between versions. Finally, MB can only convert from last two most recent waypoint formats, anything older than MB in version 0.8b will not be supported.
Tip: You can type 'get_wpt_system' command to see which waypoint system are the waypoints created in. Marine Bot 0.8b used waypoint system version 5. Marine Bot 0.9b used system version 6. And Marine Bot 0.91b is using waypoint system version 7.

Why do I get the message 'waypoints subscription FAILED ...' when I try to change the authors name for a set of waypoints?

Who made Marine Bot?

See the 'info' section or the ‘readme.txt’ file for a full list of contributors and credits.

How can I help develop Marine Bot?

How can I contact you?

If you have any questions, or find any problems that aren't already addressed in this FAQ, you can contact us by any of these methods (in order of our preference):
Email Frank McNeil
Note: Please remember to include all details of Firearms, Half-Life, Steam and Marine Bot versions. The more information you give us on your problem, the easier it will be for us to help you.

by Frank McNeil 2005-2013

end of file