D2X-XL Installation Guide

Descent Installation

D2X-XL requires organizing the Descent 2 data in various subfolders. Using these folders is mandatory.

D2X-XL will create all of these folders itself if necessary. Some of these folders may also be created when downloading and installing additional content for D2X-XL.


Main Descent Folders
  • MS Windows: Arbitrary (e.g. c:\games\d2x-xl)
  • Linux: /usr/local/games/d2x-xl, /var/cache/d2x.xl, $HOME/d2x-xl
  • Mac OS X: /Applications/Games/D2X-XL, ~/Library/Caches/D2X-XL (important: Subfolders begin with a capital letter here)

Types And Storage Of Descent Data

D2X-XL distinguishes between static, variable and private game data.

Static game data data resides in the application folder on all OS's. Static game data comprises the basic game data files (*.hog, *.pig, etc), textures, sounds, models, missions, movies and mods.

Variable game data comprises all data D2X-XL computes from static game data. These can be downscaled textures and binary model files, both from the regular game data and from mods,
lightmaps, light data, meshes, missions states and downloaded files. D2X-XL will store such data in the variable cache folder. The variable data is stored by default in subfolders of

  • Windows: subfolder 'cache' of the game folder
  • OS X: ~/Library/Caches/D2X-XL
  • Linux: /var/cache/d2x-xl

Private game data comprises game settings (*.ini), player profiles, screenshots, savegames, demos and on Linux and OS X also wallpapers. The private data is stored by default in subfolders of

  • Windows: game folder
  • OS X: ~/Library/Caches/D2X-XL
  • Linux: /var/cache/d2x-xl

You can tell D2X-XL to use user specific static, variable and private game data folders:

  • -datadir <static data folder>
  • -userdir <private data folder>
  • -cachedir <variable data folder>

On Linux, you will need to manually create /var/cache/d2x-xl and set its access rights to 0757 (sudo chmod 0757 /var/cache/d2x-xl); Otherwise, d2x-xl will not be able to write into it. Alternatively, you can put all users who are allowed to play d2x-xl on your system in a group (e.g. "games"), make games own /var/cache/d2x-xl and sudo chmod 0774 /var/cache/d2x-xl.

The most important data folders are:

  • config: Put all config files here (*.cfg, *.ini)
  • data: Put all game data here (*.pig, descent.hog & .msn, descent2.hog & .mn2, *.256, etc.).
  • demos: Demo files will be saved in this folder (*.dem)
  • missions: Put all mission data here (*.hog, *.msn, *.mn2)
  • missions/single: Special folder where D2X-XL will look for missions if you chose "play singleplayer mission" in its main menu
  • textures/D2: Place all Descent 2 hires textures here (*.tga)
  • textures/D1: Place all Descent 1 hires textures here (*.tga)
  • textures/wallpapers: Place custom wallpapers (menu background images) here (MS Windows).
  • $HOME/d2x-xl/wallpapers: Place custom wallpapers (menu background images) here (Linux).
  • ~/Library/Caches/D2X-XL/Wallpapers: Place custom wallpapers (menu background images) here (Linux).
  • sounds/D2: Place all Descent 2 hires sounds here (*.wav)
  • sounds/D1: Place all Descent 1 hires sounds here (*.wav)
  • models: Put all hires model data here (*.oof, *.tga)
  • movies: Put all movie files here (*.mvl)
  • profiles: Put all player profiles here (*.plr)
  • savegames: Put all save games here (*.sg?)
  • screenshots: screenshots will be saved here if this folder is present (*.tga)

Hints

On Linux, all Descent file names should be lowercase. You can rename all files in a folder to lowercase using the command "for file in *; do mv $file $(echo $file | tr [[:upper:]] [[:lower:]]); done&quot.

The mission folder can have subdirectories as well. You can place all pure singleplayer missions in 'files/missions/single'; if you select 'Play Single Player Mission' in D2X-XL's main menu, it will only display those missions in the mission selection dialog.


Folders And Files

Here is a list of the Descent 1 and 2 files and the folders they should reside in. If you don't have some of the files, just ignore them. Files not listed here can be safely omitted.

    Descent 2
         
    d2x-xl.exe sdl.dll sdl_image.dll sdl_mixer.dll
    sdl_net.dll ogg.dll vorbis.dll vorbisfile.dll
    smpeg.dll libpng14-1.dll zlib1.dll  
    Config
         
    d2x.ini descent.cfg    
    Data
         
    alien1.pig alien2.pig descent.pig fire.pig
    groupa.pig ice.pig water.pig d2x-xl.hog
    descent.hog descent2.hog descent2.ham hoard.ham
    descent2.s22      
    banlist.txt      
    Movies
         
    d2x-h.mvl d2x-l.mvl intro-h.mvl intro-l.mvl
    other-h.mvl other-l.mvl robots-h.mvl robots-l.mvl
    Profiles
         
    default.plr default.plx    
    Savegames
         
    default.sg0      

News

A new D2X-XL update fixing broken screen resolution persistence is available

There is yet another D2X-XL update is available (the new Pumo Mines broke a few things ...)

Believe it or not: There's a new D2X-XL version online!

Uploaded updated D2X-XL and library source code that compiles with Visual Studio 19

After a really long time, another new DLE version is available

A new DLE version is available (hear, hear!) :D

A new Max OS X version of D2X-XL is available!

D2X-XL now offers a cartoon style render mode!

New D2X-XL and DLE versions are available

Blarget has got his own area in the level spotlight

New D2X-XL and DLE versions are available

A couple of levels have been added to the level spotlight

Hooray! We're finally having a new Mac OS X version of D2X-XL!

D2X-XL now features an observer mode for multiplayer games

A new D2X-XL version with improved multiplayer synchronization is available

A new D2X-XL version fixing out of sync problems in multiplayer games is available

A new D2X-XL version with many multiplayer bug fixes is available

Added high quality (ogg) Descent 1 and 2 music to the downloads area

A new D2X-XL version with important bug fixes is available

D2X-XL compiles and runs on Linux again!

Descent 1 and 2 high res textures are now available as complete downloads

A new DLE version with a ton of bug fixes and improvements is online

A new D2X-XL version is online

A new D2X-XL version with a much needed bug fix is online

A new DLE version is online

Published another DLE version with more bug fixes and improvements by Sirius

Published a new D2X-XL version

Published a new DLE version with tons of bug fixes and improvements by Sirius

D2X-XL now supports Oculus Rift 3D headsets!

Updated DLE and D2X-XL to support new level features requested by Pumo

Added an article about DLE's new tunnel generator to the worklog

DLE's new tunnel generator is finished

Added a new article to the worklog

Published a new DLE version

Added a new article to the worklog

Added two new articles to the worklog

D2X-XL and DLE-XP now support triangular segment sides!

DLE-XP has an OpenGL render and 1st person view!

New DLE-XP version available

Wrote a new worklog article

Check out DarkFlameWolf's level spotlight section!

New DLE-XP and D2X-XL versions are available

A new DLE-XP version is available

Added a worklog article about the way point feature

Added way point support to DLE-XP and D2X-XL

Posted a bunch of new screenshots

Posted a bunch of new screenshots

A New version of DLE-XP is available

New OS X version of D2X-XL is available!

Added article about lightmaps to worklog.

New article and video added to worklog.