Skip to content

/caption

Syntax

/caption list | update # | MQCaptions [on|off] | reload | type value

Description

Customize spawn captions (names, titles, linkdead, etc.). You can also limit how many captions are processed to improve performance.

Options

  • list - List custom captions
  • reload - Update captions from .ini
  • Update - The number of nearest spawns which will have their caption updated each pass. The default is 35.
  • MQCaptions [on|off] - Turns captions on or off
  • The anon option has been deprecated, please use /mqanon instead
  • type value - The spawn type and the value for its caption. Available types are:
Type Description
Player1-6 Player captions for /shownames 1-6
Pet Pet captions
Merc Mercenary captions
NPC NPC captions
Corpse Corpse captions

Examples

Default captions can be overriden in the [Captions] section of your MacroQuest.ini file. 

[Captions]
# Player1 (basic), /shownames 1
Player1=${If[${NamingSpawn.Mark},${NamingSpawn.Mark} - ,]}${If[${NamingSpawn.Trader},Trader ,]}${If[${NamingSpawn.Invis},(${NamingSpawn.DisplayName}),${NamingSpawn.DisplayName}]}${If[${NamingSpawn.AFK}, AFK,]}${If[${NamingSpawn.Linkdead}, LD,]}${If[${NamingSpawn.LFG}, LFG,]}${If[${NamingSpawn.GroupLeader}, LDR,]}

# Player3 (with guild), /shownames 3
Player3=${If[${NamingSpawn.Mark},${NamingSpawn.Mark} - ,]}${If[${NamingSpawn.Trader},Trader ,]}${If[${NamingSpawn.Invis},(${NamingSpawn.DisplayName}),${NamingSpawn.DisplayName}]}${If[${NamingSpawn.Surname.Length}, ${NamingSpawn.Surname},]}${If[${NamingSpawn.AFK}, AFK,]}${If[${NamingSpawn.Linkdead}, LD,]}${If[${NamingSpawn.LFG}, LFG,]}${If[${NamingSpawn.GroupLeader}, LDR,]}${If[${NamingSpawn.Guild.Length},\n<${NamingSpawn.Guild}>,]}

# NPC
NPC=${If[${NamingSpawn.Mark},${NamingSpawn.Mark} - ,]}${If[${NamingSpawn.Assist},>> ,]}${NamingSpawn.DisplayName}${If[${NamingSpawn.Assist}, - ${NamingSpawn.PctHPs}%<<,]}${If[${NamingSpawn.Surname.Length},\n(${NamingSpawn.Surname}),]}

# Corpse
Corpse=${NamingSpawn.DisplayName}'s corpse
  • NamingSpawn is an internal TLO, so it's not documented along with other TLOs since it will always return NULL outside of caption processing. It inherits all spawn members. (e.g., DisplayName from ${NamingSpawn.DisplayName} is a spawn member.)
  • Use \n to add a new line when setting captions
  • To set a caption in-game, 
    /caption Corpse ${NamingSpawn.DisplayName}'s corpse
  • To revert to the default, you can delete the [Captions] section of your MacroQuest.ini file or clear the specific type with an empty value command like so, 
    /caption Corpse

See Also