Valve Hammer FGD Editor

Doel en gebruiker: Deze tool biedt een toegewijde parser-, validator- en generator-workflow voor Valve Hammer Editor FGD-bestanden.
Doelgebruikers zijn level-ontwerpers, modders en tooling-engineers die FGDs aanmaken of bijwerken om entiteitsklassen, keyvalues en gedragskenmerken te definiëren die door Source-engine-kaarten worden gebruikt. Het adresseert structurele fouten, ongeldige sleutels en inconsistente definities die iteratie vertragen en kaartbouw-mislukkingen veroorzaken.
Kernlogica & functies: De tool parseert FGD-tekst, bouwt een interne representatie en handhaaft domeinspecifieke regels zoals vereiste blokken (entiteiten, eigenschappen) en geldige sleutel-namen. Vereiste features omvatten FGD_text-invoer, engine_version-bewustzijn en optionele batchverwerking. Geavanceerde functies omvatten afhankelijkheidscontroles, kruisveldvalidatie en auto-fix-suggesties. Uitgangen omvatten een gevalideerde ontwerptekst, een foutrapport en een diff die geschikt is voor versiebeheer.
Algoritmen & berekeningen: Parsing volgt de FGD-grammatica, tokenisatie en blokvalidatie. Het handhaaft naamgevingsconventies, controleert op ontbrekende vereiste blokken en valideert kruisveld verwijzingen (entiteit naar eigenschap-mappingen). Indien beschikbaar berekent het minimale veilige wijzigingen en geeft een gestructureerde diff uit om beoordeling te vergemakkelijken. Fout-niveaus onderscheiden fataal, fout en waarschuwing.
Fouten & randgevallen: Omgaan met ontbrekende invoer, lege FGD-inhoud, onbekende sleutels, verouderde blokken en engine_version-mismatches. Als externe referenties niet zijn opgelost of encoding ongeldig is, meldt het precieze locaties en correctiesuggesties. Grote FGDs worden verwerkt via streaming-passages om geheugenverbruik te minimaliseren.
Industrie/Regio & Lokalisatie: Volgt Source Engine-dataconventies en UTF-8-tekstcodering. Engine_version en target_game ondersteunen gangbare regionale builds; content wordt niet verder gelokaliseerd dan metadata.
Aannames & Uitsluitingen: Gaat uit van tekstuele FGD-definities voor Source-era-entiteiten. Compileert geen kaarten, wijzigt geen textures of runtime-assets. UI-weergave- of editor-integratie details vallen buiten de scope.