24.3.13 Customized Messages

Some artifacts can have their messages customized using the CONFIG ARTIFACTMSG command (which is only available if you own an artifact that can be customized).

The following global guidelines apply to all customized messages:
 - Customized messages must follow normal language rules
 - Customized messages should fit in-character. Don't submit out-of-character inside jokes, things that don't fit the theme and roles in Imperian, etc

SPECIAL STRINGS (message variables)
Messages can include a set of special strings that can be used in your messages, which will be replaced by the appropriate values when the message is used. You can add a + between $ and (, to capitalise the first letter of that word, so that it will display correctly. For example, $+(he$) would show He or She, but $(he$) would show he or she. It is important to do this at the beginning of sentences, or anywhere else capitalization is required.

The following strings exist. Each section below will note which of these strings they support.
$(caster$)                - This is the person doing the movement,
                            performing the attack, etc
$(name$)                  - Like caster, but used instead of it in emotes.
$(his$)/$(him$)/$(he$)    - Gender specific pronouns for the caster.
$(target$)                - This is the person being killed (for deathsight).
$(lname$)                 - Like target, but used instead of it in emotes.
$(lhis$)/$(lhim$)/$(lhe$) - Gender specific pronouns for the target.
$(enter_direction$)       - The direction from which caster is entering
$(leave_direction$)       - The direction to which caster is leaving.
$(altar$)                 - Specific to Altar of Sanctity messages, the altar being used
$(corpses$)               - Specific to Altar of Sanctity messages, the corpses being sacrificed


MOVEMENT
--------
Movement messages (including those from the Phantasmic Diadem and customized Earrings of Gazalis) can use the following special strings: caster, caster-specific pronouns, enter_direction, leave_direction

We currently have the following guidelines for submitted deathsight messages:
- All of the global guidelines listed above.
- ENTER and LEAVE messages *must* contain the caster's name. They are not required to include the direction.


DEATHGLORY
----------
Purchasing a Deathglory Orb allows you to create and use custom deathsight messages, which will be used when you kill other players.

To submit, modify, save, or switch messages, use CONFIG DEATHSIGHT (which is only available if you own a Deathglory Orb)

Deathsight messages can use the following special strings: caster, caster-specific pronouns, target, target-specific pronouns.

We currently have the following guidelines for submitted deathsight messages:
- All of the global guidelines listed above.
- Deathsight messages must include both the caster and the target.
- Deathsight messages may not directly reference the viewer (don't use words like "you" and "your").
- If your message is deemed to be offensive to a particular group, it will not be approved.
- Deathsight messages must be no longer than 80 characters.


PORTAL WANDS
------------
Portal wands can be customized using CONFIG ARTIFACTMSG. 

The start1p and start3p message type can use: caster, caster-specific pronouns, target, target-specific pronouns

The other message types should not use any special strings.

We currently have the following guidelines for submitted portal wand messages:
- All of the global guidelines listed above.


ALTARS OF SANCTITY
------------------
Altars of Sanctity can be customized using CONFIG ARTIFACTMSG. 

Both message types can use the following special strings: corpses, altar

The sacrifice3p message should ALSO use: caster, caster-specific pronouns

We currently have the following guidelines for submitted portal wand messages:
- All of the global guidelines listed above.
- Both messages MUST use the special corpses and altar strings.
- sacrifice3p MUST mention the caster.


EMOTE TOKENS
------------
Turning in an Emote Token (HELP PROMO) allows you to create a custom balance-free emote. This emote is only available to you.

To modify and submit your emote, use PROMOTOKEN EMOTE.

Emote messages can use the following special strings:
name, caster-specific pronouns, lname, target-specific pronouns.

We currently have the following guidelines for submitted emote messages:
 - All of the global guidelines listed above.
 - Submitted emotes should not be sexual in nature.