replace
ARES System Manual: filter Text Filter Utilities
(chat filtering... > <chain> filters... > replace > activate or configure): values input here are passed to
As with other chat filters, it is only appropriate to call filter directly when manually using a pipe to modify text. Most users should instead interface with it via the vox command or chat filtering menu, which manages automatic modification of chat.
Flags
Specify the subkey of
By default, the database includes one list of word replacements,
An owner can create a new list of words with a command such as
which can then be selected with
See db for more information on creating database entries.
Order of Operations
Limitations
Currently,
filter replace <flags>: Performs single-word substitutions on the input stream, preserving capitalization as much as possible.
vox <chain> replace remove: Removes this filter from the specified vox pipeline <chain>.
vox <chain> replace <flags>: Adds this filter to the vox pipeline <chain>, with the specified <flags>. If it is already present, the current <flags> will be updated.
(chat filtering... > <chain> filters... > replace > activate or configure): values input here are passed to
vox <chain> replace.
As with other chat filters, it is only appropriate to call filter directly when manually using a pipe to modify text. Most users should instead interface with it via the vox command or chat filtering menu, which manages automatic modification of chat.
Flags
Specify the subkey of
replace within the filter database section which contains an associative array (JSON object) of words to replace.
By default, the database includes one list of word replacements,
stanley.
An owner can create a new list of words with a command such as
@db filter.replace.honey {"you": "you, honey", "i": "i, darling", "him": "that sweet little boy"}
which can then be selected with
filter replace honey, vox <chain> replace honey, or entering honey into the activate or configure chat filtering menu, as appropriate.
See db for more information on creating database entries.
Order of Operations
replace is a layer 0 (semantic) filter. When used in a vox chain, it will be applied to the text before any filters of a higher layer.
Limitations
Currently,
replace can only alter single words, though the substitutions may be multiple words long. It treats apostrophes as punctuation, so words like 'don't' and 'can't' cannot be substituted.