Debug Commands

Mapbase changes existing debug console commands and also has its own. These commands are supposed to assist in debugging problems and/or messing around with cheats.

Changes to existing commands

ent_fire

ent_fire is an existing command that could fire an input on an entity, or a number of entities. The syntax is ent_fire <target> <input> <optional: parameter> <optional: delay>.

ent_fire includes an "auto-completion" lookup for entities in the map and inputs on an entity, but the entity lookup is not used for classnames by default. ent_fire still works with classnames, but it won't auto-complete. Mapbase adds auto-completion for classnames so they show up as well as targetnames.

There was also an oversight with the delay parameter that prevented decimals from being used. This has been fixed in Mapbase.

ent_teleport, ent_text

ent_teleport and ent_text are existing commands that do two completely separate things. ent_teleport teleports a named entity to a location and ent_text shows debug information on an entity in developer mode.

Both support looking through the entity list, but they didn't have auto-completion like ent_fire does. Mapbase gives them the same entity list auto-completion function as ent_fire, which is extremely useful if you use the commands often.

ent_create, npc_create, etc.

ent_create is an existing command that could create an entity where a player is looking. npc_create is a similar existing command that could create a NPC where the player is looking, using a hull check to make sure the NPC could fit in the position.

Mapbase adds auto-completion to both commands, searching through the entity factory list and allowing the commands to auto-complete based on spawnable entity classes. npc_create's auto-completion only shows entities prefixed with npc_ by default.

npc_create_aimed is an existing command identical to npc_create, except it spawns the NPC facing away from the player that spawned it. Mapbase also adds ent_create_aimed, a new command equivalent to npc_create_aimed, except for ent_create. Both commands use the same auto-completion changes mentioned above.

npc_select, etc.

npc_select is an existing command that lets NPCs get "selected" for debugging purposes, such as to make them perform special actions or print additional information to the console.

Using npc_select alone just gets the entity the player is looking at, which is standard practice, but a name can be passed as well. However, by default, this does not have auto-completion like ent_fire does.

There are 9 other existing AI debugging commands with similar look-at-by-default-but-accept-names behavior:

• npc_nearest
• npc_route
• npc_combat
• npc_tasks
• npc_task_text
• npc_conditions
• npc_viewcone
• npc_relationships
• npc_steering

Mapbase adds auto-completion to npc_select and these related commands. They will search the entity list like ent_fire does, but they'll only show NPC-derived entities.