Compiling:Commands

Complete list of command line parameters

Common options

-connect address: Talk to a NetRadiant instance using a specific XML based protocol -force: Allow reading some broken/unsupported BSP files e.g. when decompiling, may also crash -fs_basepath path: Sets the given path as main directory of the game (can be used more than once to look in multiple paths) -fs_game gamename: Sets a different game directory name (default for Q3A: baseq3) -fs_homebase dir: Specifies where the user home directory name is on Linux (default for Q3A: .q3a) -game gamename: Load settings for the given game (default: quake3) -subdivisions F: multiplier for patch subdivisions quality -threads N: number of threads to use -v: Verbose mode

BSP stage

-bsp ... filename.map: Switch that enters this stage -altsplit: Alternate BSP tree splitting weights (should give more fps) -celshader shadername: Sets a global cel shader name -custinfoparms: Read scripts/custinfoparms.txt -debuginset: Push all triangle vertexes towards the triangle center -debugportals: Make BSP portals visible in the map -debugsurfaces: Color the vertexes according to the index of the surface -deep: Use detail brushes in the BSP tree, but at lowest priority (should give more fps) -de F: Distance epsilon for plane snapping etc. -fakemap: Write fakemap.map containing all world brushes -flares: Turn on support for flares (TEST?) -flat: Enable flat shading (good for combining with -celshader) -fulldetail: Treat detail brushes as structural ones -leaktest: Abort if a leak was found -meta: Combine adjacent triangles of the same texture to surfaces (ALWAYS USE THIS) -minsamplesize N: Sets minimum lightmap resolution in luxels/qu -mi N: Sets the maximum number of indexes per surface -mv N: Sets the maximum number of vertices of a lightmapped surface -ne F: Normal epsilon for plane snapping etc. -nocurves: Turn off support for patches -nodetail: Leave out detail brushes -noflares: Turn off support for flares -nofog: Turn off support for fog volumes -nohint: Turn off support for hint brushes -nosubdivide: Turn off support for q3map_tessSize (breaks water vertex deforms) -notjunc: Do not fix T-junctions (causes cracks between triangles, do not use) -nowater: Turn off support for water, slime or lava (Stef, this is for you) -np A: Force all surfaces to be nonplanar with a given shade angle -onlyents: Only update entities in the BSP -patchmeta: Turn patches into triangle meshes for display -rename: Append "\_bsp" suffix to misc\_model shaders (needed for SoF2) -samplesize N: Sets default lightmap resolution in luxels/qu -skyfix: Turn sky box into six surfaces to work around ATI problems -snap N: Snap brush bevel planes to the given number of units -tempname filename.map: Read the MAP file from the given file name -texrange N: Limit per-surface texture range to the given number of units, and subdivide surfaces like with q3map_tessSize if this is not met -tmpout: Write the BSP file to /tmp -verboseentities: Enable -v only for map entities, not for the world

VIS stage

-vis ... filename.map: Switch that enters this stage -fast: Very fast and crude vis calculation -mergeportals: The less crude half of -merge, makes vis sometimes much faster but doesn't hurt fps usually -merge: Faster but still okay vis calculation -nopassage: Just use PortalFlow vis (usually less fps) -nosort: Do not sort the portals before calculating vis (usually slower) -passageOnly: Just use PassageFlow vis (usually less fps) -saveprt: Keep the PRT file after running vis (so you can run vis again) -tmpin: Use /tmp folder for input -tmpout: Use /tmp folder for output

LIGHT stage

-light ... filename.map: Switch that enters this stage -vlight ... filename.map: Deprecated alias for -light -fast ... filename.map -approx N: Vertex light approximation tolerance (never use in conjunction with deluxemapping) -areascale F, -area F: Scaling factor for area lights (surfacelight) -border: Add a red border to lightmaps for debugging -bouncegrid: Also compute radiosity on the light grid -bounceonly: Only compute radiosity -bouncescale F: Scaling factor for radiosity -bounce N: Number of bounces for radiosity -cheapgrid: Use -cheap style lighting for radiosity -cheap: Abort vertex light calculations when white is reached -compensate F: Lightmap compensate (darkening factor applied after everything else) -cpma: CPMA vertex lighting mode -custinfoparms: Read scripts/custinfoparms.txt -dark: Darken lightmap seams -debugaxis: Color the lightmaps according to the lightmap axis -debugcluster: Color the lightmaps according to the index of the cluster -debugdeluxe: Show deluxemaps on the lightmap -debugnormals: Color the lightmaps according to the direction of the surface normal -debugorigin: Color the lightmaps according to the origin of the luxels -debugsurfaces, -debugsurface: Color the lightmaps according to the index of the surface -debugunused: This option does nothing -debug: Mark the lightmaps according to the cluster: unmapped clusters get yellow, occluded ones get pink, flooded ones get blue overlay color, otherwise red -deluxemode 0: Use modelspace deluxemaps (DarkPlaces) -deluxemode 1: Use tangentspace deluxemaps -deluxe, -deluxemap: Enable deluxemapping (light direction maps) -dirtdebug, -debugdirt: Store the dirtmaps as lightmaps for debugging -dirtdepth: Dirtmapping depth -dirtgain: Dirtmapping exponent -dirtmode 0: Ordered direction dirtmapping -dirtmode 1: Randomized direction dirtmapping -dirtscale: Dirtmapping scaling factor -dirty: Enable dirtmapping -dump: Dump radiosity from -bounce into numbered MAP file prefabs -export: Export lightmaps when compile finished (like -export mode) -exposure F: Lightmap exposure to better support overbright spots -external: Force external lightmaps even if at size of internal lightmaps -extravisnudge: Broken feature to nudge the luxel origin to a better vis cluster -extrawide: Deprecated alias for -super 2 -filter -extra: Deprecated alias for -super 2 -fastbounce: Use -fast style lighting for radiosity -faster: Use a faster falloff curve for lighting; also implies -fast -fastgrid: Use -fast style lighting for the light grid -fast: Ignore tiny light contributions -filter: Lightmap filtering -floodlight: Enable floodlight (zero-effort somewhat decent lighting) -gamma F: Lightmap gamma -gridambientscale F: Scaling factor for the light grid ambient components only -gridscale F: Scaling factor for the light grid only -keeplights: Keep light entities in the BSP file after compile -lightmapdir directory: Directory to store external lightmaps (default: same as map name without extension) -lightmapsize N: Size of lightmaps to generate (must be a power of two) -lomem: Low memory but slower lighting mode -lowquality: Low quality floodlight (appears to currently break floodlight) -minsamplesize N: Sets minimum lightmap resolution in luxels/qu -nocollapse: Do not collapse identical lightmaps -nodeluxe, -nodeluxemap: Disable deluxemapping -nogrid: Disable grid light calculation (makes all entities fullbright) -nolightmapsearch: Do not optimize lightmap packing for GPU memory usage (as doing so costs fps) -normalmap: Color the lightmaps according to the direction of the surface normal (TODO is this identical to -debugnormals?) -nostyle, -nostyles: Disable support for light styles -nosurf: Disable tracing against surfaces (only uses BSP nodes then) -notrace: Disable shadow occlusion -novertex: Disable vertex lighting -patchshadows: Cast shadows from patches -pointscale F, -point F: Scaling factor for point lights (light entities) -q3: Use nonlinear falloff curve by default (like Q3A) -samplescale F: Scales all lightmap resolutions -samplesize N: Sets default lightmap resolution in luxels/qu -samples N: Adaptive supersampling quality -scale F: Scaling factor for all light types -shadeangle A: Angle for phong shading -shade: Enable phong shading at default shade angle -skyscale F, -sky F: Scaling factor for sky and sun light -smooth: Deprecated alias for -samples 2 -style, -styles: Enable support for light styles -sunonly: Only compute sun light -super N, -supersample N: Ordered grid supersampling quality -thresh F: Triangle subdivision threshold -trianglecheck: Broken check that should ensure luxels apply to the right triangle -trisoup: Convert brush faces to triangle soup -wolf: Use linear falloff curve by default (like W:ET) Analyzing BSP-like file structure -analyze ... filename.bsp: Switch that enters this mode -lumpswap: Swap byte order in the lumps Converting & Decompiling -convert ... filename.bsp: Switch that enters this mode -de number: Distance epsilon for the conversion -format converter: Select the converter (available: map, ase, or game names) -ne F: Normal epsilon for the conversion -shadersasbitmap: (only for ase) use the shader names as *BITMAP key so they work as prefabs Exporting lightmaps -export filename.bsp: Copies lightmaps from the BSP to filename/lightmap_0000.tga ff Fixing AAS checksum -fixaas filename.bsp: Switch that enters this mode Get info about BSP file -info filename.bsp: Switch that enters this mode Importing lightmaps -import filename.bsp: Copies lightmaps from filename/lightmap_0000.tga ff into the BSP

MiniMap

-minimap ... filename.bsp: Creates a minimap of the BSP, by default writes to ../gfx/filename_mini.tga -black: Write the minimap as a black-on-transparency RGBA32 image -boost F: Sets the contrast boost value (higher values make a brighter image); contrast boost is somewhat similar to gamma, but continuous even at zero -border F: Sets the amount of border pixels relative to the total image size -gray: Write the minimap as a white-on-black GRAY8 image -keepaspect: Ensure the aspect ratio is kept (the minimap is then letterboxed to keep aspect) -minmax xmin ymin zmin xmax ymax zmax: Forces specific map dimensions (note: the minimap actually uses these dimensions, scaled to the target size while keeping aspect with centering, and 1/64 of border appended to all sides) -nokeepaspect: Do not ensure the aspect ratio is kept (makes it easier to use the image in your code, but looks bad together with sharpening) -o filename.tga: Sets the output file name -random N: Sets the randomized supersampling count (cannot be combined with -samples) -samples N: Sets the ordered supersampling count (cannot be combined with -random) -sharpen F: Sets the sharpening coefficient -size N: Sets the width and height of the output image -white: Write the minimap as a white-on-transparency RGBA32 image

Scaling

-scale S filename.bsp: Scale uniformly -scale SX SY SZ filename.bsp: Scale non-uniformly -scale -tex S filename.bsp: Scale uniformly without texture lock -scale -tex SX SY SZ filename.bsp: Scale non-uniformly without texture lock