Charisma supports localising your stories into different languages, to give more players the ability to play your excellent creations!

Charisma currently supports localisation into Arabic, Chinese, English, Dutch, French, German, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, Thai and Turkish.

Getting started

Note that enabling this feature will use credits. For more details, please view the licencing docs.

To get started, toggle on the 'Is localisation available?' checkbox on the Story Overview page.

If you’re writing your story originally in English:

  1. In the top-left corner of the story editor sidebar, click on the button labelled English and choose another language from the dropdown list entitled Add a new language. Press the green plus to add that language. You can add several languages if you wish!
  2. You’ll now be able to toggle between English and your other selected language(s). (When you switch to a language other than English, your character and player nodes will all be empty. Don’t worry about this!)
  3. In the sidebar on the left of your screen, select Localisation. This takes you to a page which allows you to generate and edit your translations.
  4. You will see two columns of text. These are all of your character and player nodes, in their original language and in translation.
  5. Make sure you have selected English from the left-hand column dropdown and the language you want to translate into from the right-hand column drop down. Now click on the button labelled Auto-translate all graph nodes. This will generate a translation of all of your character and player nodes. Do this for all of your chosen languages.
  6. This translation is made by an online translator. You’ll need to check the accuracy of the translation, making any edits in the textboxes on the localisation page.
  7. When you return to your graph and toggle between your different languages, the nodes will now be populated with the translations. You’ll also be able to preview your story in your chosen languages.
  8. If you make further edits to your story, return to the localisation page and repeat the translation process to ensure all of the nodes in your graph are translated.

Note, you don’t have to write your story originally in English! For example, you could write it initially in French, and then translate to English or any other language.

If you’re not editing in the original language, you can view the corresponding original content for each node in the graph by hovering over the textboxes in a character or player node.

The chat tester will automatically adapt to whichever language is currently selected.

Language gate conditions

You can set a language condition on a gate, checking whether a player is playing or not playing in a specific language. This is useful for showing certain content to players in a specific language.

Perhaps you have content that doesn’t translate well into another language, or you just really have to tell English players about this character’s love of tea. Pop in a language condition and you’re all set!

Writing pointers

Charisma’s automatic translator won’t provide a perfect translation of your story – you’ll need to check this yourself (or find someone else who can)! But there are a few things to bear in mind which will make the translation process more straightforward:

  • Keep your sentences simple. Avoid complicated grammatical constructions where possible.
  • Be careful with colloquial language. The Charisma platform is designed to foster conversations, and you don’t want your story to lose its voice or personality – but colloquial phrases can sound unnatural when translated automatically, so you’ll want to check these parts of your translation in particular.
  • Remember register and gender. Lots of languages have a formal and informal version of the pronoun “you”. Lots of languages also have gendered nouns and corresponding adjectives. Check for consistency in the translations of your story nodes – the automatic translator may not get it right every time!