Skip to content

[Format]: Source engine / Garry's Mod files (.gma, .vpk, .bsp, .mdl, .smd) #1526

Open

Description

@ltsammy

File extension

.gma, .vpk, .bsp, .mdl (with its .vvd / .vtx), .smd

What makes these files?

Garry's Mod and other Source engine games and tools (gmad, Valve's vpk tool, Hammer/VBSP, studiomdl, Crowbar, Blender Source Tools)

Who works with these files?

Game modders (Garry's Mod and other Source engine games)

What should Filee convert them to?

GMA <-> folder/ZIP; VPK and BSP (packed files) -> folder/ZIP; MDL -> OBJ/GLB/STL (with its VTF textures) and SMD; SMD <-> OBJ/GLB

Anything else?

Follow-up to #1478 / #1483 (VTF). These are the other files Garry's Mod modders deal with every day. Today each needs its own tool (gmad, GCFScape, Crowbar, VIDE…), most of them Windows-only and unmaintained.

I'm already working on a pull request that adds them all at once, one commit per format, and will link it here:

  • GMA (Garry's Mod addon, Workshop): unpack to a folder or ZIP, and pack a folder back into a .gma as gmad does. That means addon.json for the title, type and tags, plus gmad's whitelist and ignore list.
  • VPK (Valve pak, _dir.vpk with its _000.vpk… parts): unpack to a folder or ZIP.
  • BSP (Source map): unpack the files packed into the map (the pakfile lump: custom textures, models, sounds) to a folder or ZIP.
  • MDL (Source model, read with its .vvd and .dx90.vtx): to OBJ, GLB, STL and the other 3D formats as a static mesh in its bind pose. The textures are found automatically through the VMT/VTF files in the addon's materials/ folder, using the VTF reader from feat(image): read and write Valve textures (VTF) for Garry's Mod and … #1483.
  • SMD (Valve's studiomdl source format): MDL → SMD as a reference mesh with skeleton and weights; other models ↔ SMD as static props.

All of it in managed code, with no new packages. Open-source references for the layouts: Facepunch/gmad, srctools, SourceIO and Crowbar.

Protection

  • These files aren't encrypted or copy-protected (DRM), and I can open them without a password.

Activity

  1. 8 remaining items

  2. KnifeLemon commented on Nov 17, 2026

    @KnifeLemon
    Owner

    An update on where this stands, @ltsammy:

    Merged into main (in the next release):

    Still open:

    This stays open until MDL and SMD are in.

  3. KnifeLemon commented on Nov 17, 2026

    @KnifeLemon
    Owner

    Follow-up: #1611 (the "VTF" preset, settings schema 98) is merged too, so it's in the next release with #1591 and #1608.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    formatsNew formats and engines

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions