Skip to content

Commit dbf8c52

Browse files
authored
update README.Vita.md
1 parent c1923a3 commit dbf8c52

File tree

1 file changed

+68
-0
lines changed

1 file changed

+68
-0
lines changed

README.Vita.md

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,5 +4,73 @@
44
* [This fork](https://github.com/frangarcj/vita2dlib/tree/fbo) of Vita2D;
55
* [Latest release](https://github.com/frangarcj/vita-shader-collection/releases/latest) of Vita Shader Collection.
66

7+
Both libraries should be installed to the SDK directory (i. e. to `$(VITASDK)/arm-vita-eabi/lib` and `$(VITASDK)/arm-vita-eabi/include`).
8+
79
### Build instructions
810
Run `make -f Makefile.vita`. This should produce a VPK.
11+
12+
## Using the Vita port
13+
### Installation
14+
1. Install VPK.
15+
2. Extract `data.zip` from the latest release to root of memory card (`ux0:`).
16+
3. Copy any supported IWADs (see below) you have to `ux0:/data/chocolate/iwads/`.
17+
18+
### Launcher controls
19+
* LTrigger/RTrigger: select tab
20+
* Up/Down: select option
21+
* Left/Right: adjust option
22+
* Cross: activate option
23+
* Start: save settings and launch the game you have selected in the `Game` tab (in single-player mode)
24+
* Circle: save settings and exit launcher / cancel selection when in file select dialog
25+
26+
Controls for a particular game can be viewed and changed in the `Buttons` and `Input` tabs.
27+
28+
### Supported games / IWADs
29+
To play a game from this list, copy the corresponding files to `ux0:/data/chocolate/iwads/`.
30+
31+
| Game | File(s) |
32+
|----------------------------------------|----------------|
33+
| Shareware Doom * | `doom1.wad` |
34+
| Doom / Ultimate Doom | `doom.wad` |
35+
| Doom II | `doom2.wad` |
36+
| Final Doom: TNT Evilution | `tnt.wad` |
37+
| Final Doom: The Plutonia Experiment | `plutonia.wad` |
38+
| Chex Quest | `chex.wad`, [`chex.deh`](https://www.doomworld.com/idgames/?file=utils/exe_edit/patches/chexdeh.zip) |
39+
| [FreeDoom](https://freedoom.github.io/): Phase 1 | `freedoom.wad` |
40+
| FreeDoom: Phase 2 | `freedoom2.wad`|
41+
| FreeDM | `freedm.wad` |
42+
| Shareware Heretic * | `heretic1.wad` |
43+
| Heretic / Shadow of the Serpent Riders | `heretic.wad` |
44+
| Hexen | `hexen.wad` |
45+
| Strife | `strife1.wad`, optionally `voices.wad` |
46+
47+
\* included in `data.zip` for the latest Vita release
48+
49+
### Loading PWADs (and other custom game files)
50+
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 and `strife` for Strife, then use the `Custom` tab in the launcher to select any custom content you want.
51+
52+
### Recording demos
53+
When `Record demo` is set to `On`, the demo is saved to `ux0:/data/chocolate/tmp/mydemo.lmp`.
54+
55+
### Notes
56+
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.
57+
58+
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.
59+
60+
To join a game by IP, select `Game address`, enter the address, then hit `Connect to address`.
61+
62+
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.
63+
64+
The `Merge file` option is the launcher version of the `-merge` command line option. See the Chocolate Doom wiki for more details.
65+
66+
You can specify custom command line parameters in a [response file](https://doomwiki.org/wiki/Parameter#.40), then load it using the `Override response file` option. Don't forget to select the correct game.
67+
68+
## Credits
69+
- [these people](https://github.com/chocolate-doom/chocolate-doom/blob/master/AUTHORS) for Chocolate Doom itself;
70+
- Vita SDK Team for the Vita SDK;
71+
- rsn8887 and cpasjuste for the SDL2 port;
72+
- rsn8887 for the SDL_net port, some graphics-related code and testing;
73+
- frangarcj for Vita Shader Collection and the FBO fork of Vita2D;
74+
- tiduscrying for the LiveArea assets;
75+
- KINGGOLDrus for some launcher graphics;
76+
- everyone on the #henkaku and #vitasdk IRC channels for help and/or testing.

0 commit comments

Comments
 (0)