Skip to content

Supported features for imported assets

Lassi Säike edited this page Sep 21, 2023 · 5 revisions

This page lists features of imported assets that are converted into Blender for Plumber 1.0. The supported features are grouped by asset types.

Maps (.vmf)

Supported

  • Brushes
  • Displacements
    • Vertex alpha for blended materials (imported as vertex color)
  • Overlays
  • Props
    • Position, rotation, scale
    • Animations
    • Prop color (imported as object color)
  • Materials
  • Lights
    • Point lights
    • Spotlights
    • Environment light
    • Position, rotation
    • Approximate brightness
    • Light color
  • Sky camera
    • Position, scale
  • Other unsupported entities can be imported as empty objects
    • Position, rotation, scale

Unsupported

  • Prop skins
  • Prop secondary UV map (CSGO only)
  • Infodecals
  • Ropes
  • Cubemaps
  • Sound-related entities
  • Game specific entities (such as TF2 health)
  • Other entities not mentioned in Supported-section

Models (.mdl)

Supported

  • MDL version 44-49 (most, if not all, Source1 models)
  • Meshes
    • Vertices
    • Faces
    • Normals
    • Bone weights
  • Bones
  • Embedded animations
    • Looping animations (imported with Cyclic modifier in Blender)
  • Materials

Unsupported

  • External animations (.ani files)
  • Flex animation (shape keys)
  • Model skins
  • Secondary UV map (CSGO only)

Materials (.vmt)

Supported special types

Some materials are handled with special handlers, which support the following parameters:

  • Water, enabled by %compilewater
    • $normalmap
    • $bumptransform
    • $fogenable
    • $fogcolor
  • Nodraw (invisible) material, any of the following parameters enables this:
    • %compilenodraw
    • %compileinvisible
    • %compilehint
    • %compileskip
    • %compilesky
    • %compile2dsky
    • %compiletrigger
    • %compileorigin
    • %compilefog
    • %compilenpcclip
    • %compileplayerclip
    • %compiledroneclip
    • %compilegrenadeclip
    • %compileclip
    • $no_draw

Supported parameters

Most shaders are handled with a generic handler, which supports parameters of VerteLitGeneric, LightmappedGeneric, UnlitGeneric, WorldVertexTransition, Lightmapped_4WayBlend and Character shaders, and also works with most other shaders.

  • $addbumpmaps
  • $allowalphatocoverage
  • $allowdiffusemodulation
  • $alpha
  • $alphatest
  • $alphatestreference
  • $basealphaenvmapmask
  • $basealphaenvmask
  • $basemapalphaphongmapmask
  • $basemapluminancephongmapmask
  • $basetexture
  • $basetexture2
  • $basetexturetransform
  • $basetexturetransform2
  • $blendmasktransform
  • $blendmodulatetexture
  • $blendtintbybasealpha
  • $bumpdetailscale1
  • $bumpdetailscale2
  • $bumpmap
  • $bumpmap2
  • $bumptransform
  • $bumptransform2
  • $color
  • $color2
  • $decal
  • $detail
  • $detail2
  • $detailblendfactor
  • $detailblendfactor2
  • $detailblendmode 0 or 10, other modes unsupported
  • $detailscale
  • $detailscale2
  • $detailtexturetransform
  • $detailtexturetransform2
  • $envmap
  • $envmapintintmasktexture
  • $envmapmask
  • $envmapmasktransform
  • $envmaptint
  • $masks1 (phong and metalness only)
  • $metalness
  • $nocull
  • $normalmapalphaenvmapmask
  • $notint
  • $phong
  • $phongalbedotint
  • $phongexponent
  • $phongexponent2
  • $phongexponenttexture
  • $phongexponenttexture2
  • $selfillum
  • $selfillum_envmapmask_alpha
  • $selfillummask
  • $ssbump
  • $tintmasktexture
  • $tintmasktexture
  • $translucent
  • $vertexalpha
  • $vertexcolor
  • %compilenolight

Unsupported shaders

  • DecalModulate
  • EyeRefract
  • Other special shaders, most likely

Textures (.vtf)

Supports importing single-frame textures.

Multi-frame textures and volumetric textures are not supported.