Chocolate Doom Vita: Difference between revisions

Chocolate Doom
Chocolate Doom
General
Author	fgsfds
Type	Shooter
Version	3.1
License	GPL-2.0
Last Updated	2020/10/23
Links
	Download
	Website
	Source

Revision as of 13:00, 28 December 2022

This is a Vita port of Chocolate Doom, which is a source port of Doom.

It supports the original Doom games, as well as Heretic, Hexen and Strife, and adds some extra features while staying as close to the vanilla game(s) as possible.

Features

Supports Doom, Doom II, Final Doom, FreeDoom, Chex Quest, Heretic, Hexen and Strife.
Sound and music, including OPL3 and PC Speaker emulation, as well as OGG music support (see this post for setup guide).
Supports LAN and online multiplayer (no server browser yet).
Single integrated launcher for all supported games that allows setting most configuration options.
Supports custom files (PWADs, LMPs, DEHs, demos, etc).
Supports almost all features of Chocolate Doom (WAD file merging, built-in DeHackEd, etc).

Installation

Install the VPK.

Extract data.zip to ux0: (root of memory card).

Copy your IWAD files (see table below) to ux0:/data/chocolate/iwads.

User guide

Supported games/IWADs

To play a game from this list, copy the corresponding files to ux0:/data/chocolate/iwads/.

Game	File(s)
Shareware Doom *	doom1.wad
Doom / Ultimate Doom	doom.wad
Doom II	doom2.wad
Final Doom: TNT Evilution	tnt.wad
Final Doom: The Plutonia Experiment	plutonia.wad
Chex Quest	chex.wad, chex.deh
FreeDoom: Phase 1	freedoom.wad
FreeDoom: Phase 2	freedoom2.wad
FreeDM	freedm.wad
Shareware Heretic *	heretic1.wad
Heretic / Shadow of the Serpent Riders	heretic.wad
Hexen	hexen.wad
Strife	strife1.wad, optionally voices.wad

Files for games marked with * are already included in data.zip.
chex.deh is required for Chex to work correctly.
FreeDoom is a free and open source recreation of the original Doom 1 & 2 IWADs, but it is not 100% compatible with Chocolate Doom.

Loading PWADs (custom game files)

Put all custom files for a given game into ux0:/data/chocolate/pwads/<gamedir>, where:

<gamedir> is doom for all Doom games.
heretic for Heretic and Shareware Heretic.
hexen for Hexen.
strife for Strife.

Then use the Custom tab in the launcher to select any custom content you want.

Recording demos

When Record demo is set to On, the demo is saved to ux0:/data/chocolate/tmp/mydemo.lmp.

Notes

If the game closes without producing a crash dump or an error message, a file named ux0:/data/chocolate/i_error.log should be generated, which contains error messages.

The IP address that appears in the Game address field of the Net tab of the launcher when you run it is your Vita's LAN IP. You can use this if autojoin doesn't work properly.

To join a game by IP, select Game address, enter the address, then hit Connect to address.

Netgames will only work correctly if all players have selected the same game and set of custom files (stuff in the Files tab). PWAD order does matter. The game will complain upon connecting if you did something wrong.

The Merge file option is the launcher version of the -merge command line option. See the Chocolate Doom wiki for more details.

You can specify custom command line parameters in a response file, then load it using the Override response file option. Don't forget to select the correct game.

By popular request some of the static render limits (MAXVISPLANES, MAXVISSPRITES, MAXDRAWSEGS) have been quadrupled in this fork to accomodate for SIGIL.

Controls

Launcher:

L/R - Select tab

Up/Down - Select option

Left/Right - Adjust option

Cross - Activate option (runs selected game when in Game tab)

Start - Save settings and launch the game you have selected in the Game tab

Circle - Save settings and exit launcher, Cancel selection when in file select dialog

Basic controls:

Left Analog - Move, Strafe

Right Analog - Turn, Look

R - Fire

L - Run

Square - Use

Triangle/Circle - Change weapons

Front touch - Toggle map

Controls for a particular game can be viewed and changed in the Buttons and Input tabs of the launcher.

Screenshots

chocolatedoomvita3.png chocolatedoomvita4.png

chocolatedoomvita5.png chocolatedoomvita6.png

Changelog

v3.1

Fixed texture corruption in Hexen and Heretic introduced in r3.
Bumped version to 3.0.1 in launcher.

v3.0

Synced with upstream Chocolate Doom.
Raised some render limits to accommodate for SIGIL (it might still not work 100%).

v2.0

Added different scaling filters (some decrease pixel distortion).
Added basic multiplayer support (can host, connect by IP, find and join games on local network).
Added mouse emulation mode for right analog.
Added more options to the launcher.
Launcher now detects FreeDoom 1 & 2, FreeDM and Chex Quest.
Launcher now can use the touch screen keyboard to set some options.
Fixed textmode screens (ENDOOM, error messages and other dialogs, Heretic startup screen, etc.).
New LiveArea assets.
Slightly increased performance.

v1.0

First Release.

Credits

these people for Chocolate Doom itself.
Vita SDK Team for the Vita SDK.
rsn8887 and cpasjuste for the SDL2 port.
rsn8887 for the SDL_net port, some graphics-related code and testing.
frangarcj for Vita Shader Collection and the FBO fork of Vita2D.
tiduscrying for the LiveArea assets.
KINGGOLDrus for some launcher graphics.
everyone on the #henkaku and #vitasdk IRC channels for help and/or testing.

External links

Wololo - https://wololo.net/talk/viewtopic.php?f=116&t=48973
GitHub - https://github.com/fgsfdsfgs/chocolate-doom
VitaDB - https://vitadb.rinnegatamante.it/#/info/377

@@ Line 2: / Line 2: @@
 |title=Vita Homebrew Games (Shooter) - GameBrew
 |title_mode=append
-|image=chocolatedoomvita.jpg
+|image=chocolatedoomvita2.png
 |image_alt=Chocolate Doom
 }}
 {{Infobox Vita Homebrews
 |title=Chocolate Doom
-|image=chocolatedoomvita.jpg
+|image=chocolatedoomvita2.png
-|description=Chocolate Doom port for PSVITA
+|description=Chocolate Doom port for PS Vita.
 |author=fgsfds
 |lastupdated=2020/10/23
@@ Line 15: / Line 15: @@
 |license=GPL-2.0
 |download=https://dlhb.gamebrew.org/vitahomebrews/chocolatedoomvita.7z
-|website=https://www.chocolate-doom.org/
+|website=https://wololo.net/talk/viewtopic.php?f=116&t=48973
 |source=https://github.com/fgsfdsfgs/chocolate-doom
 }}
-Chocolate Doom is a [https://www.chocolate-doom.org/ sourceport of Doom] allowing you to play Doom, Doom 2, Final Doom, Heretic, Sigil, Hexen and Strife.
+This is a Vita port of Chocolate Doom, which is a [https://www.chocolate-doom.org/ source port of Doom].
+It supports the original Doom games, as well as Heretic, Hexen and Strife, and adds some extra features while staying as close to the vanilla game(s) as possible.
 ==Features==
-* Supports Doom, Doom II, Final Doom, FreeDoom, Chex Quest, Heretic, Hexen and Strife;
+*Supports Doom, Doom II, Final Doom, FreeDoom, Chex Quest, Heretic, Hexen and Strife.
-* Sound and music, including OPL3 and PC Speaker emulation, as well as OGG music support (see this post for setup guide);
+*Sound and music, including OPL3 and PC Speaker emulation, as well as OGG music support (see [https://wololo.net/talk/viewtopic.php?f=116&t=48973&p=422176#p422176 this post] for setup guide).
-* Supports LAN and online multiplayer (no server browser yet);
+*Supports LAN and online multiplayer (no server browser yet).
-* Single integrated launcher for all supported games that allows setting most configuration options;
+*Single integrated launcher for all supported games that allows setting most configuration options.
-* Supports custom files (PWADs, LMPs, DEHs, demos, etc.);
+*Supports custom files (PWADs, LMPs, DEHs, demos, etc).
-* Supports almost all features of Chocolate Doom (WAD file merging, built-in DeHackEd, etc.).
+*Supports almost all features of Chocolate Doom (WAD file merging, built-in DeHackEd, etc).
-==Media==
-<youtube>utQgXYYg6Js</youtube>
-==Screenshots==
-https://dlhb.gamebrew.org/vitahomebrews/chocolatedoomvita-01.jpg
-https://dlhb.gamebrew.org/vitahomebrews/chocolatedoomvita-02.jpg
-https://dlhb.gamebrew.org/vitahomebrews/chocolatedoomvita-03.jpg
-https://dlhb.gamebrew.org/vitahomebrews/chocolatedoomvita-04.jpg
-== Installation ==
+==Installation==
-# Install VPK.
+Install the VPK.
-# Extract <code>data.zip</code> from the latest release to root of memory card (<code>ux0:</code>).
-# Copy any supported IWADs (see below) you have to <code>ux0:/data/chocolate/iwads/</code>.
-== Launcher controls ==
+Extract data.zip to ux0: (root of memory card).
-* LTrigger/RTrigger: select tab
-* Up/Down: select option
-* Left/Right: adjust option
-* Cross: activate option
-* Start: save settings and launch the game you have selected in the <code>Game</code> tab (in single-player mode)
-* Circle: save settings and exit launcher / cancel selection when in file select dialog
-Controls for a particular game can be viewed and changed in the <code>Buttons</code> and <code>Input</code> tabs.
+Copy your IWAD files (see table below) to ux0:/data/chocolate/iwads.
-== Supported games / IWADs ==
+==User guide==
-To play a game from this list, copy the corresponding files to <code>ux0:/data/chocolate/iwads/</code>.
+===Supported games/IWADs===
+To play a game from this list, copy the corresponding files to ux0:/data/chocolate/iwads/.
-{|
+{| class="wikitable sortable"
 ! Game
 ! File(s)
 |-
 | Shareware Doom *
-| <code>doom1.wad</code>
+| doom1.wad
 |-
 | Doom / Ultimate Doom
-| <code>doom.wad</code>
+| doom.wad
 |-
 | Doom II
-| <code>doom2.wad</code>
+| doom2.wad
 |-
 | Final Doom: TNT Evilution
-| <code>tnt.wad</code>
+| tnt.wad
 |-
 | Final Doom: The Plutonia Experiment
-| <code>plutonia.wad</code>
+| plutonia.wad
 |-
 | Chex Quest
-| <code>chex.wad</code>, [https://www.doomworld.com/idgames/?file=utils/exe_edit/patches/chexdeh.zip <code>chex.deh</code>]
+| chex.wad, [https://www.doomworld.com/idgames/?file=utils/exe_edit/patches/chexdeh.zip chex.deh]
 |-
 | [https://freedoom.github.io/ FreeDoom]: Phase 1
-| <code>freedoom.wad</code>
+| freedoom.wad
 |-
 | FreeDoom: Phase 2
-| <code>freedoom2.wad</code>
+| freedoom2.wad
 |-
 | FreeDM
-| <code>freedm.wad</code>
+| freedm.wad
 |-
 | Shareware Heretic *
-| <code>heretic1.wad</code>
+| heretic1.wad
 |-
 | Heretic / Shadow of the Serpent Riders
-| <code>heretic.wad</code>
+| heretic.wad
 |-
 | Hexen
-| <code>hexen.wad</code>
+| hexen.wad
 |-
 | Strife
-| <code>strife1.wad</code>, optionally <code>voices.wad</code>
+| strife1.wad, optionally voices.wad
 |}
-* included in <code>data.zip</code> for the latest Vita release
+*Files for games marked with * are already included in data.zip.
+*chex.deh is required for Chex to work correctly.
+*FreeDoom is a free and open source recreation of the original Doom 1 & 2 IWADs, but it is not 100% compatible with Chocolate Doom.
-== Loading PWADs (and other custom game files) ==
+===Loading PWADs (custom game files)===
-Put all custom files for a given game into <code>ux0:/data/chocolate/pwads/&lt;gamedir&gt;</code>, where <code>&lt;gamedir&gt;</code> is <code>doom</code> for all Doom games, <code>heretic</code> for Heretic and Shareware Heretic, <code>hexen</code> for Hexen and <code>strife</code> for Strife, then use the <code>Custom</code> tab in the launcher to select any custom content you want.
+Put all custom files for a given game into <code>ux0:/data/chocolate/pwads/&lt;gamedir&gt;</code>, where:
+* <code>&lt;gamedir&gt;</code> is <code>doom</code> for all Doom games.
+* <code>heretic</code> for Heretic and Shareware Heretic.
+* <code>hexen</code> for Hexen.
+* <code>strife</code> for Strife.
-== Recording demos ==
+Then use the <code>Custom</code> tab in the launcher to select any custom content you want.
-When <code>Record demo</code> is set to <code>On</code>, the demo is saved to <code>ux0:/data/chocolate/tmp/mydemo.lmp</code>.
-== Notes ==
+===Recording demos===
+When Record demo is set to On, the demo is saved to ux0:/data/chocolate/tmp/mydemo.lmp.
+===Notes===
 If the game closes without producing a crash dump or an error message, a file named <code>ux0:/data/chocolate/i_error.log</code> should be generated, which contains error messages.
@@ Line 122: / Line 116: @@
 By popular request some of the static render limits (<code>MAXVISPLANES</code>, <code>MAXVISSPRITES</code>, <code>MAXDRAWSEGS</code>) have been quadrupled in this fork to accomodate for SIGIL.
-==Changelogs==
+==Controls==
-'''v.3.1'''
+'''Launcher:'''
-* fixed texture corruption in Hexen and Heretic introduced in r3;
-* bumped version to 3.0.1 in launcher.
+L/R - Select tab
+Up/Down - Select option
+Left/Right - Adjust option
+Cross - Activate option (runs selected game when in Game tab)
+Start - Save settings and launch the game you have selected in the Game tab
+Circle - Save settings and exit launcher, Cancel selection when in file select dialog
+'''Basic controls:'''
+Left Analog - Move, Strafe
+Right Analog - Turn, Look
+R - Fire
+L - Run
+Square - Use
+Triangle/Circle - Change weapons
+Front touch - Toggle map
+Controls for a particular game can be viewed and changed in the Buttons and Input tabs of the launcher.
+==Screenshots==
+chocolatedoomvita3.png
+chocolatedoomvita4.png
+chocolatedoomvita5.png
+chocolatedoomvita6.png
+==Changelog==
+'''v3.1'''
+* Fixed texture corruption in Hexen and Heretic introduced in r3.
+* Bumped version to 3.0.1 in launcher.
-'''v.3.0'''
+'''v3.0'''
-* synced with upstream Chocolate Doom;
+* Synced with upstream Chocolate Doom.
-* raised some render limits to accommodate for SIGIL (it might still not work 100%).
+* Raised some render limits to accommodate for SIGIL (it might still not work 100%).
-'''v.2.0'''
+'''v2.0'''
-* added different scaling filters (some decrease pixel distortion);
+* Added different scaling filters (some decrease pixel distortion).
-* added basic multiplayer support (can host, connect by IP, find and join games on local network);
+* Added basic multiplayer support (can host, connect by IP, find and join games on local network).
-* added mouse emulation mode for right analog;
+* Added mouse emulation mode for right analog.
-* added more options to the launcher;
+* Added more options to the launcher.
-* launcher now detects FreeDoom 1 & 2, FreeDM and Chex Quest;
+* Launcher now detects FreeDoom 1 & 2, FreeDM and Chex Quest.
-* launcher now can use the touch screen keyboard to set some options;
+* Launcher now can use the touch screen keyboard to set some options.
-* fixed textmode screens (ENDOOM, error messages and other dialogs, Heretic startup screen, etc.);
+* Fixed textmode screens (ENDOOM, error messages and other dialogs, Heretic startup screen, etc.).
-* new LiveArea assets;
+* New LiveArea assets.
-* slightly increased performance.
+* Slightly increased performance.
-'''v.1.0'''
+'''v1.0'''
 * First Release.
-== Credits ==
+==Credits==
-* [https://github.com/chocolate-doom/chocolate-doom/blob/master/AUTHORS these people] for Chocolate Doom itself;
+* [https://github.com/chocolate-doom/chocolate-doom/blob/master/AUTHORS these people] for Chocolate Doom itself.
-* Vita SDK Team for the Vita SDK;
+* Vita SDK Team for the Vita SDK.
-* rsn8887 and cpasjuste for the SDL2 port;
+* rsn8887 and cpasjuste for the SDL2 port.
-* rsn8887 for the SDL_net port, some graphics-related code and testing;
+* rsn8887 for the SDL_net port, some graphics-related code and testing.
-* frangarcj for Vita Shader Collection and the FBO fork of Vita2D;
+* frangarcj for Vita Shader Collection and the FBO fork of Vita2D.
-* tiduscrying for the LiveArea assets;
+* tiduscrying for the LiveArea assets.
-* KINGGOLDrus for some launcher graphics;
+* KINGGOLDrus for some launcher graphics.
 * everyone on the #henkaku and #vitasdk IRC channels for help and/or testing.
-== External links ==
+==External links==
-* Official Website - https://www.chocolate-doom.org/
 * Wololo - https://wololo.net/talk/viewtopic.php?f=116&t=48973
-* Github - https://github.com/fgsfdsfgs/chocolate-doom
+* GitHub - https://github.com/fgsfdsfgs/chocolate-doom
 * VitaDB - https://vitadb.rinnegatamante.it/#/info/377