Terjemahan

Seluruh game harus bisa diterjemahkan dengan mudah ke bahasa lain. Setelah beberapa percobaan, saya membuat class I18n untuk engine3. Saat ini isinya tidak lebih dari ini.

function I18n:new()
    self.locale = nil
    self.currentLocaleFile = nil
end

--- Convert string to i18n locale
---@param str? string
---@param replacements? table
function I18n:s(str, replacements)
    if str == nil then
        return
    end

    local strOut = tostring(str)

    -- Maybe there is a overwrite
    if self.locale[strOut] ~= nil then
        strOut = self.locale[strOut]
    end

    -- Maybe there are replacements
    if replacements then
        return string.gsub(strOut, "[%%%d]+", replacements)
    end

    return strOut
end

---@param file string
---@param data table
function I18n:createI18nData(file, data)
    self.locale = data
    self.currentLocaleFile = file
end

--- Load the locale in memory
---@param file string Path to the source file .mp only at the moment
function I18n:load(file)
    if type(file) ~= "string" then
        error("Cannot load i18n file, is not a string")
    end

    if string.find(file, ".mp") == nil then
        error("i18n file is is not supported: " .. file)
    end

    local msgPackData = Msgpack:load(file)
    if msgPackData == nil then
        error("File data is nil for file: " .. file)
        return
    end

    self:createI18nData(file, msgPackData)
end

Di dalam game, fungsi ini lalu bisa dipakai di mana saja sebagai fungsi global dengan cara berikut

-- load the selected language once
i18n:load(config.localeDefault) -- nl.mp

-- use the default english strings into the selected language
local i18nHoverText = i18n:s("Hello")

language.yaml

en:
    "Hello" : null
nl:
    "Hello" : "Hallo"

Seperti yang kamu lihat, bahasa ’en’ juga ada di language.yaml, tapi nilainya null. Artinya kalimat asli bahasa Inggris yang harus dipakai. Dengan begitu di masa depan bahasa Inggrisnya juga bisa langsung diterjemahkan ke kalimat lain.

en:
    "Hello z" : "Hallo y"
nl:
    "Hello z" : "Hallo y"

print(i18n:s("Hello z")) -- Hallo y

Untuk sekarang semua ini sudah cukup dan tampaknya berjalan baik dan cepat.