Tf bot: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (→‎Bot Names: Wrapped these in Template:ExpandBox, might be a good idea)
Line 304: Line 304:


==Keyvalues==
==Keyvalues==
{{KV TeamNum}}
{{KV TeamNum|tf2=1}}
{{KV BaseAnimating}}
{{KV BaseAnimating|base=1}}
{{KV BaseEntity}}
{{KV BaseEntity|base=1}}


==Inputs==
==Inputs==

Revision as of 04:57, 1 July 2021

Team Fortress 2 tf_bot is a point entity available in Team Fortress 2 Team Fortress 2.

C++ In code, it is represented by theCTFBotclass, defined in thetf_bot.cppfile.

Entity description

A NextBot entity for TF2 that acts as a player. They are used in the Training and Mann Vs. Machine gamemodes. This entity can be created through `tf_bot_add`, which when used will randomly select a bot name out of a hardcoded list of bot names.

Note.pngNote:This entity cannot use Teleporters and Dispensers.
Icon-Bug.pngBug:Creating the entity through `ent_create` will crash the game.  [todo tested in ?]
Icon-Bug.pngBug:This entity will not move in Capture The Flag (and by proxy MvM maps) if there is no flag for the entity's team.  [todo tested in ?]

Behavior

TFBots behave based on the skill value (or difficulty) they have, which can be set through `tf_bot_difficulty` or with `tf_bot_add`. Skills are defined in game as follows:

  • Easy (0)
  • Normal (1)
  • Hard (2)
  • Expert (3)
Todo: Add chart of behaviors based on skill value.

Scout

[Todo]

Soldier

[Todo]

Pyro

Pyro bots are normally offensive and will attack players with all of their weapon slots.

They airblast players that are closer than tf_bot_pyro_shove_away_range hammer units to the bot pyro, and projectiles if they are visible to the pyro bot and are within tf_bot_pyro_deflect_tolerance angles (in radians) relative to the Pyro bot. How often they will airblast depends on their skill level.

Skill Level Chance to Airblast
Easy 0% chance
Normal 50% chance
Hard 90% chance
Expert 100% chance

Demoman

[Todo]

Heavy

[Todo]

Engineer

Engineer bots focus on defending points by building. They will only build Sentry Guns and Teleporters. Engineer bots normally just stay around their sentry and constantly hit it with their wrench. If the engineer bot get attacked however, they will attack with their weapon and flee.

In Mann Vs. Machine Engineer bots will not attack, unless if they're marked as a squad.

Note.pngNote:Engineer bots will not switch to another class if their Sentry or Teleporter Exit is up.

Medic

Medic bots typically heal bots, but will fight when forced to.

In Mann Vs Machines Medic bots will not attack, unless if marked to be part of a squad in the popfile.

Sniper

Sniper bots typically look around for Sniper Spots in the nav mesh and attack from those areas. However if an enemy gets close to them the Sniper bot will fight them and then try to retreat to their goal.

Spy

[Todo]

Bot Names

The following bot names are what the game uses to randomly set a bot name when creating a bot.


  • Chucklenuts
  • CryBaby
  • WITCH
  • ThatGuy
  • Still Alive
  • Hat-Wearing MAN
  • Me
  • Numnutz
  • H@XX0RZ
  • The G-Man
  • Chell
  • The Combine
  • Totally Not A Bot
  • Pow!
  • Zepheniah Mann
  • THEM
  • LOS LOS LOS
  • 10001011101
  • DeadHead
  • ZAWMBEEZ
  • MindlessElectrons
  • TAAAAANK!
  • The Freeman
  • Black Mesa
  • Soulless
  • CEDA
  • BeepBeepBoop
  • NotMe
  • CreditToTeam
  • BoomerBile
  • Someone Else
  • Mann Co.
  • Dog
  • Kaboom!
  • AmNot
  • 0xDEADBEEF
  • HI THERE
  • SomeDude
  • GLaDOS
  • Hostage
  • Headful of Eyeballs
  • CrySomeMore
  • Aperture Science Prototype XR7
  • Humans Are Weak
  • AimBot
  • C++
  • GutsAndGlory!
  • Nobody
  • Saxton Halenav_gen_cliffs_approx
  • RageQuit
  • Screamin' Eagles
  • Ze Ubermensch
  • Maggot
  • CRITRAWKETS
  • Herr Doktor
  • Gentlemanne of Leisure
  • Companion Cube
  • Target Practice
  • One-Man Cheeseburger Apocalypse
  • Crowbar
  • Delicious Cake
  • IvanTheSpaceBiker
  • I LIVE!
  • Cannon Fodder
  • trigger_hurt
  • Nom Nom Nom
  • Divide by Zero
  • GENTLE MANNE of LEISURE
  • MoreGun
  • Tiny Baby Man
  • Big Mean Muther Hubbard
  • Force of Nature
  • Crazed Gunman
  • Grim Bloody Fable
  • Poopy Joe
  • A Professional With Standards
  • Freakin' Unbelievable
  • SMELLY UNFORTUNATE
  • The Administrator
  • Mentlegen
  • Archimedes!
  • Ribs Grow Back
  • It's Filthy in There!
  • Mega Baboon
  • Kill Me
  • Glorified Toaster with Legs

Unused Bot Names

The following bot names were found in a leaked source code version of TF2, containing bot names that were never put into production for unknown reasons.


  • John Spartan
  • Leeloo Dallas Multipass
  • Sho'nuff
  • Bruce Leroy
  • CAN YOUUUUUUUUU DIG IT?!?!?!?!
  • Big Gulp, Huh?
  • Stupid Hot Dog
  • I'm your huckleberry
  • The Crocketeer

ConVars/ConCommands

Cvar/Command Parameters or default value Descriptor Effect
tf_bot_add [count|name] [class] [team] [skill] ["noquota"] strings (processed without order) Creates a bot with specified parameters. This entity will borrow from `tf_bot_difficulty` if skill is omitted..
tf_bot_kick [name|"red"|"blue"|"all"] string Kicks bots based on name and team, or all of them.
tf_bot_kill [name|"red"|"blue"|"all"] string Kills bots based on name and team, or all of them.
tf_bot_warp_team_to_me Teleports all ally bots to !activator.
tf_bot_difficulty 1 integer Sets default skill value.
tf_bot_auto_vacate 1 0 disables, 1 enables Whether bots will automatically leave to make room for human players.
tf_bot_always_full_reload 0 0 disables, 1 enables Determines whether bots perform full reloads before firing.
tf_bot_ammo_search_range 5000 Hammer units How far bots will search to find ammo around them.
tf_bot_arrow_elevation_rate 0.0001 Arbitrary float When firing arrows at far away targets, this is the degree/range slope to raise our aim.
tf_bot_ballistic_elevation_rate 0.01 arbitrary float When lobbing grenades at far away targets, this is the degree/range slope to raise our aim.
tf_bot_capture_seek_and_destroy_max_duration 30 arbitrary float If a capturing bot decides to go hunting, this is the max duration he will hunt for before reconsidering.
tf_bot_capture_seek_and_destroy_min_duration 15 arbitrary float If a capturing bot decides to go hunting, this is the min duration he will hunt for before reconsidering.
tf_bot_cart_push_radius 60 Hammer units Maximum distance in which bots will stay within near the payload to push it.
tf_bot_choose_target_interval 0.3f Seconds (float) How often a bot can reselect his target
tf_bot_debug_ammo_scavenging 0 0 disables, 1 enables Draws debug informaton for bot ammo-information.
tf_bot_debug_destroy_enemy_sentry 0 0 disables, 1 enables Draw debug info for bots trying to destroy sentries.
tf_bot_debug_payload_guard_vantage_points 0 0 disables, 1 enables Draw vantage points for guarding the payload.
tf_bot_debug_retreat_to_cover 0 0 disables, 1 enables Draw debug info for bots retreating to cover.
tf_bot_debug_seek_and_destroy 0 0 disables, 1 enables Draw bot seek-and-destroy debug info.
tf_bot_debug_sentry_placement 0 0 disables, 1 enables Draw bot engineer sentry placement debug info.
tf_bot_debug_sniper 0 0 disables, 1 enables Draw Sniper bot debug information.
tf_bot_debug_spy 0 0 disables, 1 enables Draw Spy bot debug information.
tf_bot_debug_stuck_log Given a server logfile visually display bot stuck locations.
tf_bot_debug_stuck_log_clear Clear currently loaded bot stuck data.
tf_bot_debug_tags 0 0 disables, 1 enables ent_text will only show tags on bots.
tf_bot_defend_owned_point_percent 0.5 arbitrary float Stay on the contested point we own until enemy cap percent falls below this value.
tf_bot_defense_debug 0 0 disables, 1 enables Draw defense areas.
tf_bot_defense_must_defend_time 300 aribtrary float If timer is less than this value, bots will stay near point and guard.
tf_bot_engineer_building_health_multiplier 2 unknown type Unused.
tf_bot_engineer_exit_near_sentry_range 2500 Hammer units Maximum travel distance between a bot's Sentry gun and its Teleporter Exit
tf_bot_engineer_max_sentry_travel_distance_to_point 2500 Hammer units Maximum travel distance between a bot's Sentry gun and the currently contested point
tf_bot_engineer_mvm_hint_min_distance_from_bomb 1300 Hammer units Bot engineers will move if the bomb is within this range.
tf_bot_engineer_mvm_sentry_hint_bomb_backward_range 3000 Hammer units How far the MvM bot engineer can build backward.
tf_bot_engineer_mvm_sentry_hint_bomb_forward_range 0 Hammer units How far the MvM bot engineer can build forwards.
tf_bot_engineer_retaliate_range 750 Hammer units Engineer bots will attack if the attacker who destroyed sentry closer than this, otherwise the engineer bot will retreat.
tf_bot_escort_range 300 Hammer units Bots will escort anyone within this range if there are no enemies.
tf_bot_fetch_lost_flag_time 10 arbitrary float How long busy bots will ignore the dropped flag before they give up what they are doing and go after it
tf_bot_fire_weapon_allowed 1 0 disables, 1 enables If zero bots will not pull the trigger of their weapons (but will act like they did).
tf_bot_fire_weapon_min_time 1 arbitrary integer Minimum time bots will fire their weapon.
tf_bot_flag_escort_give_up_range 1000 Hammer units Bots will give up escorts at this range.
tf_bot_flag_escort_max_count 4 arbitrary integer Maximum amount of escorters allowed.
tf_bot_flag_escort_range 500 Hammer units Bots will escort the flag carrier within this range.
tf_bot_flag_kill_on_touch 0 0 disables, 1 enables If nonzero, any bot that picks up the flag dies. For testing.
tf_bot_force_class [blank by default] string If set to a class name, all bots will respawn as that class.
tf_bot_force_jump 0 0 disables, 1 enables Force bots to continuously jump.
tf_bot_formation_debug 0 0 disables, 1 enables Draw bot-formation debug info.
tf_bot_health_critical_ratio 0.3 arbitrary float Health ratio in which bots are "critically injured".
tf_bot_health_ok_ratio 0.8 arbitrary float Health ratio in which bots are considered "ok".
tf_bot_health_search_far_range 2000 Hammer units Critically-hurt bots will search for health within this range.
tf_bot_health_search_near_range 1000 Hammer units Uncritically-hurt bots will search for health within this range.
tf_bot_hitscan_range_limit 1800 Hammer units Maximum range in which bots will try to hit targets with hitscan.
tf_bot_join_after_player 1 0 disables, 1 enables If nonzero, bots wait until a player joins before entering the game.
tf_bot_keep_class_after_death 0 0 disables, 1 enables If zero bots will change class upon death, except in MvM.
tf_bot_max_grenade_launch_at_sentry_range 1500 Hammer units Demoman bots will try to launch grenades at sentries in this range.
tf_bot_max_point_defend_range 1250 Hammer units How far (in travel distance) from the point defending bots will take up positions.
tf_bot_max_setup_gate_defend_range 2000 Hammer units How far from the setup gate(s) defending bots can take up positions.
tf_bot_max_sticky_launch_at_sentry_range 1500 Hammer units Demoman bots will try to launch stickies at sentries in this range.
tf_bot_max_teleport_entrance_travel 1500 Hammer units Don't plant teleport entrances farther than this travel distance from our spawn room
tf_bot_max_teleport_exit_travel_to_point 2500 Hammer units If an offensive engineer bot's tele exit is farther from the point than this, then destroy it.
tf_bot_medic_cover_test_resolution 8 arbitrary float Determines the angular increment when scanning for players to heal.
tf_bot_medic_debug 0 0 disables, 1 enables Draw debug info for medic bots.
tf_bot_medic_max_call_response_range 1000 Hammer units Calls for medic within this range will be heard.
tf_bot_medic_max_heal_range 600 Hammer units Bot medics will heal anyone within this range.
tf_bot_medic_start_follow_range 250 Hammer units Medics will stop moving following their patients when in this range.
tf_bot_medic_stop_follow_range 75 Hammer units Medics will stop moving following their patients when in this range.
tf_bot_melee_attack_abandon_range 500 Hammer units If threat is farther away than this, bot will switch back to its primary weapon and attack
tf_bot_melee_only 0 0 disables, 1 enables If nonzero, bots will only use melee weapons
tf_bot_min_setup_gate_defend_range 750 Hammer units How close from the setup gate(s) defending bots can take up positions. Areas closer than this will be in cover to ambush.
tf_bot_min_setup_gate_sniper_defend_range 1500 Hammer units How far from the setup gate(s) a defending sniper will take up position
tf_bot_min_teleport_travel 3000 Hammer units Minimum travel distance between teleporter entrance and exit before engineer bot will build one.
tf_bot_near_point_travel_distance 750 Hammer units Range in which bots are considered to be "near" the point.
tf_bot_notice_backstab_chance 25 arbitrary integer Chance for bots to notice backstabs.
tf_bot_notice_backstab_max_range 750 Hammer units Maximum range in which bots will notice backstabs.
tf_bot_notice_backstab_min_range 100 Hammer units Minimum range in which bots will notice backstabs.
tf_bot_notice_gunfire_range 3000 Hammer units The range in which gunshots are noticed by bots.
tf_bot_notice_quiet_gunfire_range 500 Hammer units The range in which quiet gunshots are noticed by bots.
tf_bot_npc_archer_arrow_damage 75 arbitrary float Determines the arrow damage of NPC archer arrows.
tf_bot_npc_archer_health 100 arbitrary integer Determines the health of NPC archer bots.
tf_bot_npc_archer_shoot_interval 2 arbitrary float Determines the interval at which NPC archer bots fire.
tf_bot_npc_archer_speed 100 arbitrary integer Unused.
tf_bot_offense_must_push_time 120 arbitrary float If timer is less than this, bots will push hard to cap
tf_bot_offline_practice 0 arbitrary integer Tells the server that it is in offline practice mode.
tf_bot_path_lookahead_range 300 Hammer units How far a bot should look ahead.
tf_bot_payload_guard_range 1000 Hammer units Guard the payload within this range.
tf_bot_prefix_name_with_difficulty 0 0 disables, 1 enables Append the skill level of the bot to the bot's name
tf_bot_pyro_always_reflect 0 0 disables, 1 enables Pyro bots will always reflect projectiles fired at them. For tesing/debugging purposes.
tf_bot_pyro_deflect_tolerance 0.5 arbitrary float Pyro bots will not airblast if the dot product between their normalized vector and a projectile's normalized vector is higher than the negative of this value.
Todo: Simplify the explanation somehow?
tf_bot_pyro_shove_away_range 250 Hammer units If a Pyro bot's target is closer than this, then compression blast them away
tf_bot_quota 0 arbitrary integer Determines the total number of tf bots in the game.
tf_bot_quota_mode normal string Determines the type of quota. Allowed values: 'normal', 'fill', and 'match'. If 'fill', the server will adjust bots to keep N players in the game, where N is bot_quota. If 'match', the server will maintain a 1:N ratio of humans to bots, where N is bot_quota.
tf_bot_reevaluate_class_in_spawnroom 1 0 disables, 1 enables If set, bots will opportunistically switch class while in spawnrooms if their current class is no longer their first choice.
tf_bot_retreat_to_cover_range 1000 Hammer units How far to search for cover.
tf_bot_sniper_aim_error 0 Hammer units Margin of error in sniper aim radius.
tf_bot_sniper_aim_steady_rate 10 aribtrary float Determines the angle rate at which the bot aim becomes steady.
tf_bot_sniper_allow_opportunistic 1 0 disables, 1 enables If set, Sniper bots will stop on their way to their preferred lurking spot to snipe at opportunistic targets.
tf_bot_sniper_choose_target_interval 3 Seconds (float) How often a zoomed-in Sniper can reselect his target.
Note.pngNote:Currently unused.
tf_bot_sniper_flee_range 400 Hammer units Sniper bots retreat if their threat is closer than this range.
tf_bot_sniper_goal_entity_move_tolerance 500 Hammer units How far a sniper spot can be from the point before being ignored.
tf_bot_sniper_linger_time 5 arbitrary float How long Sniper will wait around after losing his target before giving up.
tf_bot_sniper_melee_range 200 Hammer units Sniper bots will attack with melee if their threat is closer than this range.
tf_bot_sniper_patience_duration 10 arbitrary float How long a Sniper bot will wait without seeing an enemy before picking a new spot.
tf_bot_sniper_personal_space_range 1000 Hammer units Enemies beyond this range don't worry Sniper bots.
tf_bot_sniper_spot_epsilon 100 Hammer units Maximum distance between sniper spots to consider them one spot.
tf_bot_sniper_spot_max_count 10 arbitrary integer Stop searching for sniper spots when each side has found this many.
tf_bot_sniper_spot_min_range 1000 Hammer units Minimum length for a sightline to be considered usable.
tf_bot_sniper_spot_point_tolerance 750 Hammer units The range in which a sniper can stand near a vantage point.
tf_bot_sniper_spot_search_count 10 arbitrary integer Search this many times per behavior update frame.
tf_bot_sniper_target_linger_duration 2 arbitrary float How long a Sniper bot will keep toward at a target it just lost sight of.
tf_bot_spawn_use_preset_roster 1 unknown Bot will choose class from a preset class table.
tf_bot_spy_change_target_range_threshold 300 Hammer units Spy bots will change to newer targets if their current target is further than this range.
tf_bot_spy_knife_range 300 Hammer units Spy Bots will prefer their knife if their threat is closer than this range.
tf_bot_squad_escort_range 500 Hammer units If a bot is using a melee weapon, close and attack with it while staying near the leader with in this range.
tf_bot_sticky_base_range 800 arbitrary integer Demoman bots will charge their stickies if their target is further than this range.
tf_bot_sticky_charge_rate 0.01 arbitrary float Seconds of charge per unit range beyond base.
tf_bot_stickybomb_density 0 arbitrary integer Number of stickies to place per square inch.
tf_bot_suicide_bomb_friendly_fire 1 0 disables, 1 enables Sentry Busters can kill ally bots on its team.
tf_bot_suicide_bomb_range 300 Hammer units Sentry Busters will kill players in this range and start detonation in a third of this value.
tf_bot_suspect_spy_forget_cooldown 5 arbitrary integer How long to consider a suspicious spy as suspicious.
tf_bot_suspect_spy_touch_interval 5 seconds (integer) How many seconds back to look for touches against suspicious spies.
tf_bot_taunt_victim_chance 20 arbitrary float 1/value chance for a bot to taunt after killing a bot.
tf_bot_teleport_build_surface_normal_limit 0 Hammer units If the ground normal Z component is less that this value, Engineer bots won't place their entrance teleporter.
tf_bot_wait_in_cover_max_time 2 arbitrary float Maximum time bots will hide in cover.
tf_bot_wait_in_cover_min_time 1 arbitrary float Minimum time bots will hide in cover.
tf_bot_mvm_show_engineer_hint_region Show the nav areas MvM engineer bots will consider when selecting sentry and teleporter hints.
Note.pngNote:Is a cheat command.

Keyvalues

TeamNum:
Initial Team (TeamNum) <choices>
Which Team the entity belongs / is assigned to on spawn
  • 0: None
  • 1: Spectator/Halloween Souls Team Fortress 2
  • 2: RED Team Fortress 2
  • 3: BLU/Robots Team Fortress 2
  • 5: Halloween Bosses (only in Team Fortress 2) !FGD
Note.pngNote:Content moved to Rendering and studio model related KIO/Keyvalues for continuation of page history


Inputs

IgnitePlayer <integerRedirectInput/integer>
Team Fortress 2 Ignites the entity with a specified lifetime and causes a reaction (sound and speech).
ExtinguishPlayer
Team Fortress 2 Extinguishes the entity.
BleedPlayer <integerRedirectInput/integer>
Team Fortress 2 Bleeds the entity with a specified length.
RollRareSpell
Team Fortress 2 Forces the entity to roll a rare spell. Only available if spells are enabled on the map.
SetCustomModel <stringRedirectInput/string>
Team Fortress 2 Set a custom entity model without animations.
SetCustomModelOffset <vectorRedirectInput/Vector>
Team Fortress 2 Set a custom model position on the entity.
SetCustomModelRotation <vectorRedirectInput/Vector>
Team Fortress 2 Set a custom model rotation on the entity.
ClearCustomModelRotation
Team Fortress 2 Clears the custom model rotation.
SetCustomModelRotates <booleanRedirectInput/boolean>
Team Fortress 2 Set if the custom model rotates or not to the entity's angles.
SetCustomModelVisibleToSelf <booleanRedirectInput/boolean>
Team Fortress 2 Set if the custom model is visible to the entity, in thirdperson.
SetForcedTauntCam <booleanRedirectInput/boolean>
Team Fortress 2 Forces the player into thirdperson mode.
SpeakResponseConcept <stringRedirectInput/string>
Team Fortress 2 Forces the player to speak the specified response concept, an example being halloweenlongfall.
TriggerLootIslandAchievement
Team Fortress 2 [Todo].
TriggerLootIslandAchievement2
Team Fortress 2 [Todo].
RoundSpawn
Team Fortress 2 [Todo].
SetTeam <integerRedirectInput/integer>
Changes the entity's team.

CBaseCombatCharacter:

KilledNPC  !FGD
Tells the entity it killed something. Despite the name, this can include a player. This input will be automatically sent by the victim when they die.
physdamagescale <floatRedirectInput/float>
Scales damage energy when this character is hit by a physics object. With a value of 0 the NPC will take no damage from physics.
Note.pngNote:Content moved to Rendering and studio model related KIO/Inputs for continuation of page history


Outputs

Note.pngNote:Content moved to Rendering and studio model related KIO/Outputs for continuation of page history


See Also

TFBot skill levels explained in excruciating detail - By Sigsegv
MvM - Advanced Popfile Techniques - By Mince and 8 other collaborators

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Tf_bot&oldid=243557"