Skip to content

Exporting and Classic Ports

codingncaffeine edited this page Oct 14, 2026 · 4 revisions

Exporting and Classic Ports

Export makes one file from your project, to share or to play anywhere. Press Ctrl+E, choose Export… in the command palette, or click Export… in the Inspector with nothing selected.

What you can export for

Choice File Plays in
UZDoom and GZDoom .pk3 UZDoom, GZDoom: the project exactly as it is
Vanilla .wad Chocolate Doom, the original DOS game, the 2024 re-release
Limit-removing .wad Crispy Doom, Doom Retro, and every Boom port
Boom .wad dsda-doom, Woof, Nugget Doom, PrBoom+ (complevel 9)
MBF21 .wad dsda-doom, Woof, Nugget Doom (complevel 21)

Boom and MBF21 are for Doom and Doom II maps. Heretic, Hexen and Strife maps export for GZDoom, Vanilla and Limit-removing.

The list of what does not survive

When you choose, WadSmith exports the whole project in the background and lists what each map would lose there. It reads the finished file back the way the game reads it, so the list is exactly what did not come back. Each line says what and how many walls, rooms or objects, and Show selects them on the plan.

Lines in red stop the game with an error. Vanilla stops on an object number, a picture or a room effect it does not know. Change those before you share the file. The other lines play, without the thing named: a sloped floor is flat, coloured light is white, and so on.

For a vanilla port the list also names the rooms from which a view would overflow vanilla Doom's limits, as Problems does. Sliding and swinging doors are GZDoom's and Hexen's: a Doom-format file lists them, and vanilla stops on them.

Save as… saves the very file the list was read from.

What WadSmith changes so it survives

Some things GZDoom writes its own way have a classic equivalent that plays the same. WadSmith writes the classic one and says so under the list:

  • A teleporter that sends to an arrival spot sends to the spot's room, the way classic teleporters work.
  • A floor that hurts by 5, 10 or 20 every 32 tics becomes Doom's own hurting floor of that strength.
  • A switch monsters could also press becomes the players' switch (listed, since monsters lose it).
  • In Hexen and Strife, an exit names the next map the way each game does.
  • Your own pictures for walls are carried in, in the game's colours. Floors are carried too, except for Vanilla, which reads floors only from the game itself.
  • Boom and MBF21 get each map's name, music, sky and next map (a UMAPINFO lump). For Vanilla and Limit-removing, a map's own music is written as the song its slot plays (MAP01's D_RUNNIN), so it plays there too.
  • WadSmith builds the nodes the classic ports need. Corners and offsets with fractions are rounded to whole units.

The Share check

If the project holds pictures, sounds or objects copied from a commercial game (Doom II, Heretic, Duke Nukem 3D and so on), the Export card says so, counted by game. That is fine for your own play and for friends who own those games. Before posting the map publicly, leave those things out. Copies from free games such as Freedoom and Blasphemer raise nothing.

Play in a classic port

The arrow beside Play has Play in: GZDoom, and each classic port installed for the map's game: Chocolate, Crispy, dsda-doom, Woof or Nugget Doom. With a port chosen, Play exports the map for it (the project's own target when the port plays that, the port's best otherwise) and starts the port on your map and difficulty.

  • WadSmith plays with its own copy of each port's settings, made once from yours, so your controls carry over and your own settings are never changed.
  • If the port would stop with an error over the map, WadSmith does not start it and says why. Export lists everything to change.
  • Play From Here works in GZDoom only.

The ports are not in Arch's official repositories; the AUR has chocolate-doom, crispy-doom, dsda-doom and woof-doom. Debian and Ubuntu package Chocolate Doom and Crispy Doom.

From the command line

wadsmith-cli export writes the same files and prints the list. See Command Line.

Clone this wiki locally