游戏文本配置方案：富文本、动态参数与多语言架构

摘要：本文聚焦「游戏文本配置方案：富文本、动态参数与多语言架构」，梳理核心概念、关键方法与落地实践。

​

1. 核心痛点与设计目标

​

2. 架构设计：三层解耦模型

​

2.1 配置层 (Excel / Localization Table)

• {0}: 占位符，将在运行时被实际伤害值替换。
• <c=dmg>: 语义化颜色标签。
• <l=buff_burn>: 链接标签，指向 ID 为 buff_burn 的数据。

​

2.2 解析层 (C# Text Parser)

​

A. 动态参数注入 (Dynamic Injection)

public class SkillDescriptionBuilder {
    public string GetDescription(SkillData skill) {
        // 1. 获取本地化模版
        string template = LocalizationManager.Get(skill.DescriptionKey);
        // template = "造成 <c=dmg>{0}</c> 点伤害"

        // 2. 获取实时数值 (关键步骤)
        // 技能实例必须能提供上下文数据
        float currentDamage = skill.Attributes.Get(StatType.Damage).Value;

        // 3. 格式化
        // 注意：建议封装 string.Format 以处理异常
        return string.Format(template, currentDamage);
    }
}

​

B. 参数格式化 (Parameter Formatting)

​

C. 语义标签替换 (Semantic Tag Replacement)

// 样式表配置
public Dictionary<string, string> styleMap = new Dictionary<string, string>() {
    { "dmg", "#FF4500" },       // 物理伤害橙红色
    { "heal", "#00FF7F" },      // 治疗翠绿色
    { "warn", "#FFD700" }       // 警告金黄色
};

// 解析逻辑 (Regex 或 字符串替换)
public string ParseTags(string input) {
    // 将 <c=dmg> 替换为 <color=#FF4500>
    // 将 <l=buff_id> 替换为 <link="buff_id"> (TextMeshPro 格式)
    // 将 <s=icon_fire> 替换为 <sprite name="icon_fire">
    return processedString;
}

​

2.3 渲染层 (Unity TextMeshPro)

• 超链接交互： TMP 组件支持 OnLinkPointerClick 事件。
  public void OnPointerClick(PointerEventData eventData) {
      int linkIndex = TMP_TextUtilities.FindIntersectingLink(tmpText, Input.mousePosition, ...);
      if (linkIndex != -1) {
          TMP_LinkInfo linkInfo = tmpText.textInfo.linkInfo[linkIndex];
          string linkID = linkInfo.GetLinkID(); // 获取 "buff_burn"
          TooltipSystem.Show(linkID); // 弹出对应 ID 的详情页
      }
  }
  

​

3. 进阶功能：智能文本 (Smart Text)

​

条件文本 (Conditional Text)

• 场景：某些效果仅在特定条件（如夜晚、满血）下生效。
• 实现：解析器检测到 {if} 块时，计算布尔条件。若为 false，剔除块内文本，避免显示无意义的描述。

​

动态运算 (Math Operations)

• 场景：显示升级后的预览数值。
• 实现：解析器支持基础数学运算，直接根据当前变量算出预览值。

​

ICU 复数支持 (Plurals)

• 场景：处理 “1 Skeleton” vs “5 Skeletons” 的语言差异。
• 工具：Unity 插件如 I2 Localization 或 Smart String 已内置此功能。

​

4. Vampirefall 落地建议

​

推荐技术栈

• 存储: Excel / Google Sheets (利用 Luban 导出)。
• 运行时: I2 Localization (处理多语言加载) + TextMeshPro (渲染)。
• 逻辑层: 自定义 TextFormatter 类。

​

开发工具 (Editor Tool)

• 界面：左侧选择技能，右侧显示 TMP 渲染出的富文本。
• 功能：
  • 提供“等级”滑块：拖动滑块，实时看到描述里的数字变化（验证公式绑定是否正确）。
  • 样式切换：一键切换“亮色模式/暗色模式”，检查颜色标签在不同底板下的可读性。

​

命名规范

• 颜色标签：使用功能命名，而非颜色命名。
  • ✅ <c=buff> (Buff 颜色)
  • ❌ <c=green> (绿色)
• 图标标签：与图集 Sprite 名字保持一致。
  • <s=stat_atk> -> 对应图集里的 stat_atk.png。

​

5. 总结

• Input: 技能数据 (SkillData) + 本地化模版 (Template)。
• Process: 注入参数 -> 替换标签 -> 处理逻辑。
• Output: 带有交互功能的富文本 (Rich Text)。