Skip to content

Latest commit

 

History

History
93 lines (66 loc) · 4.56 KB

wpedit.md

File metadata and controls

93 lines (66 loc) · 4.56 KB

T4 Bot Warfare Waypoint Editor

First things first, Bot Warfare uses the AStar search algorithm for creating paths for the bots to find their way through a map.

The AStar search algorithm requires a set of waypoints defining where all the paths are in the map.

Now if you want to modify existing or create new waypoints for World at War maps, this is the read for you.

Contents

Setting up the Waypoint Editor

The Bot Warfare mod comes with the Waypoint Editor out of the box, so its just a matter of telling the mod you want to use it. Its a matter of setting the bots_main_debug DVAR to 1.

Start your game, and load up the Bot Warfare mod. Now open your console with tilde(~).

In the console, type in set bots_main_debug 1.
Setting the dvar

Now start a match with the map you want to edit.

It should be noted that waypoints load in this following order;

  1. checks the 'waypoints' folder (FS_Game\waypoints) for a csv file
  2. loads the waypoints from GSC (maps\mp\bots\waypoints)

If all fail to load waypoints, there will be no waypoints and the bots will not know how to navigate the map.

The Editor

The editor
This is the Waypoint Editor. You can view, edit and create the waypoint graph.

  • Each red number you see in the world is a waypoint.
  • The green string you see is the type of that waypoint.
  • The green list of numbers are the waypoints linked to that waypoint.
  • The pink lines show the links between the waypoints, a link defines that a bot can walk from A to B.
  • The white lines show the 'angles' that a waypoint has, these are used for grenade, betty and tube waypoints. It's used to tell the bot where to look at when grenading/betty, etc.

Pressing any of these buttons will initiate a command to the Waypoint Editor. Each button has a secondary modifier button, and can be pressed shortly after pressing the primary button.

  • SecondaryOffhand (stun) - Add Waypoint

    • Press nothing - Make a waypoint of your stance
    • ADS - Make a climb waypoint
    • Attack + Use - Make a tube waypoint
    • Attack - Make a grenade waypoint
    • Use - Make a claymore waypoint
  • Melee - Link Waypoint

    • Press nothing - Link
    • ADS - Unlink
  • FragButton (grenade) - Delete Waypoint

    • Press nothing - Delete Waypoint
    • Attack - Delete all waypoints
    • ADS - (Re)Load Waypoints
  • UseButton + Attack - Save Waypoints

    • Press nothing - Save waypoints
    • ADS - Toggle autolink waypoints (links waypoints as you create them)

Okay, now that you know how to control the Editor, lets now go ahead and create some waypoints.

Here I added a waypoint.
Adding a waypoint

And I added a second waypoint.
Adding another waypoint

There are several types of waypoints, holding a modifier button before pressing the add waypoint button will create a special type of waypoint.

  • Types of waypoints:
    • any stance ('stand', 'crouch', 'prone') - bots will have this stance upon reaching this waypoint
    • grenade - bots will look at the angles you were looking at when you made the waypoint and throw a grenade from the waypoint
    • tube - bots will look at the angles you were looking at when you made the waypoint and switch to a launcher and fire
    • claymore - bots will look at the angles you were looking at when you made the waypoint and place a betty or a charge
    • camp ('crouch' waypoint with only one linked waypoint) - bots will look at the angles you were looking at when you made the waypoint and camp
    • climb - bots will look at the angles you were looking at when you made the waypoint and climb (use this for ladders and mantles)

Here I linked the two waypoints together.
Linking waypoints

Linking waypoints are very important, it tells the bots that they can reach waypoint 1 from waypoint 0, and vice versa.

Now go and waypoint the whole map out. This may take awhile and can be pretty tedious.

Once you feel like you are done, press the Save buttons. This will generate a CSV output to your waypoints folder!

That is it! The waypoints should load next time you start your game!

Your waypoints CSV file will be located at <fs_game>/waypoints/<mapname>_wp.csv. (main folder if fs_game is blank)
Location