Valve Hammer FGD Editor

Formål og brugere: Dette værktøj tilbyder en dedikeret parser-, validator- og generator-workflow for Valve Hammer Editor FGD-filer.
Målgruppe inkluderer levels-designere, moddere og tooling-ingeniører, der forfatter eller opdaterer FGDs for at definere entitetskategorier, keyvalues og adfærds-egenskaber, som anvendes af Source Engine-kort. Det adresserer strukturelle fejl, ugyldige keys og inkonsekvente definitioner, der bremser iteration og forårsager kortbygge-fejl.
Kerne-logik og funktioner: Værktøjet parser FGD-tekst, bygger en intern repræsentation og håndhæver domænerelaterede regler såsom påkrævede blokke (entiteter, egenskaber) og gyldige nøgle-navne. Påkrævede funktioner inkluderer FGD_text-input, engine_version-bevidsthed og valgfri batch-behandling. Avancerede funktioner dækker afhængighedstjek, korsfelt-validering og auto-fix-forslag. Output omfatter et valideret udkast, en fejlrapport og en diff, der egner sig til versionskontrol.
Algoritmer & beregninger: Parsning følger FGD-syntaks, tokenisering og blok-validering. Den håndhæver navngivningskonventioner, kontrollerer manglende påkrævede blokke og validerer korsfelt-referencer (entitet til egenskabs-mappning). Når tilgængelig, beregner den minimale sikre ændringer og udsteder en struktureret diff til gennemgang. Fejlniveauer skelner mellem fatalt, fejl og advarsel.
Fejl & kanttilfælde: Håndtering af manglende input, tomt FGD-indhold, ukendte keys, forældede blokke og engine_version-mismatch. Hvis eksterne referencer ikke løses eller filkodningen er ugyldig, rapporterer den præcise steder og korrigeringsforslag. Store FGDs behandles i streaming-passager for at minimere hukommelsesforbrug.
Industri/Region & Lokalisering: Følger Source Engine-datakonventioner og UTF-8-tekstkodning. Engine_version og target_game understøtter almindelige regionale builds; indhold lokales ikke ud over metadata.
Forudsætninger & Udelukkelser: Forudsætter tekstuelle FGD-definitioner for Source-æra-entiteter. Kompilerer ikke kort, ændrer ikke teksturer eller runtime-aktiver. UI-rendering eller editor-integrationsdetaljer er udenfor omfanget.