Chapitre 5.3 : Credits.json

---

Résumé : Le fichier Credits.json définit les crédits que DayZ affiche pour votre mod dans le menu des mods du jeu. Il liste les membres de l'équipe, les contributeurs et les remerciements organisés par départements et sections. Bien que purement cosmétique, c'est la manière standard de créditer votre équipe de développement.

---

Table des matières

• Vue d'ensemble
• Emplacement du fichier
• Structure JSON
• Comment DayZ affiche les crédits
• Utiliser des noms de section localisés
• Modèles
• Exemples réels
• Erreurs courantes

---

Vue d'ensemble

Lorsqu'un joueur consulte les crédits de votre mod, le moteur charge le fichier dont vous déclarez le chemin dans la clé creditsJson de votre bloc CfgMods dans config.cpp (par exemple, creditsJson = "MyMod/Scripts/Data/Credits.json";). Les crédits sont alors affichés dans une vue défilante organisée en départements et sections --- similaire aux génériques de film.

Le fichier est optionnel. Si vous ne déclarez pas de clé creditsJson, le fichier n'est jamais chargé et aucun crédit n'apparaît pour votre mod. Mais en inclure un est une bonne pratique : cela reconnaît le travail de votre équipe et donne à votre mod une apparence professionnelle.

---

Emplacement du fichier

Placez Credits.json dans un sous-dossier Data de votre répertoire Scripts, ou directement à la racine de Scripts :

@MyMod/
  Addons/
    MyMod_Scripts.pbo
      Scripts/
        Data/
          Credits.json       <-- Emplacement courant (COT, Expansion, DayZ Editor)
        Credits.json         <-- Également valide (DabsFramework, Colorful-UI)

Le fichier peut se trouver n'importe où dans le PBO. Ce qui compte, c'est que la valeur creditsJson de votre bloc CfgMods pointe vers son chemin exact (sensible à la casse sur certaines plateformes).

---

Structure JSON

Le fichier utilise une structure JSON simple avec trois niveaux de hiérarchie :

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

Champs de niveau supérieur

Champ	Type	Requis	Description
Departments	array	Oui	Tableau d'objets département

Le parseur vanilla (JsonDataCredits) ne reconnaît que le tableau Departments. Il n'existe aucun champ Header de niveau supérieur --- toute clé Header que vous ajoutez est silencieusement ignorée. Pour afficher un titre en haut des crédits, utilisez plutôt le premier DepartmentName.

Objet Département

Champ	Type	Requis	Description
DepartmentName	string	Oui	Texte d'en-tête de section. Peut être vide "" pour un regroupement visuel sans en-tête.
Sections	array	Oui	Tableau d'objets section dans ce département

Objet Section

Champ	Type	Requis	Description
SectionName	string	Oui	Sous-en-tête dans le département
SectionLines	array de strings	Oui	Liste des noms de contributeurs ou lignes de texte

La classe de section vanilla (JsonDataCreditsSection) ne reconnaît que SectionName et SectionLines. Vous pouvez voir certains mods utiliser une clé Names, mais le moteur ne la lit jamais --- un tableau Names est silencieusement ignoré et n'affiche rien. Utilisez toujours SectionLines pour la liste des noms.

---

Comment DayZ affiche les crédits

L'affichage des crédits suit cette hiérarchie visuelle :

╔══════════════════════════════════╗
║     DEPARTMENT NAME              ║  <-- DepartmentName (moyen, centré)
║                                  ║
║     Section Name                 ║  <-- SectionName (petit, centré)
║     Person 1                     ║  <-- SectionLines (liste)
║     Person 2                     ║
║     Person 3                     ║
║                                  ║
║     Another Section              ║
║     Person A                     ║
║     Person B                     ║
║                                  ║
║     ANOTHER DEPARTMENT           ║
║     ...                          ║
╚══════════════════════════════════╝

• Chaque DepartmentName agit comme un séparateur de section majeure
• Chaque SectionName agit comme un sous-titre
• SectionLines défile verticalement dans la vue des crédits

Chaînes vides pour l'espacement

Expansion utilise des chaînes vides pour DepartmentName et SectionName, ainsi que des entrées composées uniquement d'espaces dans SectionLines, pour créer un espacement visuel :

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

C'est une astuce courante pour contrôler la mise en page visuelle dans le défilement des crédits.

---

Utiliser des noms de section localisés

Les noms de section peuvent référencer des clés de stringtable en utilisant le préfixe #, tout comme le texte d'interface :

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

Lorsque le moteur affiche ceci, il résout #STR_EXPANSION_CREDITS_SCRIPTERS vers le texte localisé correspondant à la langue du joueur. C'est utile si votre mod prend en charge plusieurs langues et que vous souhaitez que les en-têtes de section des crédits soient traduits.

Les noms de département peuvent également utiliser des références stringtable :

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

---

Modèles

Développeur solo

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

Petite équipe

{
    "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)"
                    ]
                }
            ]
        }
    ]
}

Structure professionnelle complète

{
    "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"
                    ]
                }
            ]
        }
    ]
}

---

Exemples réels

MyMod Core

Un fichier de crédits minimal mais complet :

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

Community Online Tools (COT)

Utilise la variante SectionLines avec plusieurs sections et remerciements :

{
    "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"
                    ]
                }
            ]
        }
    ]
}

À noter : COT utilise le premier DepartmentName (« Community Online Tools ») comme titre. Le nom du mod provient également d'autres métadonnées (config.cpp CfgMods).

DabsFramework

{
    "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 démontre l'utilisation la plus sophistiquée de Credits.json, incluant :

• Des noms de section localisés via des références stringtable (#STR_EXPANSION_CREDITS_SCRIPTERS)
• Des mentions légales en tant que département séparé
• Des noms de département et de section vides pour l'espacement visuel
• Une liste de supporters avec des dizaines de noms

---

Erreurs courantes

Syntaxe JSON invalide

Le problème le plus courant. Le JSON est strict concernant :

• Virgules finales : ["a", "b",] est du JSON invalide (la virgule finale après "b")
• Guillemets simples : Utilisez "guillemets doubles", pas 'guillemets simples'
• Clés sans guillemets : DepartmentName doit être "DepartmentName"

Utilisez un validateur JSON avant la publication.

Mauvais nom de fichier

Le fichier doit être nommé exactement Credits.json (C majuscule). Sur les systèmes de fichiers sensibles à la casse, credits.json ou CREDITS.JSON ne seront pas trouvés.

Utiliser la clé Names

Certains mods écrivent un tableau Names, mais le moteur ne le lit jamais. Seul SectionLines est analysé :

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

Dans cet exemple, « Dev1 » n'apparaît jamais en jeu --- la section s'affiche vide. Listez toujours les contributeurs sous SectionLines.

Problèmes d'encodage

Enregistrez le fichier en UTF-8. Les caractères non-ASCII (noms accentués, caractères CJK) nécessitent un encodage UTF-8 pour s'afficher correctement en jeu.

---

Bonnes pratiques

• Validez votre JSON avec un outil externe avant de le packer dans un PBO -- le moteur ne donne aucun message d'erreur utile pour du JSON malformé.
• Utilisez SectionLines pour chaque liste de noms. C'est le seul champ que le moteur lit, et c'est le format utilisé par COT, Expansion et DabsFramework.
• Incluez un département « Legal Notices » si votre mod contient des ressources tierces (polices, icônes, sons) avec des exigences d'attribution.
• Utilisez le premier DepartmentName comme titre correspondant au name de votre mod dans mod.cpp et config.cpp pour une identité uniforme.
• Utilisez les chaînes vides DepartmentName et SectionName avec parcimonie pour l'espacement visuel -- un usage excessif rend les crédits fragmentés.

---

Compatibilité et impact

• Multi-Mod : Chaque mod possède son propre fichier Credits.json indépendant. Il n'y a aucun risque de collision -- le moteur lit le fichier depuis chaque PBO de mod séparément.
• Performance : Les crédits ne sont chargés que lorsque le joueur ouvre l'écran de détails du mod. La taille du fichier n'a aucun impact sur les performances en jeu.