( search forums )
Waypoint Mapping for Dummies
Soldat Forums - Soldat Maps & Map Making - Bot Forum
Soap
March 4, 2004, 2:53 am
Preface
This plain English article will provide insight on waypoint mapping for the rest of us. It's a given that if you make a post on the forums spamming SOEMONE WAYPOINT MY LEVEL!1, no one is going to do it for you, because you are a loser and your map probably sucks. Take the initiative and atleast give waypoint mapping a try before begging for help. And if you want help and have not yet been offended by my modesty lacking introduction, read on from here.

Assumed Knowledge
By reading this article, it is assumed that:

. You have played Soldat with bots.
. You have made a map with the official Soldat map maker.
. You want to learn how to map waypoints or have a basic understanding of it.
. You've read the map maker help file.

This is not the place to find someone to waypoint a map for you!

What Are Waypoints?
A waypoint is a point on a map that contains instructions on moving about the map for bots who make contact with it, provided that they are not worrying about something else nearby. They are invisible and have no effect on human players.

When a bot player is created at a spawn site, it is programmed to act in a defensive manner. If there are no pressing matters for the bot to deal with, it will not make any actions unless there is a waypoint to guide it. Waypoints ensure that bots can interact with and make their way around a level; the intent of this is to make the map playable for a single human player (or more, or less) with bots. Waypoints are absolutely essential for infiltration and capture the flag maps.

How Waypoints Work
When a bot is following a waypoint path and makes contact with a waypoint (paths will be touched on shortly), it will follow the instructions that are included in the waypoint; by instructions we mean one or a combination of the following:

. Move left
. Move right
. Jump (up)
. Crouch (down)
. Use jetpack

also:

. Wait x seconds before following instructions
. stop and camp

(note: obviously some combinations of these are impossible and will cause the bot to malfunction)

The instructions are read as soon as the bot makes contact with the waypoint. At this point, any instructions the bot was following from a previous waypoint are terminated and it henceforth begins to follow the instructions read from the current waypoint.

The bot will follow the instructions until it makes contact with another waypoint in the current path, encounters an enemy player, encounters a team mate with the enemy flag or objective or discovers that its corresponding team's flag is nearby and not in the base.

In the case that the bot meets an enemy player, it will ignore any instructions it was following until the enemy is no longer in the bots field of view. Obviously, this problem can be solved by killing the enemy!

In the case that the bot encounters a team mate with the enemy flag or objective, it will once again ignore any instructions and instead revert to following its team mate until the flag or objective has been succesfully captured or is no longer in the bot's field of view.

If the bot encounters its corresponding team's flag and it is not in the base, it will ignore its instructions and instead make its way to the flag until the flag has been returned to base or the flag is no longer in the bot's field of view.

When these conditions are met, it will recall the instructions it was following from the last waypoint. To help you better understand how waypoints work, here is a descriptive example.

A bot is created at a spawn point and comes into contact with a waypoint that contains the instructions "Move Right" and "Use Jetpack". Now, picture your keyboard and the way you play Soldat. If you were a bot and read these instructions from a waypoint, you would press and hold your "Move Right" and "Use Jetpack" key. This is exactly how the bot would function; it would continue to move right and use its jetpack until it encounters an enemy player or makes contact with another waypoint in the current path.

Paths organize waypoints into groups which allow the creation of one or two paths for bots to follow on the map. Paths are created by linking waypoints together. For example, if a bot was following instructions from path 1 and made contact with a waypoint from path 2, it would ignore it. Bots will only follow a waypoint's instructions if it is in the same path as the last waypoint. It is possible for waypoints to link to more than one other waypoint and form seperate "branches" of the same path. This is a powerful waypoint fuction and allows bots to randomly decide on the next course of action.

In a capture the flag, each team should have a path originating from their spawn point. At a minimum, each path must have atleast one branch the leads to the enemy team's flag. In capture the flag games, path 1 corresponds to the red team and should lead to the blue flag, on the flip side path 2 corresponds to the blue team and should lead to the red flag.

In infiltration games, path 1 corresponds to the red team and should lead to the objective, where as path 2 corresponds to the blue team and should lead to, well, some sort of defensive position around the objective as well as the red team's base. Blue team's defensive "positions" are best described as waypoints ordering the "stop and camp" instruction. If the objective is taken from the blue base, the blue team bot will stop camping and follow the waypoint paths to the red base provided that they are there.

It is possible for a map to contain no waypoints and still function with bots, provided that they spawn close enough to eachother, but this is unprofessional and carries with it several limitations.

Any person, dumb or not, can work out how to use the map maker's waypoint tools. Even if you can't figure it out, there is a help file included with the map maker and it's probably a given that you've read it already.

The two most advisable things to do to get better at waypoint mapping are to look at other peoples' maps and to practice. Practice!

Presumed FAQ
Q: I've waypointed my map but the bots get stuck a lot!
A: This might not be a waypoint problem at all. Make sure your polygons are smooth first. If you think your polygons aren't causing any problems, then tweak the positions of your waypoints a bit. Go through the map yourself and get a feel for how you move about it, then base your waypoints on that.

Q: I've waypointed my map but the bots don't move!
A: Remember that a bot needs to come into contact with a waypoint from the start, so if the bot spawns in a place where it doesn't touch a waypoint, it won't start moving at all!

Q: The bots run around in loops!
A: It's pretty hard to make this happen! Just make sure you haven't linked waypoints together in a messy pattern or made two waypoints that say "Move right" and then "Move left"!

Q: Will you waypoint my map?
A: No.

bb_vb
March 5, 2004, 4:12 am
Nice work, that should help a lot of ppl, as so many have troubles with waypoints.

I am interested to see some of your maps. I tried to find ctf_swamp, but couldn't see it anywhere, and the link in the topic is (probably long) dead. Perhaps you could link a couple of them up for me.

Best ctf map ever? Big statement, but I'm looking forward to seeing it.

Sprocket
March 23, 2004, 11:08 am
so...soap... you are like the best waypointer?
let's try one of your maps shall we?

Deleted User
March 31, 2004, 10:42 am
You don't have to be the best to write a tutorial. Soap obviously knows how waypoints work, thats all that is needed, so be quiet [:P]

Good job Soap.

Sliker_Hawk
March 31, 2004, 6:06 pm
Erm.. its not a tutorial ? Well, its tells you the basics and stuff but its not a TUTORIAL..

Deleted User
March 31, 2004, 11:45 pm
Ok ok ok, article then. Whatever.

Sliker_Hawk
March 31, 2004, 11:55 pm
Lol.. sorry to correct you..

Trevelyan
April 5, 2004, 4:05 pm
Yay my crappy map FINALLY WORKS!!

*bumsecks soap*

*wakes up*

D:

FragMonkey
June 20, 2004, 6:36 pm
Hey oap great help article my map should work now with bots, previously, i was looking for some1 to do it for me and now i wil do it on my own. I cant wait to see ur best ctf map ever

Yeti
June 26, 2004, 12:35 pm
Last time I checked If you have a waypoint and you connect it too a waypoint some where else, you have to put the command in the waypoint you connected the 1st one too. Was that in there...I cant remember?

Captain Bob
June 28, 2004, 8:27 pm
This question is for soap I know you must have explained it somewhere else but I cant see it anyway I was making my waypoint and I did everything you said I started the waypoint at the blue sides respawn spot (I am making a capture the flag map) and all they do is sit there and do nothing I did everything u said I started it at the respawn spot and everything please if you can help me as soon as possible thanx. [:D]

Genocide
July 8, 2004, 1:29 pm
Make Multiple Starting points all around the respawn dot. They wont always respawn DIRECTLY on it so you have to make extra spots

brickman
September 4, 2004, 2:09 am
You left out a few things:
1 How do you make a branch?
2 How do they return to a path if they leave it to, say, grab a flag or kill you?
3 How does blue in inf find its way to the path leading to the red flag after a cap, and which path is the route to the flag on (1 or 2)?

Raptor
May 17, 2005, 3:24 pm
1. I don't know
2. There should be waypoints where they land, otherwise they'll not move
3. 2

Deleted User
July 28, 2005, 3:12 pm
Can I translate your article and be announced in the Yahoo clubs of Taiwan publicly?

I want join your article in my flash...

I will note source


I know my English isn't good, if the grammar has mistake to ask to point out...

Deleted User
July 31, 2005, 5:21 pm
i made this awsome map, its huge and is best with 2 teams of atlest 10 each, and no matter what i do the (insert your own swear here) bots wont move where i want them, if someone could waypoint fer me or just likesit down and show me via msn or sumthin i would be eternaly gratefull

Soap
March 29, 2006, 1:03 am
[IMAGE]