FGD-TOOLS IS DEPRECATED: development is continuing at https://github.com/pySourceSDK/ValveFGD
Fgd-tools is a Python library for parsing .fgd files for the Source Engine level editor Hammer. It provides entity schemas and other level editor configuration information.
Full documentation: https://maxdup.github.io/fgd-tools/
Fgd-tools is available on the Python Package Index. This makes installing it with pip as easy as:
pip3 install fgdtoolsIf you want the latest code or even feel like contributing, the code is available on GitHub.
You can easily clone the code with git:
git clone git://github.com/maxdup/fgd-tools.gitand install it with:
python3 setup.py installHere's a few example usage of fgd-tools
You can get a Fgd object by parsing an .fgd file using FgdParse
>>> from fgdtools import FgdParse
>>> fgd = FgdParse('C:/Program Files (x86)/Steam/steamapps/common/Team Fortress 2/bin/tf.fgd')You can write an .fgd file from a Fgd object.
Parsing/writing is destructive. Comments will be lost. The original structure of the file may be altered. The actual data about entities and the inheritance hierarchy is untouched however.
>>> from fgdtools import FgdWrite
>>> FgdWrite(fgd, 'tf-clone.fgd')You can get entity schematics from an Fgd object.
>>> env_fire = fgd.entity_by_name('env_fire')
>>> print(env_fire.schema)
{'properties': {'targetname': {'type': 'string', 'description': 'The name...'}, ...},
'inputs': {'StartFire': {'type': 'void', 'description': 'Start the fire'}, ...},
'outputs': {'onIgnited': {'type': 'void', 'description':'Fires when...'}, ...}}Here are some color coded charts for the terminology used in this library for fgd files.
