Éditeur FGD Valve Hammer

But et intention des utilisateurs : cet outil propose un flux de travail dédié de parseur, validateur et générateur pour les FGDs de Valve Hammer Editor.
Public visé : les level designers, modders et ingénieurs outils qui créent ou mettent à jour des FGDs pour définir des classes d'entités, keyvalues et propriétés de comportement utilisées par les cartes Source. Il corrige les erreurs structurelles, les clés invalides et les définitions incohérentes qui ralentissent l’itération et provoquent des échecs de build de carte.
Logique centrale et fonctionnalités : l’outil parse le texte FGD, construit une représentation interne et applique des règles du domaine telles que blocs obligatoires (entités, propriétés) et noms de clés valides. Les fonctionnalités requises incluent FGD_text, prise en charge de engine_version et traitement par lots optionnel. Les fonctionnalités avancées couvrent vérifications de dépendances, validation croisée et suggestions d’auto-correction. Sorties : brouillon validé, rapport d’erreurs et diff adapté au contrôle de version.
Algorithmes & Calculs : l’analyse suit la grammaire FGD, la tokenisation et la validation des blocs. Il applique les conventions de nommage, vérifie les blocs obligatoires manquants et valide les références croisées (entité → mappage de propriété). Lorsqu’elle est disponible, il calcule les changements minimaux sûrs et émet un diff structuré. Les niveaux d’erreur distinguent fatal, erreur et avertissement.
Erreurs & cas limites : gestion des entrées manquantes, contenu FGD vide, clés inconnues, blocs dépréciés et incohérences engine_version. En cas de références externes non résolues ou encodage invalide, il indique les emplacements et corrections proposées. De gros FGDs sont traités par passes en streaming pour minimiser l’utilisation de mémoire.
Secteur/Région & Localisation : suit les conventions de données de Source Engine et l’encodage UTF-8. engine_version et target_game supportent les versions régionales courantes ; aucune localisation de contenu au-delà des métadonnées.
Hypothèses & exclusions : suppose des définitions FGD textuelles des entités de l’ère Source. Ne compile pas les cartes, ne modifie pas les textures et n’altère pas les actifs runtime. Les détails d’intégration UI/éditeur ne sont pas couverts.