Terjemahan

Keseluruhan permainan mesti boleh diterjemahkan dengan mudah ke bahasa lain. Selepas beberapa eksperimen, saya membuat kelas I18n untuk engine3. Buat masa ini ia tidak lebih daripada 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

Dalam permainan, ia kemudian boleh digunakan di mana-mana 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 anda lihat, bahasa ’en’ juga ada dalam language.yaml, tetapi nilainya null. Ini bermakna ayat asal dalam bahasa Inggeris perlu digunakan. Dengan itu pada masa depan bahasa Inggeris juga boleh terus diterjemahkan kepada ayat lain.

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

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

Buat masa ini semuanya sudah memadai dan nampaknya berfungsi dengan baik dan pantas.