Lump filtering

From ZDoom Wiki
Jump to: navigation, search

Lump filtering is a feature for directory-structured archives that allows loading of lumps depending on the game or gametype.

The engine makes use of a special filter/ directory which houses lump filters. These filters are directories which bear the name of the game or gametype for which to load their contents, and they must follow the directory structure.

When the filters are loaded, they will be renamed to strip out the filter/<game-or-gametype>/ part and will be ordered so they take precedence over any lumps not inside a filter/ directory. Filters that do not match the criteria, will be ignored.

Filters are not necessarily mutually exclusive. For instance, if there are two filters, one for any Doom-based game and another for Doom II: Hell on Earth, both will be loaded when playing Doom II: Hell on Earth, but only the former filter will be loaded if playing any of the other Doom-based games.

Filter names

The following is a listing of game and gametype filter names:


  • doom
Any Doom game.
  • doom.doom2
Any Doom 2 game.
  • doom.doom2.commercial
Doom 2: Hell on Earth.
  • doom.doom2.bfg
Doom 2: BFG Edition.
  • doom.doom2.plutonia
Final Doom: Plutonia Experiment.
  • doom.doom2.tnt
Final Doom: TNT - Evilution.
  • doom.doom1
Any original Doom game.
  • doom.doom1.registered
Doom Registered.
  • doom.doom1.ultimate
The Ultimate Doom.
  • doom.doom1.bfg
Doom: BFG Edition.
  • doom.freedoom
Any Freedoom game.
  • doom.freedoom.demo
Freedoom: Demo Version.
  • doom.freedoom.phase1
Freedoom: Phase 1.
  • doom.freedoom.phase2
Freedoom: Phase 2.
  • doom.freedoom.freedm
  • heretic
Any Heretic game.
  • heretic.heretic
  • heretic.shadow
Heretic: Shadow of the Serpent Riders.
  • blasphemer
  • hexen
Any Hexen game.
  • hexen.hexen
Hexen: Beyond Heretic.
  • hexen.deathkings
Hexen: Deathkings of the Dark Citadel.
  • strife
Strife: Quest for the Sigil.
  • chex
Any Chex Quest game.
  • chex.chex1
Chex(R) Quest.
  • chex.chex3
Chex(R) Quest 3.
  • urbanbrawl
Action Doom 2: Urban Brawl.
  • hacx
Any Hacx game.
  • hacx.hacx1
Hacx: Twitch'n Kill.
  • hacx.hacx2
Hacx 2.0.
  • harmony
  • square
Any The Adventures of Square game.
  • square.squareware
The Adventures of Square (Square-ware).
  • square.square
The Adventures of Square.


  • game-raven
Any Heretic or Hexen game.
  • game-doomstrifechex
Any Doom, Strife or Chex Quest game.
  • game-doomchex
Any Doom or Chex Quest game.
  • game-doom
Any Doom game.
  • game-heretic
Any Heretic game.
  • game-hexen
Any Hexen game.
  • game-strife
Any Strife game.
  • game-chex
Any Chex Quest game.