goldutil

module
v1.6.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 4, 2026 License: MIT

README

goldutil

GoldSrc CLI utilities and Go library, released under the MIT license, see LICENSE.md.

The CLI documentation is available online at https://l-p.github.io/goldutil/ or by running $ goldutil help.

Features:

  • WAD reader and writer (not including decals.wad and gfx.wad).
  • Sprite reader and writer.
  • .map entity call graph via Graphviz.
  • .map file cleanup to automate TrenchBroom workflows.
  • materials.txt remapping for BSPs with embedded textures.
  • .map entity pre-processor (see map neat).
  • WAV looping.
  • NOD extraction.
  • Human-readable dumps of various formats.
$ goldutil -h
NAME:
   goldutil - GoldSrc modding utilities.

USAGE:
   goldutil [global options] [command [command options]]

VERSION:
   v1.6.0

DESCRIPTION:
   goldutil can read, modify, and write multiple file formats used by the GoldSrc (Half-Life) engine.
   See more detailed help with `goldutil CMD -h` or `goldutil CMD SUBCMD -h`.

COMMANDS:
   bsp      BSP (compiled maps) manipulation.
   fgd      Output the FGD to use with goldutil map neat.
   nod      NPC pathfinding nodes manipulation.
   map      Map pre-processing.
   mod      Misc modding utilities
   spr      Sprite manipulation.
   wad      Texture files manipulation.
   wav      Audio manipulation.
   help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h     show help
   --version, -v  print the version

Directories

Path Synopsis
bsp
Package bsp implements an incomplete GoldSrc BSP parser.
Package bsp implements an incomplete GoldSrc BSP parser.
nod
Package nod implements NPC navigation node graph files parsing.
Package nod implements NPC navigation node graph files parsing.
qmap
Package typed_map parses Quake .map files in the Valve 220 format as struct containers.
Package typed_map parses Quake .map files in the Valve 220 format as struct containers.
qmap/valve
Package valve contains vanilla Half-Life entities definitions.
Package valve contains vanilla Half-Life entities definitions.
sprite
Package sprite implements GoldSrc SPR files parsing.
Package sprite implements GoldSrc SPR files parsing.
wad
Package wad implements GoldSrc WAD (texture files) parsing.
Package wad implements GoldSrc WAD (texture files) parsing.
internal
set
Package neat implements an map pre-processor for GoldSrc.
Package neat implements an map pre-processor for GoldSrc.
Package palette contains image and palette manipulation utilities.
Package palette contains image and palette manipulation utilities.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL