Unofficial WIKI

Name Filter Settings

nameFilterSettings

Keyed map of name replacement rules. Each key is a name (or name fragment); its value provides a list of allowed replacements. When a generated name matches a key, the AI substitutes one from the replacements array.

In the editor

"Settings for filtering names in the world"

Editor location
Other → Name Filter Settings
Editor type
JSON + ADD ITEM (empty {} by default)
API endpoint
/api/sections/nameFilterSettings.json /api/sections/nameFilterSettings.md
Size limits
  • nameFilterSettings (entire section) — 50,000 chars
  • nameFilterSettings.*.replacements.* (each replacement) — 64 chars
Related
Last updated

Schema

json 
{
  "nameFilterSettings": {
    "<key>": {
      "replacements": [
        "string"
      ]
    }
  }
}

Example

json 
{
  "Marcus": {
    "replacements": ["Alex", "Ethan", "Jason", "Ryan", "Owen", "Nathaniel", "Adrian", "Colin"]
  },
  "Elara": {
    "replacements": ["Thea", "Cora", "Nova", "Vega", "Astra", "Selene", "Orion", "Cassie"]
  },
  "Ironfoot": {
    "replacements": ["Anvildrang", "Broadback", "Coalvein", "Cragmor", "Deepholm", "Redforge"]
  }
}

Entry shapes

Leave as {} if you have no naming constraints. There are two entry shapes:

  • Name replacement: map a banned name to lore-appropriate substitutes. The engine substitutes during narration.
  • Word/phrase deletion: set replacements to [""] to delete a phrase outright instead of replacing it. Useful for stripping recurring AI tics or undesired in-world phrases.