game_player_equip Last edited 2 years ago2020-04-01 23:08:17 UTC

game_player_equip - Point Entity

The game_player_equip entity allows you to provide the player with specific items when it is triggered. In deathmatch games, this entity can also be used to give items to players upon spawning.

Attributes

• Name (targetname) - Name is a general attribute used to identify entities.
• Team Master (master) - This can be used to limit which team (in a deathmatch game) can receive the items. Takes the name of a game_team_master.

Flags

• Use Only (1) - If enabled, only triggering the game_player_equip will cause it to dispense items. This will prevent items being given upon spawning in a deathmatch game. Only the player who caused the trigger will receive items.

Notes

• To specify what items you want the game_player_equip to dispense, you must turn Smart Edit mode off and add attributes. Enter the item's name as the key, and how many of that item you want to give as the value. For example, a key of "weapon_handgrenade" with a value of "2" will equip the player with 10 grenades (as each weapon_handgrenade gives 5 grenades).
• In Singleplayer mode, this entity will only work if it's activated manually by the player with "Use Only" enabled.
• The engine crashes if it's triggered involuntarily (via trigger_auto) unless "Use Only" is disabled.
• This entity is not limited to weapons. Weapons, ammo, and items can all be used, including item_battery and item_healthkit.
  • In fact, other entities will work as well, including monsters. As you don't have a way to trigger or specify the properties of these entities, using a game_player_equip in that way is likely not useful, but it's worth noting that it is possible.
• The items dispensed are not given directly to the player's inventory — the items are, in fact, spawned on top of the player. Generally, the effect is the same, but it should be noted that if a player is at full capacity for a particular item, the player will not pick up an item of that type when it is spawned. If not used carefully, this could result in items being strewn around the map in an untidy and possibly unbalancing manner.