Badge time.png   The Paragon Wiki Archive documents the state of City of Heroes/Villains as it existed on December 1, 2012.

Difference between revisions of "Macro (Slash Command)"

From Paragon Wiki Archive
Jump to: navigation, search
(Expanded the article some)
m
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
{{TOCright}}
 +
{{SlashCommandArticle
 +
|command=macro
 +
|options=name "command"
 +
|note=''name'' should be replaced with a character string to describe the macro, such as ''GO'' or ''Cheer''.
 +
 +
''command'' should be one or more [[Slash Commands]].  The "" (quotation) marks are not required, except around the ''command'' parameter when using more than one command.}}
 +
{{clr}}
 
== Introduction to Macro Commands ==
 
== Introduction to Macro Commands ==
  
 
Macros in City of Heroes/Villains are an excellent way to bind frequently used powers, actions, or text in a simple button, just like any power button. Macros are very flexible, making for a near endless variety of options. But, macros are ''not'' a way to set up complex attack chains. Checking this guide, as well as some helpful links, hopefully you, too, can master this medium of control.
 
Macros in City of Heroes/Villains are an excellent way to bind frequently used powers, actions, or text in a simple button, just like any power button. Macros are very flexible, making for a near endless variety of options. But, macros are ''not'' a way to set up complex attack chains. Checking this guide, as well as some helpful links, hopefully you, too, can master this medium of control.
 
== Macro Basics ==
 
 
A basic description of the macro command is as follows:
 
 
:'''/Macro "<Macro Name>" "<Command>"'''
 
 
'''<Macro Name>''' should be replaced with a a character string to describe the macro, such as ''GO'' or ''Cheer''.  '''<Command>''' should be one or more [[slash commands]].  The "" (quotation) marks are not required, except around the '''<Command>''' parameter when using more than one command.
 
  
 
==== Names and Icons ====
 
==== Names and Icons ====
  
Names can be anything you wish, although only a limited amount of text can be shown in the macro icon. However, the full text always appears in tooltips. The icon appears as a generic grey button with your text overlaid. After creating a macro, the name cannot be changed, although the command string may be edited.
+
Names can be anything you wish, although only a limited amount of text can be shown in the macro icon. However, the full text always appears in tooltips. The icon appears as a generic grey button with your text overlaid. After creating a macro, the name cannot be changed, although the command string may be edited by right clicking the icon and selecting "Edit".
  
Alternatively, pet command icons can be used. In this case, the name of the original pet command will show up in tooltips. To use this trick as a character without pets, begin in a gladiator match. When using the pet command window, you can drag the icons to your power tray, which can then be edited as macros.
+
Alternatively, pet command icons can be used. In this case, the name of the original pet command will show up in tooltips. To use this trick as a character without pets, begin in a [[gladiator]] match at the [[Arena]]. When using the pet command window (turn this on in [[The Players' Guide to the Cities/User Interface/Options Window|options]] if you don't already have it), you can drag the icons to your power tray and then edit it the same as a grey-icon macro.
  
 
==== Commands ====
 
==== Commands ====
  
Anything that can be used as a slash command can be bound as a macro. To look in game, almost every command is listed when using the ''/cmdlist'' command. Remember that when binding or macroing commands, the slash is assumed, and not used. Also, to separate multiple commands, use two dollar signs <'''$$'''>.
+
Anything that can be used as a [[Slash Commands|slash command]] can be bound as a macro. Remember that when binding or macroing commands, the slash is assumed, and not typed out. To utilize multiple commands using one macro, type two dollar signs <'''$$'''> between the commands.
  
For a more detailed explanation, please read [[The Incomplete and Unofficial Guide to /bind]]. Everything in that article concerning slash commands applies to macros as well.
+
For a more detailed explanation, please read [[The Incomplete and Unofficial Guide to /bind]]. Everything in that article concerning slash commands applies to macros as well.
  
 
== Creating a Macro ==
 
== Creating a Macro ==
  
 
For this example, we will create an elaborate macro that will
 
For this example, we will create an elaborate macro that will
* Invite a targeted player to your supergroup
+
* Use an [[emote]], "bowdown"
* Congratulate your new member
+
* Say something in [[local]]
* Announce to your supergroup that someone has joined
+
* [[powexec name (Slash Command)|Activate]] a power, Domination
* Use a power
+
* Change [[costumes]] to slot three
  
:'''/macro "SGI" "sgi $target$$yell Congratulations to $target on joining the Noob Squad!!$$sg Everyone please welcome $target to the group!$$powexec_name inferno"'''
+
:<code>/macro dom "{{bindcommand|emote}} bowdown$${{bindcommand|local}} You're making me mad!$${{bindcommand|powexec_name}} domination$${{bindcommand|cc}} 2"</code>
  
Using simple commands, you can create a long sting of actions. However, take care creating these, as editing complexe macros can be difficult.
+
Using simple commands, you can create a long string of actions. However, take care creating these, as editing complex macros can be difficult.
  
== Additional Examples ==
+
=== Additional Examples ===
  
 
All of the following are valid uses of the /macro.
 
All of the following are valid uses of the /macro.
  
:'''/macro "GO" "local Let's go, team!"'''
+
<code>/macro GO {{bindcommand|local}} Let's go, team!</code>
Creates a macro labelled ''GO'' that causes the character to say "Let's go team!" on the local channel.
+
: Note the lack of quotation marks: There is only one command, so they are unnecessary.
 +
 
 +
: Creates a macro labeled ''GO'' that causes the character to say "Let's go team!" on the local channel.
 +
 
 +
<code>/macro SG "{{bindcommand|sgmode}}"</code>
 +
:Note the quotation marks: Even if there is only one command, you can still use quotes to enclose the command.
 +
 
 +
:Creates a button for your power tray that toggles [[SG mode]] on and off.
 +
 
 +
<code>/macro getfunky "{{bindcommand|petsay_all}} <nowiki><em dance></nowiki>"</code>
 +
:This macro will cause all of a [[Mastermind]]'s pets to perform random dance emotes.  The full name will not display on the icon, but the tooltip will show the complete label.
  
:'''/macro SG "sgmode"'''
+
<code>/macro TP "{{bindcommand|team}} Bringing $target close to me!$${{bindcommand|powexec_name}} [[Teleportation#Recall Friend|recall friend]]"</code>
Creates a button for your power tray that toggles [[SG mode]] on and off.
+
:Creates a macro called ''TP''.  It will cause your character to name their current target on the team channel and use the recall friend power aimed at this target.
  
:'''/macro getfunky [[Petsay all (Slash Command)|petsay_all]] <nowiki><em dance></nowiki>'''
+
<code>/Macro Slappy "{{bindcommand|e}} slap$${{bindcommand|e}} smack"</code>
This macro will cause all of a [[Mastermind]]'s pets to perform the dance emote.  The full name will not display on the icon, but the tooltip will show the complete label.
+
:Note the quotation marks: There are two commands, so they ''must'' be enclosed in quotes.
  
:'''/macro "TP" "team Bringing $target close to me!$$pow_exec_name recall friend"'''
+
:Only one animation can be triggered by a single use of a macro, but in certain combinations, a macro like this will alternate between emotes as you activate the macro over and over. In this case, you will alternate between backhand and fronthand slaps. Most combinations of emotes will not work this way. Those combinations which do work are usually very closely related.
Creates a macro called ''TP''.  It will cause your character to name their current target on the team channel and use the recall friend power aimed at this target.
+
  
== Other Recourses ==
+
<code>/macro Bat "{{bindcommand|e}} batsmash$${{bindcommand|powexec_name}} [[Inherent Powers#Brawl|Brawl]]"</code>
 +
:In this case, an emote animation is coming into conflict with a power animation. There are very few powers in the game whose animations can be overwritten by an emote. It requires trial and error to find out if a power can be overwritten. What will happen in the case of this example is that the batsmash animation will play if the Brawl power is not ready or if you have no target, but if Brawl is ready and you have a valid target in range, you will see the Brawl animation and not the batsmash animation.
  
* [[Slash_Commands|Command List]]
+
{{Navbox Binds}}
* [[Bind (Slash Command)|/bind]]
+
* [[The Incomplete and Unofficial Guide to /bind]]
+
  
 
[[Category:Slash Commands]]
 
[[Category:Slash Commands]]

Latest revision as of 09:37, 8 July 2012

/macro name "command"

name should be replaced with a character string to describe the macro, such as GO or Cheer.

command should be one or more Slash Commands. The "" (quotation) marks are not required, except around the command parameter when using more than one command.

Introduction to Macro Commands

Macros in City of Heroes/Villains are an excellent way to bind frequently used powers, actions, or text in a simple button, just like any power button. Macros are very flexible, making for a near endless variety of options. But, macros are not a way to set up complex attack chains. Checking this guide, as well as some helpful links, hopefully you, too, can master this medium of control.

Names and Icons

Names can be anything you wish, although only a limited amount of text can be shown in the macro icon. However, the full text always appears in tooltips. The icon appears as a generic grey button with your text overlaid. After creating a macro, the name cannot be changed, although the command string may be edited by right clicking the icon and selecting "Edit".

Alternatively, pet command icons can be used. In this case, the name of the original pet command will show up in tooltips. To use this trick as a character without pets, begin in a gladiator match at the Arena. When using the pet command window (turn this on in options if you don't already have it), you can drag the icons to your power tray and then edit it the same as a grey-icon macro.

Commands

Anything that can be used as a slash command can be bound as a macro. Remember that when binding or macroing commands, the slash is assumed, and not typed out. To utilize multiple commands using one macro, type two dollar signs <$$> between the commands.

For a more detailed explanation, please read The Incomplete and Unofficial Guide to /bind. Everything in that article concerning slash commands applies to macros as well.

Creating a Macro

For this example, we will create an elaborate macro that will

/macro dom "emote bowdown$$local You're making me mad!$$powexec_name domination$$cc 2"

Using simple commands, you can create a long string of actions. However, take care creating these, as editing complex macros can be difficult.

Additional Examples

All of the following are valid uses of the /macro.

/macro GO local Let's go, team!

Note the lack of quotation marks: There is only one command, so they are unnecessary.
Creates a macro labeled GO that causes the character to say "Let's go team!" on the local channel.

/macro SG "sgmode"

Note the quotation marks: Even if there is only one command, you can still use quotes to enclose the command.
Creates a button for your power tray that toggles SG mode on and off.

/macro getfunky "petsay_all <em dance>"

This macro will cause all of a Mastermind's pets to perform random dance emotes. The full name will not display on the icon, but the tooltip will show the complete label.

/macro TP "team Bringing $target close to me!$$powexec_name recall friend"

Creates a macro called TP. It will cause your character to name their current target on the team channel and use the recall friend power aimed at this target.

/Macro Slappy "e slap$$e smack"

Note the quotation marks: There are two commands, so they must be enclosed in quotes.
Only one animation can be triggered by a single use of a macro, but in certain combinations, a macro like this will alternate between emotes as you activate the macro over and over. In this case, you will alternate between backhand and fronthand slaps. Most combinations of emotes will not work this way. Those combinations which do work are usually very closely related.

/macro Bat "e batsmash$$powexec_name Brawl"

In this case, an emote animation is coming into conflict with a power animation. There are very few powers in the game whose animations can be overwritten by an emote. It requires trial and error to find out if a power can be overwritten. What will happen in the case of this example is that the batsmash animation will play if the Brawl power is not ready or if you have no target, but if Brawl is ready and you have a valid target in range, you will see the Brawl animation and not the batsmash animation.