Defold 本地化与多语言

locales/
  en.csv         ← 英文文本表
  zh.csv         ← 简体中文
  ja.csv         ← 日文
fonts/
  default.font   ← 拉丁字体
  cjk.font       ← 中日韩字体（含大字符集）
scripts/
  i18n.lua       ← 语言管理模块

menu.start          界面.元素.用途
menu.settings
dialog.npc_01.greet 剧情.角色.行号
error.network_timeout
item.sword.name
item.sword.desc

keys,en,zh,ja
menu.start,Start,开始,スタート
menu.settings,Settings,设置,設定
menu.quit,Quit,退出,終了
dialog.npc_01.greet,Hello traveler!,你好，旅行者！,こんにちは、旅人よ！
item.sword.name,Iron Sword,铁剑,鉄の剣

-- 在 main.script 中加载
function init(self)
    self.atlas = resource.load("/locales/locales.atlas")
    -- 或者直接指定 csv 文件
    self.locales = resource.load("/locales/locales.csv", "text")
    -- 设置当前语言
    sys.set_config_string("locale", "zh")
end

function init(self)
    local info = sys.get_sys_info()
    local lang = info.language or "en"     -- 例如 "zh"、"en"、"ja"
    -- 只保留主语言标签
    lang = string.match(lang, "^%a+") or "en"
    self.lang = lang
end

-- scripts/i18n.lua
local M = {
    current = "en",
    table   = {},
}

function M.init(default_lang)
    M.current = default_lang or "en"
    M.table = {}
    -- 逐 key 读入当前语言的文本
end

function M.t(key, ...)
    local text = M.table[key]
    if not text then
        -- 缺 key 时返回 key 本身，方便定位遗漏
        return "[" .. key .. "]"
    end
    if select("#", ...) > 0 then
        return string.format(text, ...)
    end
    return text
end

function M.set_language(lang)
    if lang == M.current then return end
    M.current = lang
    msg.post("#", "language_changed", { lang = lang })
end

return M

-- 读取英文文本
local s = sys.get_config_string("en.menu.start", "Start")

-- 读取当前语言（把语言代码拼进去）
local lang = i18n.current
local s2 = sys.get_config_string(lang .. ".menu.start", "Start")

-- settings.script
function on_message(self, message_id, message, sender)
    if message_id == hash("select_language") then
        -- 1. 记录新语言
        sys.set_config_string("locale", message.lang)
        i18n.set_language(message.lang)

        -- 2. 广播给所有 UI 节点
        msg.post("/gui#ui_root", "refresh_texts")

        -- 3. 重新加载字体（如果需要切换字体集）
        local font = resource.load("/fonts/" .. message.lang .. ".font")
        msg.post("/gui#ui_root", "set_font", { font = font })
    end
end

方案 A（推荐）：文本即时切换，字体在启动时按语言预加载好
方案 B：切换语言后提示「重启生效」，重启时读配置
方案 C：同时加载两套字体，切换时替换 gui.set_font 的引用

myfont.font
  ├── main.ttf          ← 主字体（拉丁）
  ├── cjk.ttf           ← fallback（中日韩）
  └── emoji.ttf         ← fallback（emoji）

-- 预加载常用字符，避免运行时抖动
local chars = "0123456789"
    .. "abcdefghijklmnopqrstuvwxyz"
    .. "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
    .. "，。！？：；、（）《》"
    .. "的一是了我不人在他有这上们来到时大地为子中你说生国年着就那和要她出也得里后自以会家可下而过天去能对小多然于心学么之都好看起发当没成只如事把还用第样道想作种开美总从无情己面最女但现前些所同日手又行意动方期它头经长儿回位分爱老因很给名法间斯知世什两次使身者被高已亲其进此话常与活正感"

function init(self)
    -- 通过 resource 预载字体，触发字形生成
    resource.load("/fonts/cjk.font")
end

-- ui_root.gui_script
local FONT_LATIN = hash("/fonts/latin.font")
local FONT_CJK   = hash("/fonts/cjk.font")

local function font_for_lang(lang)
    if lang == "zh" or lang == "ja" or lang == "ko" then
        return FONT_CJK
    end
    return FONT_LATIN
end

function on_message(self, message_id, message, sender)
    if message_id == hash("set_font") then
        local font = font_for_lang(i18n.current)
        -- 遍历所有文本节点替换字体
        for _, node in ipairs(gui.get_nodes_by_type("text")) do
            gui.set_font(node, font)
        end
    end
end

-- 设置文本节点自动换行并按宽度适配
gui.set(node, "line_break", true)
gui.set(node, "adjust_mode", gui.ADJUST_FIT)

-- 检查文本实际尺寸，必要时缩小字号
local function fit_text(node, max_width)
    local size = gui.get_text_size(node)
    if size.x > max_width then
        local scale = max_width / size.x
        gui.set_scale(node, vmath.vector3(scale, scale, 1))
    end
end

English : "Hello traveler, welcome to the village!"
Chinese : "你好，旅行者，欢迎来到村庄！"
Japanese: "こんにちは、旅人よ、村へようこそ！"

keys,en,zh
quest.kill,Defeat %d enemies,击败 %d 个敌人
quest.reward,Reward: %s,奖励：%s

local text = i18n.t("quest.kill", 5)
-- 英文: Defeat 5 enemies
-- 中文: 击败 5 个敌人

images/
  title_en.png
  title_zh.png
  title_ja.png

-- 按语言拼接资源路径
local function localized_texture(name)
    return "/images/" .. name .. "_" .. i18n.current .. ".png"
end

local path = localized_texture("title")
gui.set_texture(node, hash(path))

-- 按语言选择语音包
local voice_path = "/audio/voice_" .. i18n.current
if sys.exists(voice_path) then
    -- 加载对应语言语音
else
    -- 回退到默认语言
    voice_path = "/audio/voice_en"
end

-- 简单实现：按语言切换分隔符
local function format_number(n, lang)
    local s = tostring(n)
    if lang == "de" or lang == "fr" then
        -- 德语/法语：千分位用点，小数点用逗号
        s = s:gsub(",", "#"):gsub("%.", ","):gsub("#", ".")
    end
    return s
end

local os_date = os.date("*t")
local patterns = {
    en = "%m/%d/%Y",
    zh = "%Y年%m月%d日",
    ja = "%Y年%m月%d日",
    de = "%d.%m.%Y",
}
local fmt = patterns[i18n.current] or "%Y-%m-%d"
local text = os.date(fmt, os.time(os_date))

keys,en,zh,ru
item.count.one,%d item,%d 个物品,%d предмет
item.count.many,%d items,%d 个物品,%d предметов

local function item_count(n)
    local key = "item.count.many"
    if n == 1 then
        key = "item.count.one"
    end
    -- 中文没有复数变化，两个 key 指向同一文案即可
    return i18n.t(key, n)
end

-- 开发期把缺 key 记录到日志
local missing = {}
function i18n.t(key, ...)
    local text = i18n.table[key]
    if not text then
        missing[key] = (missing[key] or 0) + 1
        return "[" .. key .. "]"
    end
    return select("#", ...) > 0 and string.format(text, ...) or text
end

function i18n.dump_missing()
    for k, count in pairs(missing) do
        print(string.format("[i18n] missing key: %s (used %d times)", k, count))
    end
end

-- ======================================
-- 完整示例：i18n.lua 语言管理模块
-- 放在 /scripts/i18n.lua
-- ======================================

local M = {
    current = "en",
    cache   = {},
    missing = {},
}

local SUPPORTED = { en = true, zh = true, ja = true, ko = true, de = true, fr = true }

-- 从系统语言推断默认语言
function M.detect_default()
    local info = sys.get_sys_info()
    local lang = info and info.language or "en"
    lang = string.match(lang, "^%a+") or "en"
    if SUPPORTED[lang] then
        return lang
    end
    return "en"
end

function M.init()
    M.current = sys.get_config_string("locale", M.detect_default())
    M.cache = {}
    print("[i18n] 初始化完成，当前语言:", M.current)
end

function M.t(key, ...)
    local text = M.cache[key]
    if not text then
        -- 首次访问时从配置读取并缓存
        text = sys.get_config_string(M.current .. "." .. key, nil)
        if not text then
            M.missing[key] = (M.missing[key] or 0) + 1
            return "[" .. key .. "]"
        end
        M.cache[key] = text
    end
    if select("#", ...) > 0 then
        local ok, formatted = pcall(string.format, text, ...)
        if ok then
            return formatted
        end
        return text
    end
    return text
end

function M.set_language(lang)
    if not SUPPORTED[lang] then
        print("[i18n] 不支持的语言:", lang)
        return false
    end
    M.current = lang
    M.cache = {}
    sys.set_config_string("locale", lang)
    -- 广播给所有 UI 刷新文案
    msg.post("/gui#ui_root", "refresh_texts", { lang = lang })
    return true
end

function M.dump_missing()
    local n = 0
    for k, c in pairs(M.missing) do
        print(string.format("[i18n] 缺失 key: %s (调用 %d 次)", k, c))
        n = n + 1
    end
    print("[i18n] 缺失 key 总数:", n)
end

return M