fungus/Docs/fungus_lua/lua_string_table.md

# String Table # {#lua_string_table}
[TOC]

# Text localisation # {#lua_text_localisation}

The LuaUtils component provides support for simple text localisation.

1. Define your language strings in a JSON file and save it in the project assets folder.
2. Add a LuaEnvironment component to your scene - e.g. Tools > %Fungus > Create > LuaEnvironment 
3. In the LuaUtils component, set the String Table property to reference your JSON file asset.
4. Use the {$VarName} syntax to subsitute a localised string anywhere that string substitution is supported. e.g. in a Lua script:

```lua
say("{$hello_world}")
```

You can use the {$VarName} syntax anywhere that variable subsitution is supported. This includes:

- Say command
- Menu command
- Set Text command
- Write command
- Conversation command
- Character object - character name
- Debug Log command
- Load Variable command - save key
- Save Variable command - save key
- Delete Save Key command

You can also extend the %Fungus string substitution system with your own components. Implement the StringSubstituter.ISubstitutionHandler interface in a Monobehavior subclass and then return the modified string from SubstituteStrings().

# JSON Format # {#json_format}

This is an example of the JSON format for the string table. To use this localised string, you would use the {$hello_world} tag.

```json
{
	"hello_world" : {
		"en" : "Hello world!",
		"fr" : "Bonjour le monde!",
		"de" : "Hallo Welt!"
	},
	"goodbye_world" : {
		"en" : "Goodbye world!",
		"fr" : "Au revoir monde!",
		"de" : "Auf Wiedersehen Welt!"
	}
}
```

# Lua Functions # {#stringtable_lua_functions}

These Lua functions are available for working with the string table.

```lua
-- Set active language for string table
setlanguage(languagecode)

-- Get a named string from the string table
getstring(key)

-- Substitutes variables and localisation strings into a piece of text
-- e.g. v = 10, "Subbed value is [$v]" => "Subbed value is 10"
sub(text)
```