|
4 | 4 | * [This fork](https://github.com/frangarcj/vita2dlib/tree/fbo) of Vita2D; |
5 | 5 | * [Latest release](https://github.com/frangarcj/vita-shader-collection/releases/latest) of Vita Shader Collection. |
6 | 6 |
|
| 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 | + |
7 | 9 | ### Build instructions |
8 | 10 | 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