Editor FGD Valve Hammer

Scopo e pubblico: questo strumento offre un flusso di lavoro dedicato di parser, validatore e generatore per i file FGD di Valve Hammer Editor.
Utenti target includono designer di livelli, modder e ingegneri degli strumenti che creano o aggiornano FGDs per definire classi di entità, chiavi-valore e proprietà di comportamento utilizzate dalle mappe Source. Affronta errori strutturali, chiavi non valide e definizioni incoerenti che rallentano l’iterazione e causano errori di build.
Logica centrale e funzionalità: lo strumento analizza il testo FGD, costruisce una rappresentazione interna e applica regole di dominio come blocchi richiesti (entità, proprietà) e nomi di chiavi validi. Le funzionalità richieste includono input FGD_text, consapevolezza engine_version e batch opzionale. Funzionalità avanzate includono controlli di dipendenza, validazione incrociata e suggerimenti di auto-correct. Le uscite includono una bozza validata, un report di errori e un diff adatto al controllo di versione.
Algoritmi e Calcoli: l’analisi segue la grammatica FGD, tokenizzazione e validazione dei blocchi. Applica convenzioni di nomenclatura, verifica blocchi obbligatori mancanti e valida riferimenti incrociati (mappature entità-proprietà). Se disponibile, calcola cambiamenti minimi sicuri ed emette un diff strutturato per la revisione. I livelli di gravità degli errori distinguono fatale, errore e avviso.
Errori & Casi limite: Gestisce input mancanti, contenuto FGD vuoto, chiavi sconosciute, blocchi deprecati e incongruenze engine_version. Se riferimenti esterni non risolvono o la codifica è invalida, segnala posizioni precise e correzioni suggerite. FGDs grandi vengono processati in streaming per minimizzare l’uso di memoria.
Settore/Regione & Localizzazione: Segue le convenzioni dati Source Engine e la codifica UTF-8. engine_version e target_game supportano build regionali comuni; non si effettua localizzazione del contenuto oltre i metadata.
Assunzioni: si assumono definizioni FGD testuali per entità dell’epoca Source. Non compila mappe, non modifica texture o asset runtime. Dettagli UI/editor non inclusi.