{"id":14961528,"url":"https://github.com/h2xdev/godotvmf","last_synced_at":"2025-11-17T12:01:12.068Z","repository":{"id":223008743,"uuid":"757765936","full_name":"H2xDev/GodotVMF","owner":"H2xDev","description":"A VMF importer for Godot Engine/Redot Engine","archived":false,"fork":false,"pushed_at":"2025-04-03T17:31:22.000Z","size":38306,"stargazers_count":186,"open_issues_count":1,"forks_count":7,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-04T18:04:16.136Z","etag":null,"topics":["godot","godotengine","redotengine","source-engine","sourceengine","vmf"],"latest_commit_sha":null,"homepage":"","language":"GDScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/H2xDev.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-14T23:37:25.000Z","updated_at":"2025-04-04T15:05:47.000Z","dependencies_parsed_at":"2024-03-06T12:29:01.557Z","dependency_job_id":"eeed073a-26da-4a24-9d42-5a6e9f64f029","html_url":"https://github.com/H2xDev/GodotVMF","commit_stats":{"total_commits":131,"total_committers":4,"mean_commits":32.75,"dds":0.1145038167938931,"last_synced_commit":"019788143f2193dd80f3ce48f25c6355d8af820f"},"previous_names":["h2xdev/godotvmf"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/H2xDev%2FGodotVMF","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/H2xDev%2FGodotVMF/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/H2xDev%2FGodotVMF/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/H2xDev%2FGodotVMF/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/H2xDev","download_url":"https://codeload.github.com/H2xDev/GodotVMF/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247226213,"owners_count":20904465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["godot","godotengine","redotengine","source-engine","sourceengine","vmf"],"created_at":"2024-09-24T13:25:32.537Z","updated_at":"2025-11-17T12:01:11.947Z","avatar_url":"https://github.com/H2xDev.png","language":"GDScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/e1959708-fc5a-4245-aed4-5b7f3044aada\" width=\"10%\" /\u003e\n\u003c/p\u003e\n\n\u003ch2 align=\"center\"\u003e GodotVMF \u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://discord.gg/wtSK94fPxd\" target=\"_blank\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Get%20Support%20in%20Discord-%235865F2?style=for-the-badge\u0026logo=discord\u0026logoColor=white\u0026text=get-support\" alt=\"Discord\"\u003e\u003c/a\u003e\n\n\u003ca href=\"https://godotengine.org/asset-library/asset/2605\" target=\"_blank\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/asset_library-%23EEEEEE.svg?style=for-the-badge\u0026logo=godot-engine\" alt=\"Godot Asset Library\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Description\nAn 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/).  \n\nHighly recommended to use [Hammer++](https://ficool2.github.io/HammerPlusPlus-Website/) since it supports precised vertex data.\n\n\u003cimg src=\"https://github.com/user-attachments/assets/21084c3e-3530-45e5-8e05-d669d2a3ecf1\" width=\"100%\" /\u003e\n\n## Why?\nWe 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 :)\n\nA useful tool for those who like making levels in Hammer and are making a project on the Godot.\nOr for those who just want to port their map from Source Engine to Godot and see what happens.\n\n## Usage\n- [Documentation](https://github.com/H2xDev/GodotVMF/wiki)\n\n## Features\n- Brushes geometry import (including UVs, materials IDs and smoothing groups)\n- Instances support\n- Native MDL support\n- Native VMT support\n- Native VTF support (only DXT1, DXT3, DXT5 supported)\n- Displacements import (with vertex data)\n\t- WorldVertexTransition materials (blend textures) will be imported as [`WorldVertexTransitionMaterial`](/addons/godotvmf/shaders/WorldVertexTransitionMaterial.gd)\n- Entities support\n- Hammer's Input/Output  system support\n- Automatically generates SteamAudioGeometry in case [godot-steam-audio](https://github.com/stechyo/godot-steam-audio) plugin detected\n- Surface props support\n- Material's compile properties support\n- FGD generator that compiles a FGD file based on source code of implemented entities in GDScript (see [here](https://github.com/H2xDev/GodotVMF/wiki/FGD-Generation))\n\n## Known issues\n- Extraction of materials and models from VPKs is not supported\n- Some of imported models may have wrong orientation\n    - Use `Additional Rotation` property in the MDL import options\n- Avoid importing a big bunch of models/materials at once it may cause the engine crash or import freeze. There's some issues with threaded import in the engine.\n\n## Legality of use\nIf you are going to use Hammer Editor for commercial purpose it's worth to asking Valve for permission to use their tool. There shouldn't be any problems if you are using this tool for non-commercial projects.\n\n## Contribution\nIf you have some ideas, suggestions regarding to quality or solutions of the problems above, feel free to contribute!\n- If you've added a new feature please add the relevant documentation.\n- Follow the common Godot codestyle (yea-yea i'll fix the existing code in upcoming updates).\n\n### How to test the addon after adding new features or fixing some bugs\n1. Install any of Source Engine Games (L4D, HL2, TF2)\n2. Unpack all textures and models from VPKs\n3. Decompile most complex maps\n4. Try to import decompiled maps in Godot\n5. Check for errors if they appear\n\n\n## Additional things\n- Demo (video): https://www.youtube.com/watch?v=5XYfvbIAlJU\n- [Echo Point](https://www.youtube.com/watch?v=z7LcKb0XRzY). A game made with this tool\n\n## Credits\n[H2xDev](https://github.com/H2xDev) - main contributor  \n[Ambiabstract](https://github.com/Ambiabstract) - tech help and inspiration  \n[MyCbEH](https://github.com/MyCbEH) - level design for [example project](https://github.com/H2xDev/GodotVMF-Project-Template), UAZ model  \n[Lachrymogenic](https://github.com/Lachrymogenic) - Linux test, performance test  \n[SharkPetro](https://github.com/SharkPetro) - materials test  \n\n## License\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh2xdev%2Fgodotvmf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fh2xdev%2Fgodotvmf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh2xdev%2Fgodotvmf/lists"}