Audience: New scripting users

What This Guide Covers

Reference: Read the Scripting Basics and Wizards guide first for core syntax, wildcards, variables, procedures, and wizard navigation.

This guide is about controlling what you see in your text window:

• Filters (Gags) hide noise.
• Highlights emphasize important lines.
• Substitutions rewrite text into clearer wording.

If the previous guide automated behavior, this guide improves readability.

Filters (Gags): Hide Noise

Use a gag when a repeated line is not useful to read every time.

Steps:

1. Pick one noisy line.
2. Match a simple phrase from that line.
3. Save the gag and confirm the line disappears.

Example:

/gag {You are thirsty.} {survival}

List your gags:

/gags

[TIP] Start with only one gag at a time so you can verify you are not hiding useful information.

Highlights: Make Key Events Pop

Use highlights for lines that should grab your attention immediately.

Steps:

1. Choose the exact phrase to highlight.
2. Pick readable colors.
3. Save and watch for readability during real play.

Example:

/highlight {critical hit} {yellow,back red} {combat}

List your highlights:

/highlights

[TIP] Keep highlight colors consistent by category (danger, loot, healing, etc.).

Substitutions: Rewrite for Clarity

Use substitutions when you want to replace long or awkward output text.

Steps:

1. Match the original phrase.
2. Define a shorter replacement.
3. Confirm the result still carries the meaning you need.

Example:

/substitute {You are hungry.} {Hunger warning.} {survival}

Another example:

/substitute {You are thirsty.} {Drink soon.} {survival}

List your substitutions:

/substitutes

[TIP] Your Action scripts do NOT trigger on your newly substituted text. Actions only trigger from MUD output.

Quick Reference

Core commands:

• /gag {text} {group} : Hide matching lines.
• /gags : List all gags.
• /highlight {text} {color} {group} : Colorize matching lines.
• /highlights : List all highlights.
• /substitute {text} {replacement} {group} : Rewrite matching lines.
• /substitutes : List all substitutions.

Version Notes

• Retargeted to Pilot 02 scope: filters, highlights, substitutions.