diff --git a/Descent.zip b/Descent.zip
index 5402a6dc..a66e99f1 100644
Binary files a/Descent.zip and b/Descent.zip differ
diff --git a/Descent2.zip b/Descent2.zip
index a691ab9c..2fb12940 100644
Binary files a/Descent2.zip and b/Descent2.zip differ
diff --git a/markdown/descent.md b/markdown/descent.md
index a7346d97..887d3a63 100644
--- 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,6 +81,7 @@ 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
@@ -45,9 +89,5 @@ romadu
Tekkenfede
krishenriksen
Testers and Devs from the PortMaster Discord
-Parallax Software
-DXX-Rebirth Team
-
-
-
-
+Parallax Software
+[DXX-Rebirth](https://www.dxx-rebirth.com) Team
diff --git a/markdown/descent2.md b/markdown/descent2.md
index a7346d97..887d3a63 100644
--- 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,6 +81,7 @@ 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
@@ -45,9 +89,5 @@ romadu
Tekkenfede
krishenriksen
Testers and Devs from the PortMaster Discord
-Parallax Software
-DXX-Rebirth Team
-
-
-
-
+Parallax Software
+[DXX-Rebirth](https://www.dxx-rebirth.com) Team