Merge pull request #335 from JeodC/main

Patch Descent ports
christianhaitian · Jan 10, 2024 · 33e64b7 · 33e64b7
2 parents a070af3 + 407ed24
commit 33e64b7
Show file tree

Hide file tree

Showing 4 changed files with 96 additions and 16 deletions.
diff --git a/Descent.zip b/Descent.zip
diff --git a/Descent2.zip b/Descent2.zip
diff --git a/markdown/descent.md b/markdown/descent.md
@@ -1,5 +1,47 @@
+# Descent 1/2 For PortMaster
+The MS-DOS games by Parallax Software ported with DXX-Rebirth.
+
+## Installation
+Unzip to ports folder e.g. `/roms/ports/`. Ready to play with shareware and demo files. To upgrade to full game, purchase on Steam/GOG and then add .hog and .pig files to `descent/data` and `descent2/data`.
+
+Filelist for full versions:  
+├── descent/data  
+│   ├── missions/    
+│   │ └── bonuscontent   
+│   └── descent.hog  
+│   └── descent.pig  
+│   └── chaos.hog (multiplayer, optional)  
+│   └── chaos.msn (multiplayer, optional)  
+├── descent2/data  
+│   ├── missions/    
+│   │ └── bonuscontent   
+│   └── alien1.pig  
+│   └── alien2.pig  
+│   └── descent2.ham  
+│   └── descent2.hog  
+│   └── descent2.s11  
+│   └── descent2.s22  
+│   └── fire.pig  
+│   └── groupa.pig  
+│   └── ice.pig  
+│   └── water.pig  
+│   └── intro-h.mvl (optional)  
+│   └── other-h.mvl (optional)  
+│   └── robots-h.mvl (optional)  
+│   └── d2x-h.mvl (optional)  
+
+Descent I & II: Definitive Edition came with some extra content not available on GOG or Steam. These include Levels of the World (Descent 1), 29 Bonus Levels by Parallax Software (Descent 1), and the Descent 2: Vertigo expansion pack. 
+This extra content can be placed in the data/missions folder for both Descent and Descent 2. If done correctly you'll see a new submenu when selecting New Game.
+
 ## Configuration
-You may rename Player.plr and Player.plx in the conf folder for a different multiplayer display name. If you do so, please modify the d1x.ini or d2x.ini file to reflect this change.
+Ini files `d1x.ini` and `d2x.ini` are configurable. The port features KBM emulation and native SDL joystick controls. To switch between them, tick the option `-nojoystick` in the ini file. Joystick controls only affect the analog sticks and is meant for those who
+prefer a more "authentic" experience.  
+
+You may rename `Player.plr` and `Player.plx` in the conf folder for a different multiplayer display name. If you do so, please modify the `d1x.ini` or `d2x.ini` file to reflect this change.
+
+Cheats can be found and modified in `cheats.txt`. To turn a cheat on, change the 0 to 1. To turn it off, change 1 to 0.
+
+Add-Ons (.dxa files) such as different soundtracks from various soundcards and game versions, can be found at the project's [GitHub Repo](https://github.com/JeodC/Portmaster-Descent)
 
 ## Default Gameplay Controls
 
@@ -20,9 +62,10 @@ You may rename Player.plr and Player.plx in the conf folder for a different mult
 |D-PAD LEFT|Turn Left|
 |D-PAD RIGHT|Turn Right|
 |LEFT ANALOG|Look Around|
-|RIGHT ANALOG UP|Not Set|
+|RIGHT ANALOG|Slide Up/Down & Bank Left/Right|
 |SELECT|Back / Escape|
 |START|Start / Accept / Enter|
+|START + LEFT|Activate Cheats|
 
 ## Level Select Controls
 
@@ -38,16 +81,13 @@ You may rename Player.plr and Player.plx in the conf folder for a different mult
 |SELECT+  B|7|
 |SELECT + X|8|
 |SELECT + Y|9|
+|D-PAD Left|Backspace|
 
 ## Thanks
 Cebion  
 romadu  
 Tekkenfede  
 krishenriksen  
 Testers and Devs from the PortMaster Discord  
-Parallax Software
-<a href="https://www.dxx-rebirth.com/">DXX-Rebirth</a> Team  
-
-
-
-
+Parallax Software  
+[DXX-Rebirth](https://www.dxx-rebirth.com) Team  
diff --git a/markdown/descent2.md b/markdown/descent2.md
@@ -1,5 +1,47 @@
+# Descent 1/2 For PortMaster
+The MS-DOS games by Parallax Software ported with DXX-Rebirth.
+
+## Installation
+Unzip to ports folder e.g. `/roms/ports/`. Ready to play with shareware and demo files. To upgrade to full game, purchase on Steam/GOG and then add .hog and .pig files to `descent/data` and `descent2/data`.
+
+Filelist for full versions:  
+├── descent/data  
+│   ├── missions/    
+│   │ └── bonuscontent   
+│   └── descent.hog  
+│   └── descent.pig  
+│   └── chaos.hog (multiplayer, optional)  
+│   └── chaos.msn (multiplayer, optional)  
+├── descent2/data  
+│   ├── missions/    
+│   │ └── bonuscontent   
+│   └── alien1.pig  
+│   └── alien2.pig  
+│   └── descent2.ham  
+│   └── descent2.hog  
+│   └── descent2.s11  
+│   └── descent2.s22  
+│   └── fire.pig  
+│   └── groupa.pig  
+│   └── ice.pig  
+│   └── water.pig  
+│   └── intro-h.mvl (optional)  
+│   └── other-h.mvl (optional)  
+│   └── robots-h.mvl (optional)  
+│   └── d2x-h.mvl (optional)  
+
+Descent I & II: Definitive Edition came with some extra content not available on GOG or Steam. These include Levels of the World (Descent 1), 29 Bonus Levels by Parallax Software (Descent 1), and the Descent 2: Vertigo expansion pack. 
+This extra content can be placed in the data/missions folder for both Descent and Descent 2. If done correctly you'll see a new submenu when selecting New Game.
+
 ## Configuration
-You may rename Player.plr and Player.plx in the conf folder for a different multiplayer display name. If you do so, please modify the d1x.ini or d2x.ini file to reflect this change.
+Ini files `d1x.ini` and `d2x.ini` are configurable. The port features KBM emulation and native SDL joystick controls. To switch between them, tick the option `-nojoystick` in the ini file. Joystick controls only affect the analog sticks and is meant for those who
+prefer a more "authentic" experience.  
+
+You may rename `Player.plr` and `Player.plx` in the conf folder for a different multiplayer display name. If you do so, please modify the `d1x.ini` or `d2x.ini` file to reflect this change.
+
+Cheats can be found and modified in `cheats.txt`. To turn a cheat on, change the 0 to 1. To turn it off, change 1 to 0.
+
+Add-Ons (.dxa files) such as different soundtracks from various soundcards and game versions, can be found at the project's [GitHub Repo](https://github.com/JeodC/Portmaster-Descent)
 
 ## Default Gameplay Controls
 
@@ -20,9 +62,10 @@ You may rename Player.plr and Player.plx in the conf folder for a different mult
 |D-PAD LEFT|Turn Left|
 |D-PAD RIGHT|Turn Right|
 |LEFT ANALOG|Look Around|
-|RIGHT ANALOG UP|Not Set|
+|RIGHT ANALOG|Slide Up/Down & Bank Left/Right|
 |SELECT|Back / Escape|
 |START|Start / Accept / Enter|
+|START + LEFT|Activate Cheats|
 
 ## Level Select Controls
 
@@ -38,16 +81,13 @@ You may rename Player.plr and Player.plx in the conf folder for a different mult
 |SELECT+  B|7|
 |SELECT + X|8|
 |SELECT + Y|9|
+|D-PAD Left|Backspace|
 
 ## Thanks
 Cebion  
 romadu  
 Tekkenfede  
 krishenriksen  
 Testers and Devs from the PortMaster Discord  
-Parallax Software
-<a href="https://www.dxx-rebirth.com/">DXX-Rebirth</a> Team  
-
-
-
-
+Parallax Software  
+[DXX-Rebirth](https://www.dxx-rebirth.com) Team