/DragonFF

Tools to edit GTA Formats in Blender

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

DragonFF 🐉

DragonFF is a Blender Addon for import and export of GTA files.

At the moment, only Renderware files are supported. Support for formats other than .dff is planned.

Supported Features

The following is a list of supported features by the addon

File Types

  • Model files
  • Texture Files
  • Collision files (including the ones packed in dff)
    • Import
    • Export (Partial)
  • Map files (.ipl, .ide)
    • Import (Partial, experimental)
    • Export
  • Animation files

Model Features

  • Skinned mesh support
  • Multiple UV Maps
  • Mass export
  • Material Effects
    • Environment/Normal Maps
    • Dual Textures
    • UV Animation
  • Rockstar Specular and Reflection Extensions
  • 2D Effects

Installation

  1. Get a release from the Releases for a stable release, or the bleeding-edge script by cloning the repository
  2. Import the downloaded .zip file by selecting it from (User) Preferences/Addons/Install from File
  3. Set the addon "GTA DragonFF" to enabled
  4. Import dff from Import tab or an IPL/IFP from the panel in Scene Settings

Python Module

The python scripts have been designed with reusability in mind. As of now, the dff module is standalone, and can be used with any other Python instance without the need for Blender API.

Standalone Modules

  • - DFF - dff.py
  • - TXD - txd.py
  • - COL - col.py
  • - IPL/IDE - map.py (partial, experimental)
  • - IFP - ifp.py

Contributors

The following have contributed significantly to the project: