documented "say" escapes
[divverent/nexuiz.git] / Docs / say-escapes.txt
1 In a message you "say", you can use the following escapes:
2
3 %%        literal percent sign
4 %a        current armor value
5 %h        current health
6 %w        current weapon
7 %W        current ammo type
8
9 %x        name of entity pointed at
10
11 %l        current location
12 %y        location pointed at
13 %d        location last died at
14
15 The latter three need location data or use nearby weapons instead. Location
16 data are entities of type target_location with a netname that replaces the
17 escape.
18
19 The location entity for a point is chosen by the following algorithm:
20
21 - the closest four entities are found
22 - of these, the first one which is actually VISIBLE to the point is chosen
23 - if there is no line of sight from the point to any of the four location
24   entities, the closest one is chosen
25
26 Of course you can use these escapes in key bindings and aliases; examples:
27
28 alias asay_ctf_flagcarrier "say_team flag carrier at %y"
29 alias asay_ctf_haveflag "say_team (%l) have the flag"
30 alias asay_willgo "say_team will go to %y"
31 alias asay_support "say_team (%l) need help, %h%%"
32 alias asay_killed "say_team got killed at %d"
33 alias asay_noammo "say_team (%l) need %W for %w"
34 alias asay_drop "say_team (%l) dropped %w ; impulse 17"