Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/h2xdev/godotvmf
A VMF importer for Godot Engine/Redot Engine
https://github.com/h2xdev/godotvmf
godot godotengine redotengine vmf
Last synced: about 6 hours ago
JSON representation
A VMF importer for Godot Engine/Redot Engine
- Host: GitHub
- URL: https://github.com/h2xdev/godotvmf
- Owner: H2xDev
- License: mit
- Created: 2024-02-14T23:37:25.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2024-12-15T09:57:14.000Z (7 days ago)
- Last Synced: 2024-12-15T10:31:36.052Z (7 days ago)
- Topics: godot, godotengine, redotengine, vmf
- Language: GDScript
- Homepage:
- Size: 36.5 MB
- Stars: 146
- Watchers: 10
- Forks: 7
- Open Issues: 5
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
GodotVMF
## Description
An importer of [VMF files](https://developer.valvesoftware.com/wiki/VMF_(Valve_Map_Format)) into [Godot Engine](https://godotengine.org/) or [Redot Engine](https://redotengine.org/).
Highly recommended to use [Hammer++](https://ficool2.github.io/HammerPlusPlus-Website/) since it supports precised vertex data.
## Why?
We with my friend [Ambiabstract](https://github.com/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.
## Usage
- [Installation instruction and other documents](https://github.com/H2xDev/GodotVMF/wiki)
- [Project Template](https://github.com/H2xDev/GodotVMF-Project-Template) (example project)
- [How to import VMF (video tutorial)](https://youtu.be/uTBzx0bwizU)
## Features
- Brushes geometry import (including UVs, materials IDs and smoothing groups)
- Instances support
- Models import (requires 3rd party utility [MDL2OBJ](/mdl2obj), included in the repository)
- Materials import
- Displacements import (with vertex data)
- WorldVertexTransition materials (blend textures) will be imported as [`WorldVertexTransitionMaterial`](/addons/godotvmf/shaders/WorldVertexTransitionMaterial.gd)
- Entities support
- Hammer's Input/Output system support
- Native VTF import (supported VTF formats: DXT1, DXT3, DXT5)
## Known issues
- Extraction of materials and models from VPKs is not supported
- Some of imported models may have wrong orientation
- New MDLs (from CS:GO an so on) is not supported
## 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.
- Follow the common Godot codestyle (yea-yea i'll fix the existing code in upcoming updates).
### How to take part in testing
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
## Additional things
- Source code of MDL2OBJ: https://github.com/H2xDev/mdl2obj
- Demo (video): https://www.youtube.com/watch?v=5XYfvbIAlJU
- [Echo Point](https://www.youtube.com/watch?v=z7LcKb0XRzY). A game made with this tool
## Credits
[H2xDev](https://github.com/H2xDev) - main contributor
[Ambiabstract](https://github.com/Ambiabstract) - tech help and inspiration
[MyCbEH](https://github.com/MyCbEH) - level design for [example project](https://github.com/H2xDev/GodotVMF-Project-Template)
[Lachrymogenic](https://github.com/Lachrymogenic) - Linux test, performance test
[SharkPetro](https://github.com/SharkPetro) - materials test
## License
MIT