mirror of
https://github.com/lowbit/ps5-doom.git
synced 2026-10-06 08:00:23 +02:00
rijads
674f88487d
DOOM now opens on a game list. The package bundles id's freely distributable shareware DOOM1.WAD; players add The Ultimate DOOM, DOOM II, TNT and Plutonia (or Freedoom) from their own files: - copied into /data/homebrew/PPSA99666/wads, as WADs or inside ZIP, 7Z or RAR archives, which are imported once at the next start; - downloaded from an http:// or https:// link typed on the system keyboard: a WAD, an archive, or a folder listing to pick from. Archives are read in place over HTTP range requests, so a large solid 7Z needs no room on the console beyond the game WADs it holds. The console uses sceHttp/sceSsl and the IME dialog; the PC build uses libcurl. Archives go through libarchive, liblzma and zlib, fetched pinned and built for both targets, with large allocations taken from mmap. Engine fixes that came with it: IdentifyVersion takes the launcher's choice and sets gamemission, so TNT and Plutonia get their own level names and finale texts; the sky check no longer gives The Ultimate DOOM the DOOM II skies; saves are per game; widescreen full-screen pictures from the 2024 re-release are drawn centred instead of rejected. The console test runner receives doom.log over the capture connection instead of reading the kernel log.
86 lines
3.9 KiB
Markdown
86 lines
3.9 KiB
Markdown
<p align="center"><img src="title/icon0.png" width="160" alt="DOOM icon"></p>
|
|
|
|
# DOOM for PS5 (native)
|
|
|
|
id Software's original DOOM source (`linuxdoom-1.10`) running as a native PS5 title: its own
|
|
home-screen icon, drawn on the GPU through Sony's AGC driver and VideoOut, DualSense input with
|
|
analog sticks and rumble, and the DOS-era FM music synthesised from the game's own instrument bank.
|
|
It ships with the free shareware episode of DOOM and plays The Ultimate DOOM, DOOM II and Final
|
|
DOOM from your own game files, which it can import from a folder on the console or download from
|
|
your PC, including straight out of ZIP, 7Z and RAR archives.
|
|
|
|
## Requirements
|
|
|
|
A jailbroken PS5 with kstuff (fake-signed executables) and
|
|
[ShadowMountPlus](https://github.com/drakmor/ShadowMountPlus). Tested on firmware 13.00.
|
|
|
|
## Install
|
|
|
|
1. Download `PPSA99666.zip` from the [releases](../../releases) and check it against
|
|
`PPSA99666.zip.sha256`.
|
|
2. Extract it and copy the `PPSA99666` folder to `/data/homebrew/` (FTP, ps5upload or USB).
|
|
3. ShadowMountPlus registers it within a few seconds and **DOOM** appears on the home screen.
|
|
|
|
## Games
|
|
|
|
DOOM opens on a game list. Out of the box it holds the shareware episode, *Knee-Deep in the Dead*;
|
|
every game you add appears there too, and the last one you played stays selected.
|
|
|
|
| File | Game |
|
|
| --- | --- |
|
|
| `DOOM.WAD`, `DOOMU.WAD` | DOOM, or The Ultimate DOOM when it has episode 4 |
|
|
| `DOOM2.WAD` | DOOM II: Hell on Earth |
|
|
| `TNT.WAD` | Final DOOM: TNT Evilution |
|
|
| `PLUTONIA.WAD` | Final DOOM: The Plutonia Experiment |
|
|
| `FREEDOOM1.WAD`, `FREEDOOM2.WAD` | [Freedoom](https://freedoom.github.io/) Phase 1 and 2 |
|
|
|
|
The files from the original releases and from the 2024 *DOOM + DOOM II* re-release both work.
|
|
|
|
### Adding your games
|
|
|
|
Either way, the game files can also be inside ZIP, 7Z or RAR archives: DOOM extracts the game
|
|
WADs it recognises and skips everything else.
|
|
|
|
- **Copy them to the console.** Put the files or archives in `/data/homebrew/PPSA99666/wads/` (FTP,
|
|
ps5upload or USB). DOOM picks them up the next time it starts.
|
|
- **Download them from a link.** In the game list choose *Add games...*, then *Link*, type an
|
|
`http://` or `https://` address on the console keyboard and choose *Download*. The link can point
|
|
at a WAD, an archive, or a folder; for a folder DOOM lists the files and you pick one or all.
|
|
|
|
The simplest way to serve your own files from a PC on the same network is to open a terminal in the
|
|
folder that holds them and run a small web server, then use the address it prints with your PC's
|
|
local IP (for example `http://192.168.1.20:8000/`):
|
|
|
|
```bash
|
|
python -m http.server 8000
|
|
```
|
|
|
|
Any web server that lists a folder works (nginx, Apache, Caddy, IIS, `npx http-server`). One that
|
|
supports range requests (all of those except Python's) lets DOOM read a 7Z or ZIP without
|
|
downloading the parts it does not need; with Python's server it still works, just with more
|
|
traffic. Allow the port through the PC's firewall if the console cannot connect.
|
|
|
|
## Controls
|
|
|
|
| Input | In game | In menus |
|
|
| --- | --- | --- |
|
|
| Left stick | Move and strafe | Navigate |
|
|
| Right stick | Turn (speed follows Mouse Sensitivity) | |
|
|
| D-pad | Move and turn | Navigate |
|
|
| R2 | Fire | |
|
|
| Cross / Square | Use | Select, yes |
|
|
| Circle | Strafe modifier | Back, no |
|
|
| L1 / R1 | Previous / next weapon (automap zoom) | |
|
|
| L2 | Run | |
|
|
| Triangle / touchpad | Automap (Square: follow mode) | |
|
|
| Options | Menu | Close menu |
|
|
|
|
Saves and settings stay on the console, and each game keeps its own saves. Holding **L1+R1** at launch uses the CPU scaler instead of
|
|
the GPU, should a firmware ever disagree with the GPU path.
|
|
|
|
## Building and internals
|
|
|
|
See [DEVELOPMENT.md](DEVELOPMENT.md) for the build, the architecture, the console test loop and the
|
|
PS5 behaviour learned along the way. Licenses and credits: [LICENSE](LICENSE) (GPL v2, id's
|
|
source) and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
|