Note: Waypoints can be imported from RCBot1 using the converter here: http://rcbot.bots-united.com/forums/index.php?act=Attach&type=post&id=561
- Click "Clone or Download" button above and select "Download as ZIP".
- Extract all files to svencoop/scripts/plugins/BotManager (overwrite current scripts)
- edit the file "default_plugins.txt" in "svencoop" folder using notepad
- add "BotManager" plugin to the list of plugins in the file:
For example
// File header comment here
"plugins"
{
"plugin"
{
"name" "RCBot"
"script" "BotManager/BotManager"
"concommandns" "rcbot"
}
// other plugins here
}
do not put comments (//) in front of these lines!!!
Now run svencoop.
Adding a bot:
In the developer console (https://developer.valvesoftware.com/wiki/Developer_Console) type
as_command rcbot.addbot
Alternatively you may set a bot quota to add bots automatically. To do this, edit "config.ini" in the scripts/BotManager/config folder
as_command rcbot.quota [number of bots]
set quota=0 to another number (i.e. to the number of bots).
If bots do not move ensure that rcw (Waypoints) exist for the map in the rcw folder!!!
say any of the following messages for bots to follow commands
'<bot name> press [this/that/a] ...' - bot will move to your location and press nearest button
'<bot name> press [this/that/a] ... <time>' - bot will move to button location and press in <time> seconds. Bot will update you on time left.
Example: "press this in 5" (bot will move to button and say "Pressing in 5 secs..." and update once per second.
'<bot name> wait [here/there/etc...]' - bot will move to your location and wait for 90 sec
'<bot name> come [here/there/etc...'] - bot will move to your location but not wait
'<bot name> pickup [a/some] <ammo/weapon/health/armor>' - bot will move to your location and attempt to pickup what you wanted
'<bot name> use [this tank]' - bot will use the nearest tank
'<bot name> follow [me/<player name>]' - bot will follow you or player with <playername>
'<bot name> heal [me/<player name>]' - bot will heal you or player with <playername>
'<bot name> revive [me/<player name>]' - bot will revive you or player with <playername>
Waypointing currently only works on listen server
show waypoints with
as_command rcbot.waypoint_on
similarly, put them back off with
as_command rcbot.waypoint_off
Use the command
as_command rcbot.waypoint_add
Paths will be created automatically between nearby waypoints, however they may be sub-optimal. So you may need to add paths manually or remove bad paths.
Go to the first waypoint and use the command
as_command rcbot.pathwaypoint_create1
then go to the second waypoint and use the command:
as_command rcbot.pathwaypoint_create2
Go to the first waypoint and use the command
as_command rcbot.pathwaypoint_remove1
then go to the second waypoint and use the command:
as_command rcbot.pathwaypoint_remove2
Go to the waypoint and use the command
as_command rcbot.pathwaypoint_remove_to
Go to the waypoint and use the command
as_command rcbot.pathwaypoint_remove_from
as_command rcbot.waypoint_delete
Waypoint type Usage Implementation status
"water" bots will only go here if there is water (useful for moving water)
"wait_noplayer" bots wait for a player to pass before going through OK
"scientist" A scientist is needed to complete the important waypoint OK
"crouch" Put where bot needs to crouch (auto) OK
"ladder" Bots look at waypoint (at bottom and top of ladder) OK
"lift" Coming soon Unimplemented
"platform" A moving platform OK
"health" Put at health pick up or health charger Fully implemented
"armor" Put at battery pickup or HEV charger Fully implemented
"ammo" Put at ammo pickup OK (partially implemented)
"checkground" Bots don't progress until waypoint has a ground (e.g. drawbridge) OK
"important" Put at objective point such as button
or breakable needed to move to next stage OK
"barney" A barney is needed to complete the important waypoint OK
"defend" Coming soon Unimplemented
"aiming" Coming soon Unimplemented
"crouchjump" Bots should do a longjump (TO CHANGE NAME) Bots just do a normal jump atm
"wait" Bots wait 1 sec before moving to next waypoint OK (waitlift unimplemented)
"pain" Put at a place where bots will be killed
until a trigger_hurt stops working OK
"jump" Put where a bot needs to jump OK
"weapon" Put at a weapon pickup OK (partially implemented)
"teleport" Put at a teleport OK
"tank" Put at a useable turret Unimplemented
"grapple" Bots aim a grapple gun at the waypoint to progress OK
"staynear" Bots tay closer and slow down at waypoint OK
"end" Put at the end of level (main objective) OK
"openslater" Put behind an area that opens later and
has path between a wall/door OK
"humantower" Bots crouch and wait for players to jump on them then stand.
Otherwise will jump on crouching players. OK
"unreachable" Used for visibility only OK
"pushable" limited functionality
"grenthrow" Coming soon Unimplemented
Walk to nearest waypoint and use the command
as_command rcbot.waypoint_givetype <type1> [type2] [type3]
you can give a waypoint multiple types. Use the type names in the table above.
as_command rcbot.waypoint_removetype <type1> [type2] [type3]
you can remove multiple types. Use the type names in the table above.
as_command rcbot.waypoint_toggletype <type1> [type2] [type3]
you can toggle multiple types. Use the type names in the table above.
to change all waypoints with a particular type to another use
as_command rcbot.waypoint_convert_type <type_from> <type_to>
for example
as_command rcbot.waypoint_convert_type end important
Waypoint colour will change depending on waypoint type(s). To view the type(s) on a waypoint, go to a waypoint and use the command
as_command rcbot.waypoint_info
a message will appear on the HUD
Waypoints load automatically at map start up , but sometimes still has issues
as_command rcbot.waypoint_load
The program will try to load the waypoint in the ‘store’ folder first (custom waypoint), and then in the rcw folder if none exists.
as_command rcbot.waypoint_save
waypoints will be saved in the ‘store’ folder.
To start waypoints from scratch use the command
as_command rcbot.waypoint_clear
Many waypoints have been converted from RCBot 1, however some waypoint types now differ.
1. There should be only one 'end' waypoint at the end of the map
2. There should be multiple 'important' waypoints to indicate milestone button presses etc.
3. The 'wait lift' waypoint is now 'wait'
4. Ladder waypoints aren't used, but bots can still climb ladders without the need for ladder waypoints. Just make sure the path is slightly angled so that bots do not look in the wrong direction going up the ladder.
as_command rcbot.waypoint_cut (deletes but rememebers waypoint type for paste)
as_command rcbot.waypoint_copy (rememebers waypoint type)
as_command rcbot.waypoint_paste (pastes remembered waypoint type at current location)
as_command rcbot.waypoint_move1 (remembers waypoint type and paths and deletes waypoint)
as_command rcbot.waypoint_move2 (moves rememebered waypoint in 'move1' and pastes it at current location)
as_command rcbot.visrevs (number of visible checks every 0.1 sec - reduce to increase CPU performance but bots' reaction time will be reduced)
as_command rcbot.navrevs (number of paths to check every 0.1 sec - reduce to increase CPU performance but bots' pathfinding time will be increased)
as_command rcbot.heal_npc (set to '0' to disable bots healing NPCs - default is '1')
as_command rcbot.revive_npc (set to '0' to disable bots reviving NPCs - default is '1')
as_command rcbot.suicide (0 = disable bots suicide if they think they get stuck)
as_command rcbot.disable_util (1 = disable bots doing anything)
as_command rcbot.belief_mult (extra cost given to paths of danger, default = 400)
as_command rcbot.dont_shoot (1 = bots dont shoot)
as_command rcbot.use_belief (0 = disable extra cost on dangerous paths)
sometimes you need cheats during debugging to make things easier, some are below
as_command rcbot.godmode
as_command rcbot.noclip
as_command rcbot.notarget
as_command rcbot.notouch (puts player into observer mode, ensure survival mode is disabled)
as_command rcbot.explo [magnitude] (creates an explosion to kill of bosses quickly)
as_command rcbot.teleport_wpt [waypoint id] (teleports player to waypoint ID)
as_command rcbot.teleport_set (sets teleport position)
as_command rcbot.teleport [player name] (teleports you or player with name to set position)
There is a bot camera that the listen player can sit back and watch, which follows bots in third person.
switch on botcam
as_command rcbot.botcam on
switch off botcam
as_command rcbot.botcam off
All bots will refrain from shooting with the command
as_command rcbot.dont_shoot 1
To debug a bot use the command
as_command rcbot.debug_bot <partial botname>
And make sure to toggle either of the following
as_command rcbot.debug nav (debug navigation)
as_command rcbot.debug think (debug general)
as_command rcbot.debug task (debug tasks)
as_command rcbot.debug util (debug utility)
as_command rcbot.debug visibles (debug visibles -- not done yet)
Also make sure
developer 1
a new addition to RCBOT AS edition is objective scripting for "important" waypoints. These are waypoints bots will use to complete objectives. The point of using a script is to let bots know to no longer go to completed objectives, and know the order of objectives particularly for complex maps. An additional script for each map is optional which allows bots to understand which objectives to complete.
Objective scripts are .ini files and exist in the waypoint folder. The store folder is checked first.
the hplanet.ini has been done as an example
Each line in the ini file indicates one objective (i.e. one important waypoint) (lines starting '#' are comments).
[important waypoint ID],[previous important waypoint ID],[important entity index],[important entity index parameter],[operator], [value]
- [important waypoint ID] is the ID of the important (objective) waypoint. Use rcbot.waypoint_info to get the ID.
- [previous important waypoint ID] is the ID of the previous important waypoint that the bot needs to complete before this one. IF none, set this to -1. Usually the first objective will not have a previous objective.
- [important entity index] is the entity index of an entity to check against. use rcbot.search to list the entity index and parameters. TO GET THE CORRECT ENTITY INDEX, MAXPLAYERS MUST BE 8.
- [important entity index parameter] can be any of the following (use rcbot.search to get these values)
if entity_index is greater than 0:
- x (x origin)
- y (y origin)
- z (z origin)
- distance (distance from waypoint in units)
- frame (frame for used buttons is typically 1)
- visible (1 is visible, 0 is invisible [e.g. for func_wall_toggle])
- solid (solid state)
- 0 = not solid
- 1 = touch not blocking
- 2 = touch, blocking
- 3 = touch not on ground
- 4 = BSP clip
- angle.x (x angle)
- angle.y (y angle)
- active (if it is triggered/unlocked) if entity_index is 0 (this means self):
- health (health value)
- armor (armor value)
- [operator] can be either
- > (greater than)
- < (less than)
- = (equal to)
- != (not equal to)
- [value] can be any number
The objective is considered completed if the [important entity index parameter] [operator] [value] is true e.g.
frame = 1 will be true if a button is typically pressed and entity index is a button
hplanet is the following:
#WID, prev, entity search, parameter, operator, value
71, -1, 204, distance, >, 280
91, -1, 205, frame, =, 1
129, 71, 238, frame, =, 1
164, 129, 336, frame, =, 1
176, 164, 325, null, null, null
180, 176, 391, frame, =, 1
196, 180, 400, frame, =, 1
193, 196, 423, distance, >, 180
The first two objectives don't have pre-requisite objectives. The lines with "frame,=,1" are buttons that when pressed will be considered complete. The line "176, 164, 325, null, null, null" means that entity index 325 will be null if completed (e.g. its a func_breakable and when its broken the entity is removed)
Tips:
- check vertical opening doors have been opened by checking previous and after z origin
- check horizontally opened doors by checking previous and after x/y origin
- check buttons have been pressed by checking frame == 1
- check func_breakables have been broken by using null,null,null for parameter, operator and value
- check func_wall_toggle is visible using visible parameter and 1 for value (visible) or 0 for invisible.
- check trigger_hurt solid when active
- check rotating doors are open by checkig against angle.x / angle.y
Editor: Visual Studio Code: https://code.visualstudio.com/
