Skip to content

A VMF/MDL/VTF/VMT importer for Godot Engine

License

H2xDev/GodotVMF

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GodotVMF

Discord Godot Asset Library Godot Asset Store

Description

An importer of VMF files into Godot Engine.

Highly recommended to use Hammer++ since it supports precised vertex data.

Features

  • Brushes geometry import (including UVs, materials IDs and smoothing groups)
  • Instances support
  • Native MDL support
  • Native VMT support
  • Native VTF support (only DXT1, DXT3, DXT5 supported)
  • Displacements import (with vertex data)
  • Entities support
  • Hammer's Input/Output system support
  • Surface props support
  • Material's compile properties support
  • FGD generator that compiles a FGD file based on source code of implemented entities in GDScript (see here)

Why?

We with my friend Ambiabstract did not find a convenient plugin for us to create levels for Godot and so we decided to use our favorite and familiar editor :)

A useful tool for those who like making levels in Hammer and are making a project on the Godot. Or for those who just want to port their map from Source Engine to Godot and see what happens.

Installation and Usage

Made with this tool

Known issues

  • Extraction of materials and models from VPKs is not supported
  • Some of imported models may have wrong orientation
    • Use Additional Rotation property in the MDL import options
  • Avoid importing a big bunch of models/materials at once it may cause the engine crash or import freeze. There's some issue with threaded import in the engine.

Legality of use

If you would like to use the Source Engine SDK or other Valve Developer Tools for commercial use, please contact Valve at sourceengine@valvesoftware.com. There shouldn’t be any issues if you’re using it for non-commercial projects.

Contribution

If you have some ideas, suggestions regarding to quality or solutions of the problems above, feel free to contribute!

  • If you've added a new feature please add the relevant documentation.
  • Add yourself to the contributors section below

How to test the addon after adding new features or fixing some bugs

  1. Install any of Source Engine Games (L4D, HL2, TF2)
  2. Unpack all textures and models from VPKs
  3. Decompile most complex maps
  4. Try to import decompiled maps in Godot
  5. Check for errors if they appear

Credits

H2xDev - main contributor
Ambiabstract - tech help and inspiration
Lachrymogenic - linux test, performance test
SharkPetro - materials test

Contributors

Mickeon URAKOLOUY5 ckaiser jamop4

License

MIT