Quickchat (Slash Command): Difference between revisions

From Homecoming Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 51: Line 51:


===LockedOption syntax:===
===LockedOption syntax:===
LockedOption is alternative to the Option syntax above and checks to see if an item is available given current conditions. If unavailable, the option will be grayed out and unavailable.  
LockedOption is alternative to the Option syntax above and checks to see if an item is available given current conditions. If the condition is not met, the option will be grayed out and unavailable.  
  LockedOption
  LockedOption
  {
  {
Line 62: Line 62:
  }
  }


That condition under which the item is available is specified with either Authbit, Badge, RewardToken, or StoreProduct. You only need one, but you can use multiple.
That conditions under which the item is available is specified with either Authbit, Badge, RewardToken, or StoreProduct. You only need one, but you can use multiple.


* '''Authbit''' checks some state of your account (mostly historical and does not apply to Homecoming):
* '''Authbit''' checks some state of your account (mostly historical and doesn't apply to Homecoming):
** RogueAccess: Purchased Going Rogue
** RogueAccess: Purchased Going Rogue
** RogueCompleteBox: Purchased Going Rogue Complete Collection
** RogueCompleteBox: Purchased Going Rogue Complete Collection

Revision as of 19:24, 4 December 2022

SlashCommand

/quickchat  

Pops up the quickchat menu.

Customizing the QuickChat Menu

Custom Quickchat Menus can be created by placing a properly formatted text file named quickchat.mnu in the following directory and then restarting COH after completely exiting to the desktop:

<COH_INSTALL_DIRECTORY>\data\texts\<LANGUAGE>\Menus\

<LANGUAGE> may be one of the following and needs to match the language of the version of City of Heroes that is installed:

  • ChineseTraditional
  • English
  • French
  • German
  • Japanese
  • Korean
  • uk

Syntax

MNU files can be created and edited in any text editor. QuickChat Menus have the following general structure:

// Opening comment line for the QuickChat Menu

Menu QuickChat
{
    Title TitleName
    Option OptionName Command
    Divider
    Title TitleName
    Option OptionName Command
    Menu SubMenuName
    {
        Title SubMenuTitleName
        Option OptionName Command
        Divider
        Option OptionName Command
    }
}
  • Menu defines a group of Options. Menus can be nested, but each sub-menu requires its own pair of curly braces.
    • To create a submenu name of more than one word with spaces between them, enclose it in quotes.
  • Option is a selectable command within a menu.
    • One letter in OptionName can be designated as a hotkey by prefixing an ampersand (&).
    • To create an option name of more than one word with spaces between them, enclose it in quotes.
    • Command is one or more slash commands (separated by $$).
  • Title is an optional element.
    • TitleName labels a menu, or a section of a menu. Titles are not selectable.
    • Menus can have more than one Title.
  • Divider places a horizontal line in the menu.


LockedOption syntax:

LockedOption is alternative to the Option syntax above and checks to see if an item is available given current conditions. If the condition is not met, the option will be grayed out and unavailable.

LockedOption
{
DisplayName OptionName
Command OptionCommand
Authbit AuthIdentifiers
Badge BadgeIdentifiers
RewardToken RewardIdentifiers
StoreProduct ProductIdentifiers
}

That conditions under which the item is available is specified with either Authbit, Badge, RewardToken, or StoreProduct. You only need one, but you can use multiple.

  • Authbit checks some state of your account (mostly historical and doesn't apply to Homecoming):
    • RogueAccess: Purchased Going Rogue
    • RogueCompleteBox: Purchased Going Rogue Complete Collection
    • CyborgPack: Purchased Super Booster I: Cyborg
    • MagicPack: Purchased Super Booster II: Magic
    • SuperSciencePack: Purchased Super Booster III: Superscience
    • MutantPack: Purchased Super Booster IV: Mutant
    • MartialArtsPack: Purchased Super Booster V: Martial Arts
    • WeddingPack: Puchased the Wedding Pack
  • Badge checks whether you've earned a certain badge. For example:
    • CouncilRobotBadge: Burkholder's Bane
    • StMartialTour1: Johnny's Go To Guy
    • SnowflakeEmoteBadge: Invisible badge gained from the Candy Keeper during the Winter Event
    • MayhemOutlaw: Outlaw
    • ArchitectAccolade: Mission Engineer
  • RewardToken checks that you've earned a specific reward
  • StoreProduct checks against a purchase in the store (also mostly historical).



Notes

  • MNU files allow comments. Use a double forward slash (//) anywhere on a line to force the client to ignore anything between the double slash and the line return.
  • IMPORTANT: MNU files must have at least one line containing a carriage-return at the end of the line above the first "Menu" entry. It can be blank, a full comment, or just the comment tag (//) or any number of those lines otherwise it will not function.
  • Changes to custom menus require you to exit the client in order for the changes to take effect.
  • Custom menus are accessible by all characters on the same machine. By extension, you can send custom menu files to other people so that they can use them as well.
  • Option and its parameters must be on one line. Otherwise, the menu will not function.
    • Inspiration and power names with spaces can be used in commands by replacing the spaces with an underscore (for example, Catch_a_Breath). You can also enclose the entire Command portion in quotation marks.
    • Multiple Commands can be executed by one Option by joining them with $$, just as they would be on the client command line.
  • Listing multiple identifiers for any of the checks produces a logical OR: Badge CouncilRobotBadge StMartialTour1 means "Burkholder's Bane badge OR Johnny's Go To Guy badge".

See Also


External Links