example_rules.json

{
    "incoming": [
        {
            "pattern": "^(\\d+) You sold (\\d+) (.*?) for \\$([\\d\\.]+)\\.$",
            "replacement": "You sold $^2 $3 for $^4. ($^i)",
            "toast": true,
            "valuestack": {
                "ignore_diffs": [1],
                "stack_values": [2, 4],
                "expire_after": 4,
                "seperate_float_with": "."
            },
            "description": "Value stacking: accumulates quantity and price across rapid shop messages. $^2 and $^4 show running totals, $^i shows how many messages stacked. Resets after 4 seconds of silence."
        },
        {
            "pattern": "^\\[Shop\\] (.*)$",
            "replacement": "$1",
            "toast": true,
            "notifyStyle": "toast",
            "description": "Show shop messages as system toast notifications instead of chat."
        },
        {
            "pattern": "^\\*\\* (.*) \\*\\*$",
            "replacement": "§b§l$1",
            "toast": true,
            "notifyStyle": "advancement",
            "description": "WorldGuard region travel messages shown as advancement-style popups."
        },
        {
            "pattern": "^(\\w*) increased to (\\d+)\\.$",
            "replacement": "§f§l$1 increased to §a§l$2",
            "toast": true,
            "notifyStyle": "actionbar",
            "sound": "bell",
            "description": "MCMMO level increase: toast with action bar display and bell sound."
        },
        {
            "pattern": "\\$([\\d.]+)",
            "replacement": "&a$$$1",
            "colorAware": true,
            "description": "Color-aware: highlights dollar amounts in green. Matches against text WITH color codes preserved."
        },
        {
            "pattern": "\"text\":\"(Achievement|Goal|Challenge)\"",
            "replacement": "§e§l$0",
            "matchJson": true,
            "toast": true,
            "description": "JSON matching: matches against the raw JSON chat component, not the displayed text. Useful for detecting hidden data in chat packets."
        },
        {
            "pattern": "^[^<>]+(DiscordApp|Steve|Alex) has requested to teleport to you\\.$",
            "replacement": "$0",
            "respond": "/tpaccept",
            "description": "Auto-respond with a single command when specific players request teleport."
        },
        {
            "pattern": "^Game Over!$",
            "replacement": "$0",
            "respond": ["/say gg", "/say well played"],
            "description": "Multi-command respond: sends multiple commands when a pattern matches. Each entry in the array is sent as a separate command/message."
        },
        {
            "pattern": "^Now leaving the safe area\\.$",
            "replacement": "pleasecancelthismessage",
            "description": "Cancel a message entirely: setting replacement to 'pleasecancelthismessage' hides it from chat."
        },
        {
            "pattern": "^\\[Auction\\] (\\d+ seconds left).$",
            "replacement": "§4§klllll §7§l[§1§lAuction§7§l]§1§l $1 §4§klllll",
            "toast": true,
            "sound": "note_pling",
            "description": "Sound alert with a specific sound ID. Custom sound names are resolved per platform."
        },
        {
            "pattern": "^Welcome to (.+)!$",
            "replacement": "Joined $1 as {username} at {time}",
            "description": "Tag variables: {username}, {serverip}, {servername}, {time} are replaced with live values."
        },
        {
            "pattern": "^\\[Server\\] Restarting",
            "server": "^mc\\.example\\.com",
            "replacement": "§c§lSERVER RESTART INCOMING",
            "toast": true,
            "sound": true,
            "description": "Server filtering: only matches on servers matching the 'server' regex. 'sound': true plays the default sound."
        }
    ],
    "outgoing": [
        {
            "pattern": "^/b$",
            "replacement": "/bottle get 64",
            "description": "Command alias: typing '/b' sends '/bottle get 64' instead."
        },
        {
            "pattern": "^[^#/].*",
            "replacement": "&a&l$0",
            "server": "^mc\\.examplemcserver\\.com",
            "description": "Outgoing message rewrite: prefixes all non-command messages with green bold color on a specific server."
        },
        {
            "pattern": "t(est)",
            "replacement": "this is the b$1",
            "toast": true,
            "description": "Outgoing with toast: rewrites 'test' to 'this is the best' and shows it as a toast."
        }
    ]
}