UnofficialWIKI
Builder
Edit / Suggest changeSuggest deletion

Name Filter Settings

nameFilterSettings

Keyed map of name replacement rules. Each key is a name to avoid; its value lists the names that may be used instead. When generation reaches for a disallowed name, one of its replacements is used.

In the editor

"Settings for filtering names in the world"

Editor location
Files → Other → Name Filter Settings
Editor type
Edit in Studio + View JSON
API endpoint
/sections/nameFilterSettings.json/sections/nameFilterSettings.md
Size limits
  • nameFilterSettings (entire section) — 150,000
  • nameFilterSettings.*.replacements.* (each replacement) — 64
Related

Schema

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

Example

json
{
  "nameFilterSettings": {
    "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.

An entry maps one disallowed name to the names that may be used instead: the key is the name to avoid, and replacements lists what the world may pick from in its place. The seeded defaults are the clearest guide to the intent — each one takes a name that generation reaches for too often and offers alternatives, Marcus giving way to Alex, Ethan, Jason and the rest.

Nothing validates the contents, so any string decodes. Keep entries to names: a key that is a word or a phrase, or a replacements list of [""], is not what the field is built to do and there is no evidence it reaches prose in the story.

Fields

replacements

Map of a name, word, or phrase to its replacement list. When the AI generates a matching name or phrase, the system picks one entry from the list at random instead; an empty string ("") deletes the match outright. Used to replace overused generic names with culturally appropriate alternatives and to strip recurring AI phrasing.