Add locale convar and locale fallback

fxmanifest.lua

@@ -7,7 +7,8 @@ version '1.1.0'
 shared_scripts {
     'config.lua',
     'shared/locale.lua',
-    'locale/en.lua', -- replace with desired language
+    'locale/en.lua',
+    'locale/*.lua',
     'shared/main.lua',
     'shared/items.lua',
     'shared/jobs.lua',

locale/ar.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'ar' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/bg.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'bg' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/cn.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'cn' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/cs.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'cs' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/da.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'da' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/de.lua

@@ -118,7 +118,10 @@ local Translations = {
     },
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'de' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/ee.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'ee' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/en.lua

@@ -118,7 +118,7 @@ local Translations = {
     },
 }
 
-Lang = Locale:new({
+Lang = Lang or Locale:new({
     phrases = Translations,
     warnOnMissing = true
 })

locale/es.lua

@@ -30,7 +30,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'es' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/et.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'et' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/fa.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'fa' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/fi.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'fi' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/fr.lua

@@ -120,7 +120,10 @@ local Translations = {
     },
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'fr' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/ge.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'ge' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/he.lua

@@ -118,7 +118,11 @@ local Translations = {
     },
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'he' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end
+

locale/hu.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'hu' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/in.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'in' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/is.lua

@@ -118,7 +118,10 @@ local Translations = {
     },
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'is' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/it.lua

@@ -123,7 +123,10 @@ error = {
     },
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'it' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/lv.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'lv' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/nl.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'nl' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/pl.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'pl' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/pt-br.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'pt-br' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/pt.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'pt' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/ro.lua

@@ -115,7 +115,10 @@ local Translations = {
     },
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'ro' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/rs.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'rs' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/ru.lua

@@ -118,7 +118,10 @@ local Translations = {
     },
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'ru' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/sl.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'sl' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/sv.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'sv' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/th.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'th' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/tr.lua

@@ -25,7 +25,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'tr' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

locale/vn.lua

@@ -19,7 +19,10 @@ local Translations = {
     }
 }
 
-Lang = Locale:new({
+if GetConvar('qb_locale', 'en') == 'vn' then
-    phrases = Translations,
+    Lang = Locale:new({
-    warnOnMissing = true
+        phrases = Translations,
-})
+        warnOnMissing = true,
+        fallbackLang = Lang,
+    })
+end

shared/locale.lua

@@ -32,7 +32,13 @@ end
 --- @return Locale
 function Locale:new(opts)
     setmetatable(self, Locale)
-    self.warnOnMissing = opts.warnOnMissing or true
+
+    self.fallback = opts.fallbackLang and Locale.new({}, {
+        warnOnMissing = false,
+        phrases = opts.fallbackLang.phrases,
+    }) or false
+
+    self.warnOnMissing = type(opts.warnOnMissing) ~= 'boolean' and true or opts.warnOnMissing
 
     self.phrases = {}
     self:extend(opts.phrases or {})
@@ -98,6 +104,9 @@ function Locale:t(key, subs)
         if self.warnOnMissing then
             print(('^3Warning: Missing phrase for key: "%s"'):format(key))
         end
+        if self.fallback then
+            return self.fallback:t(key, subs)
+        end
         result = key
     end