WDFUSE Tutorial - 3D Renderer

From DF21 Wiki
Jump to: navigation, search

3D Renderer

One of the key WDFUSE features that has been missing since launch was a full 3D preview of your current mission. However, by 2022, one of the community members The-MAZZTer has created a Unity-based Dark Forces Showcase that allows for full 3D preview of a Dark Forces mission .

Showcase preview.png

The renderer has been modified by Karjala ( df21.net{ at }gmail.com ) and integrated into WDFUSE to allow full previews of the mission without having the need to launch the game.

Renderer Install and Configuration

The renderer does not come bundled with WDFUSE but it can be instantly installed and auto-configured through the game's Options menu. To get started either click the Options icon in the main menu bar at the top or press F9 .

Options Bar.png

Switch to the 3D Renderer Tab and click Download on the right hand side (The actual picture of the Moldy Crow wit the word download). It should take a few seconds to download and auto-configure the renderer. Otherwise, if you already have downloaded it simply Browse to the path where the executable Dark Forces Showcase.exe is located.


Within a few seconds you will get a pop-up saying that the renderer has been installed.

You will also notice two checkboxes.

  1. If you check the Update Renderer with Changes it means that any time you make a change in the editor, they will be reflected in the 3D renderer.
  2. If you check the Start 3D Render on Level Load it means that when you open up a new or existing project the launcher will start automatically.

Click them both and press ok to exit the Options menu.

Using 3D Renderer

To start viewing your mission in 3D press the red 3D Render button at the main menu or press the F7 key. A new window will appear showing your mission. If you still have the original square from the Basics tutorial you will see it rendered in 3D.

Render Square.png

You can move around the 3D world using the typical FPS WASD controls and aim with your mouse.

If you have checked the Update Renderer with Changes checkbox when you move a map component it will be reflected in the 3D preview window. Try moving the map walls or the sector and you will see them get updated in 3D.


A very useful feature is you can switch between WDFUSE and the 3D Renderer by holding the ALT button so you can pan the cursor between the two programs. It will halt the camera in the renderer and allows you to control the mouse. Give it a try - you don't need to Alt-Tab between them anymore.

Renderer Options

If you press Escape in the 3D renderer you will see various options.


Here you can modify...

  • Which object difficulties will be displayed
  • Which object types should be displayed
  • Which layers must be visible
  • What type of lighting can be displayed (Full Bright lighting (Ambient 31) or Dark Forces 8 bit versions
  • Music On or Off (Recommended: OFF )
  • The Volume of the music
  • How sensitive is the X/Y camera as you look around
  • Whether to invert the camera
  • The speed at which the camera can be moved
  • Whether to show warnings when loading (Recommended: Off)
  • Camera position displayed in X, Y, Z coordinates (Recommended: On);

Note: Your settings are stored in the registry (including the width and height of your window).

Registry Key.png

Advanced: Search for this key Computer\HKEY_USERS\<Your Windows User Key>SOFTWARE\MZZT\Dark Forces Showcase and delete values as you feel necessary.

Finally, if the 3D view state ever gets desynchronized from what you see in the editor simply press the 3D Render button again or press F11 to refresh the view.

With that, lets move to Advanced Geometry section.

WDFUSE Tutorials

  1. Introduction
  2. WDFUSE Tutorial - Configuration
  3. WDFUSE Tutorial - Basic Geometry
  4. WDFUSE Tutorial - Basic Geometry II
  5. WDFUSE Tutorial - 3D Renderer
  6. WDFUSE Tutorial - Advanced Geometry
  7. WDFUSE Tutorial - Advanced Geometry II
  8. WDFUSE Tutorial - Advanced Geometry III
  9. WDFUSE Tutorial - Objects
  10. WDFUSE Tutorial - Scripting
  11. WDFUSE Tutorial - Scripting II
  12. WDFUSE Tutorial - Scripting III