Skip to content

Latest commit

 

History

History
101 lines (71 loc) · 2.65 KB

setup.adoc

File metadata and controls

101 lines (71 loc) · 2.65 KB

WadC setup and getting started

To use , you require Java, a Doom engine, a node builder and game data for a Doom game (known as the IWAD).

Tip
Debian and Ubuntu
Debian logo
Ubuntu logo

WadC is packaged for Debian and Ubuntu-based distributions. You can skip all of these steps, simply do

$ sudo apt install wadc
$ wadc

Pre-requisites

Java

WadC requires a Java Runtime Environment to run, version 8 or newer. I recommend OpenJDK.

Linux

For Debian-based systems:

apt install openjdk-17-jre

On Fedora/Red Hat style systems

dnf install java-17-openjdk

Doom Engine

You’ll also need a Doom engine. I recommend Crispy Doom (Debian package crispy-doom).

Node Builder

Finally you may require a node builder. I recommend zdBSP (Debian package zdbsp).

Game Data (IWAD)

IWAD (game data). If you don’t have the commercial game data, buy it from GoG or grab FreeDoom (Debian package freedoom).

Configuring WadC

Unpack everything.

Launch WadC by double-clicking the JAR file.

Tip
failing that, from a command-line, java -jar wadc*with-dependencies.jar

Open WadC’s preferences dialog (macOS: ⌘ + ,) and set the paths to the game engine, IWAD and node builder (these should be set to sensible defaults already if you installed the Debian package).

macOS

Most Doom Engines for Mac OS are distributed as "app bundles": within the UI, they appear like applications that can be double-clicked, have an icon, etc.; but under the hood they are actually folders that contain other files (e.g. Eternity.app/). One of the included files is the actual engine program.

When selecting the game engine, WadC requires you to select the engine program from within the App bundle. The File chooser should let you expand the App as if it were a folder and browse the contents. For example, for Eternity, the engine is Eternity.app/Contents/MacOS/Eternity Engine.

First run

Open up one of the files from examples/ in the unpacked WadC ZIP. From the WadC Control menu, hit Run / Save / Save WAD / BSP / Doom to try it out!