Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ZeqMacaw/Crowbar/llms.txt

Use this file to discover all available pages before exploring further.

Crowbar stores all of its persistent state in an XML file named Crowbar Settings.xml, located in the user’s application data folder at %APPDATA%\ZeqMacaw\Crowbar <version>\. The file is created automatically on first launch with default values, and updated every time Crowbar closes normally. Settings cover window geometry, the last-used paths for each tab, per-tab processing options, game profiles, and Steam configuration. You can back this file up or share it between machines.
Settings are written to disk automatically when Crowbar exits. If the process is killed unexpectedly, any changes made during that session may not be saved.

Settings File Location

The settings file path is constructed at runtime as:
%APPDATA%\ZeqMacaw\Crowbar <major>.<minor>\Crowbar Settings.xml
For example, for Crowbar 0.74:
C:\Users\<YourName>\AppData\Roaming\ZeqMacaw\Crowbar 0.74\Crowbar Settings.xml

Window & Application

These settings control the main window position and state restored at startup.
SettingTypeDefaultDescription
WindowLocationPoint0, 0Top-left position of the main window on screen
WindowSizeSize800 × 600Width and height of the main window
WindowStateFormWindowStateNormalWindow state: Normal, Maximized, or Minimized
MainWindowSelectedTabIndexInteger0Index of the last active tab (0 = Set Up Games)
AppIsSingleInstanceBooleanfalseWhen true, only one Crowbar process is allowed at a time

Decompile Settings

Settings for the Decompile tab — input paths, output locations, file-generation options, and the MDL version override.
SettingDefaultDescription
DecompileMdlPathFileName""Last-used MDL input file or folder path
DecompileOutputFolderOptionWorkFolderOutput location mode: Work folder or Subfolder (of MDL input)
DecompileOutputSubfolderName"decompiled <ver>"Name of the auto-created subfolder when using Subfolder mode
DecompileOutputFullPathDocuments folderCustom absolute output path
DecompileModeFileInput mode: File, Folder, or Folder and subfolders
DecompileFolderForEachModelIsCheckedfalseCreate a separate output subfolder for each model
DecompileStricterFormatIsCheckedfalseWrite SMD files in a stricter format for maximum compatibility
DecompileLogFileIsCheckedfalseWrite a decompile log file alongside the output
DecompileOverrideMdlVersionDoNotOverrideForce Crowbar to parse the MDL as a specific version
DecompileQcFileIsCheckedtrueGenerate a .qc script file
DecompileGroupIntoQciFilesIsCheckedfalseSplit sequences into a separate .qci include file
DecompileReferenceMeshSmdFileIsCheckedtrueGenerate reference mesh SMD files
DecompileBoneAnimationSmdFilesIsCheckedtrueGenerate animation SMD files
DecompileBoneAnimationPlaceInSubfolderIsCheckedtruePlace animation SMD files in an anims/ subfolder
DecompileLodMeshSmdFilesIsCheckedtrueGenerate LOD mesh SMD files
DecompilePhysicsMeshSmdFileIsCheckedtrueGenerate physics mesh SMD file from .phy data
DecompileVertexAnimationVtaFileIsCheckedtrueGenerate vertex animation .vta file
DecompileProceduralBonesVrdFileIsCheckedtrueGenerate procedural bones .vrd file
DecompileTextureBmpFilesIsCheckedtrueExtract embedded GoldSource textures as .bmp files

Compile Settings

Settings for the Compile tab — QC input path, output location, and active game profile.
SettingDefaultDescription
CompileQcPathFileName""Last-used QC input file or folder path
CompileOutputFolderOptionGameModelsFolderOutput mode: Game’s “models” folder, Work folder, or Subfolder
CompileOutputSubfolderName"compiled <ver>"Subfolder name when using Subfolder output mode
CompileGameSetupSelectedIndex0Index of the active game profile in the game setup list
CompileModeFileInput mode: File, Folder, or Folder and subfolders
CompileOptionNoP4IsCheckedtruePass -nop4 to StudioMDL (disables Perforce integration)
CompileOptionVerboseIsCheckedtruePass -verbose to StudioMDL for detailed output
CompileSourceLogFileIsCheckedfalseWrite a compile log file (Source engine)
CompileGoldSourceLogFileIsCheckedfalseWrite a compile log file (GoldSource engine)

Unpack Settings

Settings for the Unpack tab — package type, input path, output location, and display options.
SettingDefaultDescription
UnpackPackagePathFolderOrFileName""Last-used package file or folder path
UnpackOutputFolderOptionSameFolderOutput location mode: Same folder, Subfolder, Work folder, or Game’s addons folder
UnpackOutputSubfolderName"unpacked <ver>"Subfolder name when using Subfolder output mode
UnpackByteUnitsOptionBytesFile size display format: Bytes, Binary (KiB/MiB), or Decimal (KB/MB)
UnpackSearchText""Last-used text in the package content search filter
UnpackFolderForEachPackageIsCheckedfalseCreate a separate output folder for each package
UnpackKeepFullPathIsCheckedfalsePreserve the full internal path structure when extracting
UnpackLogFileIsCheckedfalseWrite an unpack log file

Steam Settings

Settings that locate the Steam installation and library paths used for game profile discovery and Workshop publishing.
SettingDefaultDescription
SteamAppPathFileNameUnprocessedC:\Program Files (x86)\Steam\Steam.exePath to the Steam executable
SteamLibraryPaths[]List of additional Steam library root folders

Options Tab Settings

The Options tab configures how Crowbar responds when you open or drag-and-drop a file onto it, and whether context menu entries are registered in Windows Explorer.

Auto-Open

Controls which tab Crowbar navigates to and what action it takes when a file is opened via double-click, the command line, or a file association. Separate options exist for .vpk, .gma, .mdl, .qc, and folders.

Drag and Drop

Controls the default action when files or folders are dragged onto the main Crowbar window. Mirrors the Auto-Open options but applies to drag-and-drop events.

Context Menu

When enabled, Crowbar registers shell context menu entries so that right-clicking a .mdl, .qc, .vpk, or folder in Windows Explorer offers Crowbar actions directly.

Single Instance

Governed by AppIsSingleInstance. When checked, opening a second Crowbar window instead routes the file to the already-running instance.

Build docs developers (and LLMs) love