Action Messages

All functions accept mixed msg — either a string template or an array of strings (one is chosen randomly via element_of()).

Token Reference

$N / $n — Actor Name

The doer of the action. Defaults to who[0].

• Uppercase $N capitalises the result; lowercase $n does not
• First mention uses the name; subsequent mentions use pronouns
• Gender-based via query_gender(): returns "male", "female", "other"

$V / $v — Verb Conjugation

Conjugates a verb based on perspective.

Rules:

• Actor always gets the base form: "swing", "grab"
• Others get pluralize(verb): "swings", "grabs" (third-person singular)
• "to be" special case: $vis, $vam, $vare → "are" for actor, "is" for others
• Gender "other" also gets "are" (plural agreement)
• Contraction hack: $vdon't works — the system detects 't after the verb and appends it

Uppercase $V capitalises the conjugated result.

$T / $t — Target Name

The target of the action. Defaults to who[1] with objective suffix.

Same pronoun logic as $N but defaults to participant 1 (the target) and objective case.

$O / $o — Object

References objects from the obs... arguments.

Article handling: The system detects articles in the text before $o and adjusts:

• On second mention of the same object: replaced with "it"
• Arrays of objects: handled automatically with pluralisation and simple_list()
  • "a $o" with 3 swords → "3 swords"
  • Mixed arrays → "3 swords and a shield"
  • Second mention of array → "them"

$P / $p — Possessive Pronoun

$R / $r — Reflexive Pronoun

$B / $b — Base Pronoun (Hybrid)

Like $N but uses objective pronouns on subsequent mentions.

Numeric Indices

Tokens can reference specific participants by number:

• $n0 — who[0] (the actor, same as $n)
• $n1 — who[1] (the target in targetted actions)
• $v1swing — conjugate "swing" for who[1]'s perspective
• $p1 — possessive of who[1]

The format is: $[TYPE][PARTICIPANT_NUMBER][SUFFIX]

For two-digit parsing: $[TYPE][SUBJECT_NUMBER][PARTICIPANT_NUMBER][SUFFIX] — subject determines reflexive detection, participant determines which person.

Reflexive Handling

When the subject and participant are the same person and the subject has already been mentioned, reflexive pronouns are used automatically:

"$N $vkick $No"
// Actor: "You kick yourself."     (not "You kick you.")
// Others: "Bob kicks himself."    (not "Bob kicks Bob.")

This only triggers when both reference the same who[] entry and the subject has been previously mentioned in the message.

Message Routing Detail

simple_action

Actor ← compose_message(actor, msg, who, obs)
Actor's inventory ← compose_message(null, msg, who, obs)
Room (excluding actor) ← compose_message(null, msg, who, obs)

targetted_action

Actor ← compose_message(actor, msg, who, obs)
Target ← compose_message(target, msg, who, obs)
Actor's inventory ← compose_message(null, msg, who, obs)
Target's inventory ← compose_message(null, msg, who, obs)
Room (excluding actor and target) ← compose_message(null, msg, who, obs)

When forwhom is null (the "others" perspective), no participant matches, so all names are used with third-person conjugation.

Practical Examples

Basic action

tp->simple_action("$N $vdrop $p $o.", item);
// Actor: "You drop your sword."
// Others: "Bob drops his sword."

Failure message (actor only)

tp->my_action("$N $vcannot drop $p $o.", item);
// Actor: "You cannot drop your sword."

Action with target

tp->targetted_action("$N $vgive $p $o to $t.", target, item);
// Actor:  "You give your sword to Alice."
// Target: "Bob gives his sword to you."
// Others: "Bob gives his sword to Alice."

Multiple objects

tp->simple_action("$N $vtake a $o from a $o1.", item, container);
// Actor: "You take a sword from a chest."
// Others: "Bob takes a sword from a chest."

To be

tp->simple_action("$N $vis ready to fight.");
// Actor: "You are ready to fight."
// Others: "Bob is ready to fight."

Contraction

tp->simple_action("$N $vdon't see that here.");
// Actor: "You don't see that here."
// Others: "Bob doesn't see that here."

Announcement to room

tp->other_action("$N $venter from the north.");
// Actor: (nothing)
// Others: "Bob enters from the north."

Reflexive

tp->simple_action("$N $vhurt $No.");
// Actor: "You hurt yourself."
// Others: "Bob hurts himself."

Random message

tp->simple_action(({
    "$N $vswing $p sword wildly.",
    "$N $vslash at the air with $p sword.",
    "$N $vbrandish $p sword menacingly.",
}), sword);
// Randomly picks one template each time

Common Pitfalls & Troubleshooting

Wrong verb form

Problem: "Bob swing the sword" instead of "Bob swings the sword" Cause: Missing $v prefix on the verb. Write $vswing not just swing.

"you" where a name should be

Problem: Actor sees "you" but you wanted the name Fix: Use $Nd (display name suffix) to force the name instead of pronoun.

Premature pronoun

Problem: "he drops his sword" on first mention instead of "Bob drops his sword" Cause: The has tracking thinks the object was already mentioned. This can happen if the same living appears in multiple token positions. The system tracks mentions per-composition — each viewer gets fresh tracking.

"is" vs "are" wrong

Problem: "You is ready" or "Bob are ready" Fix: Use $vis (not $vare or $vam). The system handles conjugation — all three forms (is/am/are) trigger the same "to be" logic.

Object shows as "it" too early

Problem: First mention of an object shows "it" instead of the name Cause: The object or its short description was already in the has tracking — possibly mentioned via a different token. Each $o use with the same object increments the tracking.

Possessive on wrong person

Problem: "Bob's" shows up where "your" should Cause: Check which participant $p refers to. By default it's participant 0 (the actor). Use $p1 for the target's possessive.

Articles doubling or missing

Problem: "a a sword" or missing article Cause: The system strips and re-applies articles when a or the precedes $o. If your object's query_short() already includes an article ("a sword"), the system will strip and reapply. Don't include articles in both the template and the short description.

Gender "other" and verb conjugation

Note: Gender "other" uses plural agreement — $vis → "are", $vswing → "swing" (not "swings"). This is intentional for they/them pronouns.

Grammar Support Functions

Available as simul_efuns for manual use: