Creating-Mods/Localisation/JSON.md

@@ -3,7 +3,10 @@ JSON localisation is a brand new localisation method introduced to the game by A
 Create a JSON file with a name matching the two letter level code of the target level in your mod's "Localisation" folder. You can edit JSON files with most text editors, though something like Notepad++ is recommended. It is **not** recommended that you use regular Notepad as it is not well suited to modifying this kind of file.
 
 Here is an example of the formatting of localisation JSON files:
-`{
+## Levels
+
+```json
+{
 	"Default": {
 		"L1NECODE": "This is the default text that will be loaded for this linecode should no other language have overriding text",
 		"L2NECODE": "This is a second text that uses a different linecode."
@@ -19,5 +22,28 @@ Here is an example of the formatting of localisation JSON files:
 	"German": {
 		"L1NECODE": "Lokalisierter Text"
 	}
-}`
+}
+```
+
+## Global
+Due to a limitation, you must mark the global strings JSON like so:
+```json
+{
+	"Global": true,
+	"Default": {
+		"L1NECODE": "This is the default text that will be loaded for this linecode should no other language have overriding text",
+		"L2NECODE": "This is a second text that uses a different linecode."
+	},
+	"English": {
+		"L1NECODE": "This text will override the default when the English language is loaded."
 		
+		/* L2NECODE will still use the text from "Default" as it is not defined in English */
+	},
+	"French": {
+		"L1NECODE": "Texte localisé"
+	},
+	"German": {
+		"L1NECODE": "Lokalisierter Text"
+	}
+}```
+Any JSON file flagged in this way will have the strings added to the global stringtable which is _not_ cleared on level end. Please only use it on the special `GLOBAL.json` table.
\ No newline at end of file