{"tab":"world","section":"worldVoices","title":"Voices","summary":"Voices defined by the world itself, built on a base voice and reusable across NPCs and premade characters. An entry can also be offered to players during character creation.","kind":"schema","uiLocation":"Content → World → Voices","editor":"Edit in Studio + View JSON","related":[{"section":"npcs","note":"an NPC points at a world voice with worldVoiceId"},{"section":"premadeCharacters","note":"a premade character points at a world voice the same way"}],"wikiUrl":"/world/worldVoices","schema":{"_type":"record","domain":"string","codomain":{"_type":"intersection","parts":[{"_type":"partial","fields":{"label":"string","voiceTag":"string","instructions":"string","speed":"number","effects":{"_type":"intersection","parts":[{"_type":"partial","fields":{"pitch":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","semitones":"number"}}]},"reverb":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","space":{"_type":"union","of":[{"_type":"literal","value":"room"},{"_type":"literal","value":"hall"},{"_type":"literal","value":"cavern"}]},"mix":"number"}}]},"echo":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","delayMs":"number","feedback":"number","mix":"number"}}]},"eq":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","highPass":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","frequency":"number"}}]},"lowShelf":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","frequency":"number","gainDb":"number"}}]},"bell1":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","frequency":"number","gainDb":"number","q":"number"}}]},"bell2":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","frequency":"number","gainDb":"number","q":"number"}}]},"highShelf":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","frequency":"number","gainDb":"number"}}]},"lowPass":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","frequency":"number"}}]}}}]},"distortion":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","drive":"number"}}]},"output":{"_type":"intersection","parts":[{"_type":"partial","fields":{"enabled":"boolean","gainDb":"number","compressor":"boolean"}}]}}}]},"exposeInCharacterCreation":"boolean"}}]}},"sizeLimits":[],"blocks":[{"type":"example","lang":"json","code":"{\n  \"worldVoices\": {\n    \"court_herald\": {\n      \"label\": \"Court Herald\",\n      \"voiceTag\": \"male commanding blunt\",\n      \"instructions\": \"Formal and clipped, as if announcing to a full hall. Never hurried.\",\n      \"speed\": 1,\n      \"exposeInCharacterCreation\": false\n    }\n  }\n}"},{"type":"prose","md":"A world voice is a named voice this world defines once and reuses. NPCs and premade characters point at one with `worldVoiceId`, which takes the entry's key, so changing the voice in one place changes it everywhere it is used.\n\nThis sits alongside `voiceTag`, which picks a stock voice directly on the character. A world voice is the option to reach for when several characters should share one treatment, or when a voice needs direction beyond what a stock tag carries.\n\nEach effect group has its own switch, and a voice can be saved with all of them off. Previews are the quickest way to hear one: they become available once the voice carries a voice tag."},{"type":"fields","fields":[{"name":"label","tooltip":"The name this voice is shown under.","md":"The name this voice is shown under, including in character creation when the voice is offered there. It starts out matching the entry's key, so rename it to something that describes the voice rather than leaving the generated name."},{"name":"voiceTag","tooltip":"Describes the voice to build on; free text, not a fixed list.","md":"Describes the voice this one is built on, and what speech audio is selected from. It is free text rather than a fixed list, so a phrase that is not in the [Voice Catalog](/appendix/voice-catalog) is still accepted and matched to the closest available voice. Naming a catalogue voice is what makes the result predictable. A voice without one still saves, but it cannot be previewed until the tag is set."},{"name":"instructions","tooltip":"Direction for how the voice should be delivered.","md":"Direction for how the voice should be delivered, layered on top of the base voice."},{"name":"speed","tooltip":"How fast the voice speaks.","md":"How fast the voice speaks."},{"name":"effects","tooltip":"Effect settings applied to the voice.","md":"Effect settings applied to the voice, grouped as `pitch`, `reverb`, `echo`, `distortion`, `output` and `eq`. Each group is switched on independently, so a voice with none of them enabled plays as its base voice."},{"name":"exposeInCharacterCreation","tooltip":"Offers this voice to players in the character creator.","md":"Offers this voice to players in the character creator. Leave it off for voices that belong to specific NPCs rather than to whoever the player builds."}]}],"body":"## Example\n\n```json\n{\n  \"worldVoices\": {\n    \"court_herald\": {\n      \"label\": \"Court Herald\",\n      \"voiceTag\": \"male commanding blunt\",\n      \"instructions\": \"Formal and clipped, as if announcing to a full hall. Never hurried.\",\n      \"speed\": 1,\n      \"exposeInCharacterCreation\": false\n    }\n  }\n}\n```\n\nA world voice is a named voice this world defines once and reuses. NPCs and premade characters point at one with `worldVoiceId`, which takes the entry's key, so changing the voice in one place changes it everywhere it is used.\n\nThis sits alongside `voiceTag`, which picks a stock voice directly on the character. A world voice is the option to reach for when several characters should share one treatment, or when a voice needs direction beyond what a stock tag carries.\n\nEach effect group has its own switch, and a voice can be saved with all of them off. Previews are the quickest way to hear one: they become available once the voice carries a voice tag.\n\n## Fields\n\n### label\n\nThe name this voice is shown under, including in character creation when the voice is offered there. It starts out matching the entry's key, so rename it to something that describes the voice rather than leaving the generated name.\n\n### voiceTag\n\nDescribes the voice this one is built on, and what speech audio is selected from. It is free text rather than a fixed list, so a phrase that is not in the [Voice Catalog](/appendix/voice-catalog) is still accepted and matched to the closest available voice. Naming a catalogue voice is what makes the result predictable. A voice without one still saves, but it cannot be previewed until the tag is set.\n\n### instructions\n\nDirection for how the voice should be delivered, layered on top of the base voice.\n\n### speed\n\nHow fast the voice speaks.\n\n### effects\n\nEffect settings applied to the voice, grouped as `pitch`, `reverb`, `echo`, `distortion`, `output` and `eq`. Each group is switched on independently, so a voice with none of them enabled plays as its base voice.\n\n### exposeInCharacterCreation\n\nOffers this voice to players in the character creator. Leave it off for voices that belong to specific NPCs rather than to whoever the player builds."}