Garry's Mod Documentation

You can customize TTT without modifying the core gamemode code. The recommended way to add content is by creating scripted weapons (SWEPs).

• Custom Weapons: You can add your own scripted weapons independently. To learn how, refer to the GMod wiki regarding SWEPs.
• Reference Implementation: You can find the scripts for standard TTT weapons in: \gamemodes\terrortown\entities\weapons\.
• Base Class: The weapon_tttbase script contains documentation that is useful for creating TTT-compatible weapons.
• Hooks: TTT provides various hooks for customization. Detailed information is available at http://ttt.badking.net/.

If you are using a version of TTT included with Garry's Mod, no installation is required. If you have a .zip version of the gamemode, extract the contents into your Garry's Mod directory so that the path errorTown exists within the gamemodes folder.

For local installation: X:\Steam\steamapps\common\garrysmod\garrysmod\

For dedicated server (srcds) installation: X:\srcds\orangebox\garrysmod\

Use the dedicated issue and request trackers to communicate with the development team:

• Bugs: Report issues via the Garry's Mod Issue tracker.
• Features: Submit feature requests via the Garry's Mod Request tracker.

An activator filter is a BaseFilter used to test whether an entity (the activator) meets specific criteria. Filters can be configured in two modes via the Negated(choices) property:

• Allow (0): Only entities matching the criteria pass.
• Disallow (1): Only entities that do NOT match the criteria pass.

To test an entity, use the input TestActivator(void) command. This will trigger either the output OnPass(void) or output OnFail(void) based on the result.

You can build complex logic using filter_multi, which combines multiple sub-filters using either AND (all must pass) or OR (any must pass) logic.

The func_instance_io_proxy allows entities inside an instance to communicate with entities outside the instance.

1. Place a func_instance_io_proxy inside the instance.
2. Entities inside the instance send a ProxyRelay message to the proxy.
3. The proxy then triggers its OnProxyRelay output, which can be used to trigger entities outside the instance.

// Inputs
input ProxyRelay(string) : "This message will get relayed and will be available from the instance."

// Outputs
output OnProxyRelay(void) : "A message from outside can trigger this to cause something to happen in the instance."

To create repeatable objects or groups of entities, use a combination of point_template and env_entity_maker.

1. Define the Template (point_template)

Group your entities and add a point_template. When instantiated, the template automatically renames its internal entities (e.g., original_name&0000) and reconnects their I/O to ensure they function correctly as independent instances.

2. Spawn the Template (env_entity_maker)

Place an env_entity_maker where you want the template to appear. Set the EntityTemplate key to the name of your point_template.

Key env_entity_maker Spawnflags

• 1: Enable AutoSpawn (spawns when there is room and the player is looking elsewhere).
• 4: AutoSpawn even if the player is looking.
• 8: ForceSpawn only if there is room.
• 16: ForceSpawn only if the player is NOT looking.

The func_instance entity allows you to place an instance of a map file. You can translate, rotate, and use replacement parameters to modify the contents of the instance.

To pass values into an instance, use the $variable syntax within the instance's key/value pairs. The func_instance then uses its replace keys to substitute those variables with specific values.

Use navigation entities to control how bots move through your map.

Block Navigation

• func_nav_blocker: A brush entity that blocks nav areas touching its AABB. Use input BlockNav(string) to start blocking and input UnblockNav(void) to stop.
• func_nav_avoidance_obstacle: A brush entity that tells bots to avoid nav areas touching its AABB.

Influence Navigation Cost

• func_nav_avoid: Increases pathfinding cost to make bots avoid a region.
• func_nav_prefer: Decreases pathfinding cost to make bots prefer a region.

Common Properties for Influence Entities:

• tags(string): A space-delimited list of labels (e.g., bomb_carrier, common, mission_sniper). Bots with matching tags will react to the entity.
• team(choices): Which team is affected (-2 for Everyone, 0 for Team 0, 1 for Team 1).