第 5.3 章：Credits.json

摘要： Credits.json 文件定义了 DayZ 在游戏 Mod 菜单中为你的 Mod 显示的制作人员名单。它按部门和分类列出团队成员、贡献者和致谢信息。虽然纯粹是装饰性的，但它是为你的开发团队署名的标准方式。

概述

当玩家查看你的 Mod 的制作人员名单时，引擎会加载你在 config.cpp 的 CfgMods 块中通过 creditsJson 键声明的路径所指向的文件（例如 creditsJson = "MyMod/Scripts/Data/Credits.json";）。然后，制作人员名单将以按部门和分类组织的滚动视图显示——类似于电影片尾字幕。

该文件是可选的。如果你不声明 creditsJson 键，该文件永远不会被加载，你的 Mod 不会显示任何制作人员名单。但包含一个是好的做法：它承认了团队的工作，并使你的 Mod 看起来更加专业。

文件位置

将 Credits.json 放在 Scripts 目录的 Data 子文件夹中，或直接放在 Scripts 根目录下：

@MyMod/
  Addons/
    MyMod_Scripts.pbo
      Scripts/
        Data/
          Credits.json       <-- 常见位置（COT、Expansion、DayZ Editor）
        Credits.json         <-- 也有效（DabsFramework、Colorful-UI）

该文件可以位于 PBO 中的任何位置。关键在于你的 CfgMods 块中的 creditsJson 值要指向它的确切路径（在某些平台上区分大小写）。

JSON 结构

该文件使用简单的 JSON 结构，具有三级层次：

json

{
    "Departments": [
        {
            "DepartmentName": "Department Title",
            "Sections": [
                {
                    "SectionName": "Section Title",
                    "SectionLines": ["Person 1", "Person 2"]
                }
            ]
        }
    ]
}

顶级字段

字段	类型	必需	说明
`Departments`	array	是	部门对象数组

原版解析器（JsonDataCredits）只识别 Departments 数组。不存在顶级的 Header 字段——你添加的任何 Header 键都会被静默忽略。要在制作人员名单顶部显示标题，请改用第一个 DepartmentName。

Department 对象

字段	类型	必需	说明
`DepartmentName`	string	是	分类标题文本。可以为空字符串 `""` 以进行无标题的视觉分组。
`Sections`	array	是	该部门内的分类对象数组

Section 对象

字段	类型	必需	说明
`SectionName`	string	是	部门内的子标题
`SectionLines`	array of strings	是	贡献者名称或文本行列表

原版分类类（JsonDataCreditsSection）只识别 SectionName 和 SectionLines。你可能会看到一些 Mod 使用 Names 键，但引擎从不读取它——Names 数组会被静默忽略且不渲染任何内容。请始终使用 SectionLines 来列出名称。

DayZ 如何显示制作人员名单

制作人员名单的显示遵循以下视觉层次：

╔══════════════════════════════════╗
║     DEPARTMENT NAME              ║  <-- DepartmentName（中号，居中）
║                                  ║
║     Section Name                 ║  <-- SectionName（小号，居中）
║     Person 1                     ║  <-- SectionLines（列表）
║     Person 2                     ║
║     Person 3                     ║
║                                  ║
║     Another Section              ║
║     Person A                     ║
║     Person B                     ║
║                                  ║
║     ANOTHER DEPARTMENT           ║
║     ...                          ║
╚══════════════════════════════════╝

每个 DepartmentName 作为主要分类分隔符
每个 SectionName 作为子标题
SectionLines 在制作人员视图中垂直滚动

用空字符串控制间距

Expansion 使用空的 DepartmentName 和 SectionName 字符串，以及 SectionLines 中的纯空白条目来创建视觉间距：

json

{
    "DepartmentName": "",
    "Sections": [{
        "SectionName": "",
        "SectionLines": ["           "]
    }]
}

这是控制制作人员滚动中视觉布局的常用技巧。

使用本地化分类名称

分类名称可以使用 # 前缀引用 stringtable 键，就像 UI 文本一样：

json

{
    "SectionName": "#STR_EXPANSION_CREDITS_SCRIPTERS",
    "SectionLines": ["Steve aka Salutesh", "LieutenantMaster"]
}

当引擎渲染时，它会将 #STR_EXPANSION_CREDITS_SCRIPTERS 解析为与玩家语言匹配的本地化文本。如果你的 Mod 支持多语言并且希望制作人员分类标题被翻译，这很有用。

部门名称也可以使用 stringtable 引用：

json

{
    "DepartmentName": "#legal_notices",
    "Sections": [...]
}

模板

独立开发者

json

{
    "Departments": [
        {
            "DepartmentName": "My Awesome Mod",
            "Sections": [
                {
                    "SectionName": "Developer",
                    "SectionLines": ["YourName"]
                }
            ]
        }
    ]
}

小型团队

json

{
    "Departments": [
        {
            "DepartmentName": "My Mod",
            "Sections": [
                {
                    "SectionName": "Developers",
                    "SectionLines": ["Lead Dev", "Co-Developer"]
                },
                {
                    "SectionName": "3D Artists",
                    "SectionLines": ["Modeler1", "Modeler2"]
                },
                {
                    "SectionName": "Translators",
                    "SectionLines": [
                        "Translator1 (French)",
                        "Translator2 (German)",
                        "Translator3 (Russian)"
                    ]
                }
            ]
        }
    ]
}

完整专业结构

json

{
    "Departments": [
        {
            "DepartmentName": "My Big Mod",
            "Sections": [
                {
                    "SectionName": "Lead Developer",
                    "SectionLines": ["ProjectLead"]
                },
                {
                    "SectionName": "Scripters",
                    "SectionLines": ["Dev1", "Dev2", "Dev3"]
                },
                {
                    "SectionName": "3D Artists",
                    "SectionLines": ["Artist1", "Artist2"]
                },
                {
                    "SectionName": "Mapping",
                    "SectionLines": ["Mapper1"]
                }
            ]
        },
        {
            "DepartmentName": "Community",
            "Sections": [
                {
                    "SectionName": "Translators",
                    "SectionLines": [
                        "Translator1 (Czech)",
                        "Translator2 (German)",
                        "Translator3 (Russian)"
                    ]
                },
                {
                    "SectionName": "Testers",
                    "SectionLines": ["Tester1", "Tester2", "Tester3"]
                }
            ]
        },
        {
            "DepartmentName": "Legal Notices",
            "Sections": [
                {
                    "SectionName": "Licenses",
                    "SectionLines": [
                        "Font Awesome - CC BY 4.0 License",
                        "Some assets licensed under ADPL-SA"
                    ]
                }
            ]
        }
    ]
}

实际示例

MyMod Core

一个最小但完整的制作人员文件：

json

{
    "Departments": [
        {
            "DepartmentName": "MyMod Core",
            "Sections": [
                {
                    "SectionName": "Framework",
                    "SectionLines": ["Documentation Team"]
                }
            ]
        }
    ]
}

Community Online Tools (COT)

使用 SectionLines 变体，包含多个分类和致谢：

json

{
    "Departments": [
        {
            "DepartmentName": "Community Online Tools",
            "Sections": [
                {
                    "SectionName": "Active Developers",
                    "SectionLines": [
                        "LieutenantMaster",
                        "LAVA (liquidrock)"
                    ]
                },
                {
                    "SectionName": "Inactive Developers",
                    "SectionLines": [
                        "Jacob_Mango",
                        "Arkensor",
                        "DannyDog68",
                        "Thurston",
                        "GrosTon1"
                    ]
                },
                {
                    "SectionName": "Thank you to the following communities",
                    "SectionLines": [
                        "PIPSI.NET AU/NZ",
                        "1SKGaming",
                        "AWG",
                        "Expansion Mod Team",
                        "Bohemia Interactive"
                    ]
                }
            ]
        }
    ]
}

值得注意的是：COT 使用第一个 DepartmentName（"Community Online Tools"）作为其标题。Mod 名称也来自其他元数据（config.cpp CfgMods）。

DabsFramework

json

{
    "Departments": [{
        "DepartmentName": "Development",
        "Sections": [{
                "SectionName": "Developers",
                "SectionLines": [
                    "InclementDab",
                    "Gormirn"
                ]
            },
            {
                "SectionName": "Translators",
                "SectionLines": [
                    "InclementDab",
                    "DanceOfJesus (French)",
                    "MarioE (Spanish)",
                    "Dubinek (Czech)",
                    "Steve AKA Salutesh (German)",
                    "Yuki (Russian)",
                    ".magik34 (Polish)",
                    "Daze (Hungarian)"
                ]
            }
        ]
    }]
}

DayZ Expansion

Expansion 展示了 Credits.json 最复杂的用法，包括：

通过 stringtable 引用的本地化分类名称（#STR_EXPANSION_CREDITS_SCRIPTERS）
作为独立部门的法律声明
用于视觉间距的空部门和分类名称
包含数十个名称的支持者列表

常见错误

无效的 JSON 语法

最常见的问题。JSON 对以下内容很严格：

尾部逗号：["a", "b",] 是无效的 JSON（"b" 后面的尾部逗号）
单引号：使用 "双引号"，而不是 '单引号'
未加引号的键：DepartmentName 必须写成 "DepartmentName"

在发布前使用 JSON 验证器。

文件名错误

文件必须准确命名为 Credits.json（大写 C）。在区分大小写的文件系统上，credits.json 或 CREDITS.JSON 将无法被找到。

使用 `Names` 键

一些 Mod 会写 Names 数组，但引擎从不读取它。只有 SectionLines 会被解析：

json

{
    "SectionName": "Developers",
    "Names": ["Dev1"]
}

在此示例中，"Dev1" 永远不会在游戏内出现——该分类渲染为空。请始终在 SectionLines 下列出贡献者。

编码问题

将文件保存为 UTF-8。非 ASCII 字符（重音名称、中日韩字符）需要 UTF-8 编码才能在游戏内正确显示。

最佳实践

在打包到 PBO 之前，使用外部工具验证你的 JSON——引擎对格式错误的 JSON 不会给出有用的错误消息。
对每个名称列表都使用 SectionLines。这是引擎唯一会读取的字段，也是 COT、Expansion 和 DabsFramework 使用的格式。
如果你的 Mod 捆绑了有署名要求的第三方资源（字体、图标、声音），请包含一个"法律声明"部门。
使用第一个 DepartmentName 作为标题，与你的 Mod 在 mod.cpp 和 config.cpp 中的 name 一致，以维护统一的身份标识。
谨慎使用空的 DepartmentName 和 SectionName 字符串来控制视觉间距——过度使用会使制作人员名单看起来支离破碎。

兼容性与影响

多 Mod 共存： 每个 Mod 都有自己独立的 Credits.json。不存在冲突风险——引擎从每个 Mod 的 PBO 内分别读取文件。
性能： 制作人员名单仅在玩家打开 Mod 详情屏幕时加载。文件大小对游戏性能没有影响。

第 5.3 章：Credits.json ​

目录 ​

概述 ​

文件位置 ​

JSON 结构 ​

顶级字段 ​

Department 对象 ​

Section 对象 ​

DayZ 如何显示制作人员名单 ​

用空字符串控制间距 ​

使用本地化分类名称 ​

模板 ​

独立开发者 ​

小型团队 ​

完整专业结构 ​

实际示例 ​

MyMod Core ​

Community Online Tools (COT) ​

DabsFramework ​

DayZ Expansion ​

常见错误 ​

无效的 JSON 语法 ​

文件名错误 ​

使用 Names 键 ​

编码问题 ​

最佳实践 ​

兼容性与影响 ​

第 5.3 章：Credits.json

目录

概述

文件位置

JSON 结构

顶级字段

Department 对象

Section 对象

DayZ 如何显示制作人员名单

用空字符串控制间距

使用本地化分类名称

模板

独立开发者

小型团队

完整专业结构

实际示例

MyMod Core

Community Online Tools (COT)

DabsFramework

DayZ Expansion

常见错误

无效的 JSON 语法

文件名错误

使用 `Names` 键

编码问题

最佳实践

兼容性与影响