J-Stars Victory VS-EX

</p>

</p>

---

J-Stars Victory VS-EX is an unofficial fan port of J-Stars Victory VS+ (PS3) to Windows x64. Bring your own game: this repository holds no game code, no game assets and no firmware (no ISO, EBOOT, recompiled game code, captures or screenshots). You need your own copy of the game (US BLUS31519 or EU BLES02136) and its decrypted EBOOT, from your own copy, see RPCS3 and its documentation. Please do not post game files in issues or pull requests.

---

Pre-release (0.3.0), work in progress. The default build is the v19 tree, built on ps3recomp v0.19.0 (installer switch --tree current).

+---------------------------+------------------------+-------------------+
| What                      | Result                 | Measured on       |
+===========================+========================+===================+
| Lift, build, boot,        | Works                  | One Windows       |
| opening movie, menus,     |                        | machine, CI-built |
| fights with sound         |                        | setup program     |
+---------------------------+------------------------+-------------------+
| Frame rate, default tree  | About 30 frames per    | One Windows       |
|                           | second in the demo and | machine           |
|                           | in Free Battle         |                   |
+---------------------------+------------------------+-------------------+
| Frame rate, its earlier   | 16 to 22 frames per    | One Windows       |
| v18 build (toolkit        | second                 | machine           |
| v0.18.0)                  |                        |                   |
+---------------------------+------------------------+-------------------+
| Frame rate, earlier v15   | About 29 frames per    | One Windows       |
| tree (--tree legacy)      | second in fights       | machine           |
+---------------------------+------------------------+-------------------+
| Install with the setup    | Played                 | Play testers' own |
| program and the portable  |                        | Windows 11 PCs,   |
| zip, menus, fights,       |                        | AMD and NVIDIA    |
| online matches            |                        | graphics          |
+---------------------------+------------------------+-------------------+
| EU disc, first-start      | Not re-checked on the  | Not measured      |
| window, long runs         | default tree           |                   |
+---------------------------+------------------------+-------------------+
| Older CPU without AVX2    | Not tried; it will     | Not measured      |
|                           | most likely not run    |                   |
+---------------------------+------------------------+-------------------+
| Linux and Steam Deck      | Not supported; an      | Coming soon       |
| (Proton)                  | earlier v18 build      |                   |
|                           | reached fights under   |                   |
|                           | Proton in tests        |                   |
+---------------------------+------------------------+-------------------+

The default tree has had fewer tests than the v15 tree and has known problems: see KNOWN_ISSUES.md and issue #9. Play testers' reports are in KNOWN_ISSUES.md. A dated table, refreshed 2026-10-30 and mostly for the v15 tree, is in docs/notes/STATUS.md.

---

What you need

+------------------+------------------------------------------------------+
| Need             | Detail                                               |
+==================+======================================================+
| Windows          | Windows 10 or 11, x64. No admin rights.              |
+------------------+------------------------------------------------------+
| Your game        | The disc folder (the one with PS3_GAME) of the US or |
|                  | EU disc.                                             |
+------------------+------------------------------------------------------+
| The decrypted    | EBOOT.elf, from your own copy.                       |
| EBOOT            |                                                      |
+------------------+------------------------------------------------------+
| CPU              | AVX2 and FMA (Intel Haswell, 2013, or newer; AMD     |
|                  | Excavator or Zen).                                   |
+------------------+------------------------------------------------------+
| Disk space       | At least 4 GB free for the build, then about 2.5 GB  |
|                  | for the game data.                                   |
+------------------+------------------------------------------------------+
| Graphics         | A Windows driver with Direct3D 12.                   |
+------------------+------------------------------------------------------+

Linux and Steam Deck (Proton) are not supported yet. Every detail is in docs/INSTALL.md.

Steps

1. Download jsp-setup.exe from the 0.3.0 pre-release. A portable zip (jsp-0.3.0-portable.zip) is there too. You now have the file.
2. Run jsp-setup.exe. The setup wizard opens. Windows may warn that the file is not code-signed. To check the download first, compare its SHA-256 with the release page: SHA256SUMS.txt for 0.3.0 and earlier, SHA256SUMS from the next release (how).
3. Point the wizard at your disc folder and at EBOOT.elf. It checks both and names the problem if one is wrong.
4. Let setup finish. It builds the game on your PC, which takes a while. You see the finish page.
5. Open JSP Fan Revival from the Start menu. The launcher opens.
6. Start the game. The first start installs the game data, then the opening movie plays and the menus open.

You can also build jsp-setup.exe yourself: installer/README.md, "Building the installer".

If setup stops

Setup checks your inputs before the long build and refuses with a code:

• D1 to D3: the folder is not the disc folder, or the game is not US or EU. Other regions are refused.
• E1 to E3: the file is not a decrypted EBOOT.elf, or it is from the other region or another build. The game update 1.02 and digital editions are refused.
• P1, P2: the install or disc path has characters that break the build.
• S1: a folder is not writable, or there is too little free space.

The full list is in docs/INSTALL.md. If the build itself stops, click Build again in the Start menu to resume it.

---

Nothing goes online unless you turn Online Battle on. There is no update check, no crash report and no telemetry. The support bundle is a file on your Desktop that you attach yourself. Saves stay in %APPDATA%\JSP Fan Revival\hdd0 (a portable install: hdd0 in the install folder). Details: installer/README.md.

---

+--------------------------------------------------+----------------------+
|                                                  |                      |
+==================================================+======================+
| Native x64 code, not an emulator: the game's own | docs/LAYOUT.md       |
| code translated ahead of time with ps3recomp     |                      |
+--------------------------------------------------+----------------------+
| Built on your PC from your own copy; nothing     | installer/README.md  |
| from the game is shipped                         |                      |
+--------------------------------------------------+----------------------+
| Higher resolutions, a resizable window and       | Features: Display    |
| borderless fullscreen                            |                      |
+--------------------------------------------------+----------------------+
| Keyboard, mouse or controller, with a launcher   | Features: Input      |
| to rebind keys                                   |                      |
+--------------------------------------------------+----------------------+
| Training Mode in Free Battle                     | Features: Training   |
+--------------------------------------------------+----------------------+
| The game's own Online Battle over a self-hosted  | docs/ONLINE.md       |
| re-psn server (experimental, opt-in, newer tree) | (quick start)        |
+--------------------------------------------------+----------------------+
| Coming soon: online matches with rollback        | Roadmap, section 4   |
| netcode, spectating and lobbies                  |                      |
+--------------------------------------------------+----------------------+
| Coming soon: more match options and Training     | Roadmap, section 3   |
| options                                          |                      |
+--------------------------------------------------+----------------------+

---

• Controllers: keyboard, keyboard and mouse, or a controller that Windows reads through XInput (Xbox-style pads). Buttons can be remapped in the settings window.
• DualSense and DualSense Edge: read directly over USB or Bluetooth. This is marked "in progress", because the button tests are pending. It has no rumble or lightbar.
• Other pads: a pad that only works through DirectInput is not handled by the code. Use the keyboard.
• Player 2: the keyboard or a second controller.
• Display: the picture is 16:9 today. The window, a resolution scale and borderless fullscreen (F11) are in the settings window.
• Wide monitors: fullscreen stretches the picture to a monitor of another shape. Wide screens without stretching are planned.

See Features: Input, DualSense and Features: Wide screens. Saves, updating and uninstalling: docs/INSTALL.md.

---

Heavy fights can drop to about 20 frames per second. The Training freeze after Return to character select and two online freezes are open. The default build needs a CPU with AVX2. The full list, with the build each affects and a workaround where there is one, is in KNOWN_ISSUES.md. Status is tracked in issue #9.

---

+----------------+-----------------------------------+--------------------+
| You see        | Do this                           | Log                |
+================+===================================+====================+
| Setup stops    | Read the code in the message, see | logs\firstrun-<tim |
|                | "If setup stops". Then click      | e>.log             |
|                | Build again in the Start menu.    |                    |
+----------------+-----------------------------------+--------------------+
| A black screen | Click Build again. If that does   | game\run\launcher_ |
|                | not help, make a support bundle.  | log.txt            |
+----------------+-----------------------------------+--------------------+
| A pad does     | Use the keyboard, or an XInput    | game\run\launcher_ |
| nothing        | pad.                              | log.txt            |
+----------------+-----------------------------------+--------------------+
| Windows or an  | The files are not code-signed;    | None               |
| antivirus      | check the SHA-256 sums.           |                    |
| warns          |                                   |                    |
+----------------+-----------------------------------+--------------------+

More symptoms and the log places: docs/TROUBLESHOOTING.md.

To report a bug, click Make a support bundle (JSP Fan Revival) in the Start menu (portable zip: double-click support-bundle.cmd). It writes jsp-support-<time>.zip on the Desktop. It holds logs and settings as text, never the EBOOT, disc files or saves, and it sends nothing anywhere. Attach it to a new issue and say which graphics card and CPU you have. The forms are: bug report, performance report, play-test report, feature request, and feedback or question. Never attach game files.

---

Players build the game with the installer. For a hand build, the checks and the tree layout, see docs/BUILDING.md, docs/LAYOUT.md and installer/README.md.

---

The installer lifts the game's PowerPC and SPU code from your EBOOT.elf to C. It compiles that with a bundled compiler and links it against the ps3recomp runtime. The runtime provides the PS3 system libraries and draws through Direct3D 12. Details: installer/README.md and docs/LAYOUT.md.

---

Close the open problems of the v19 tree (issue #9), then online rollback, more match options and Linux through Proton. See docs/ROADMAP.md.

---

Pull requests are welcome: CONTRIBUTING.md. Only main is used. Rules for AI coding agents are in AGENTS.md. Community: Discord.

---

Developed with AI agent assistance under the maintainers' direction.

---

The port's own code, tools and documentation are MIT, see LICENSE. Security problems: SECURITY.md.

Unofficial fan project. Not affiliated with, authorized or endorsed by the game's publisher, developer or rights holders. Trademarks belong to their owners. You need your own copy of the game.

---

Third-party software and licences: NOTICE.md. People: CONTRIBUTORS.md.

ps3recomp

This project is built on ps3recomp by Ned Heller (sp00nznet) and contributors, licensed under the MIT licence. Parts of jstars/port/ started as copies of the ps3recomp project template (for example main.cpp, stubs.cpp, CMakeLists.txt and config.toml). The patches in docs/archive/jstars-notes/patches/ are written against ps3recomp source files. Keep ps3recomp's copyright and licence notice with any of these files that you copy.

The toolkit itself is not part of this tree: third_party/ps3recomp is a submodule that points at ps3recomp's v0.15.0 commit, and its files come from the upstream repository. Changes to ps3recomp are kept only as patches: jstars/toolkit/ps3recomp-local.patch (the set the port builds with) and the single-experiment patches under docs/archive/jstars-notes/patches.

SMAA

jstars/toolkit/third_party_smaa/ holds four files from SMAA (Enhanced Subpixel Morphological Antialiasing) by Jorge Jimenez, Jose I. Echevarria, Belen Masia, Fernando Navarro and Diego Gutierrez, https://github.com/iryoku/smaa, licensed under the MIT licence. AreaTex.h, SearchTex.h and SMAA.hlsl are the upstream files with their copyright and licence header (it names the authors), unchanged. SMAA_hlsl.inc is generated from SMAA.hlsl and carries a one-line attribution. jstars/toolkit/apply_toolkit.py copies them into the patched toolkit, where the patched video library uses them for the "SMAA" edge smoothing option. Keep the header with any copy of these files.

rpcs3_locate

installer/tools/rpcs3_locate.py and its test installer/tools/test_rpcs3_locate.py are a helper shared between several unofficial ports of PS3 games, among them undecuple's Project Pyrrhus (see below), under the same MIT licence, vendored from the shared copy of 2026-11-03 (sha256 of the module then 5f98c82632f1e8d6837171080afd62057db2431a1153554f429678d5c0003703), with one change since: a games.yml entry that is an .iso file is recognised (is_iso) instead of refused as "not a folder", and is never searched for an EBOOT.elf. It only reads an RPCS3 install's configuration and game folders; its one write is the save copy that the installer asks the player to confirm. installer/tools/rpcs3_wizard.py is this repository's glue around it.

Project Pyrrhus and Project Helghast

Parts of the installer and the tools started from two other unofficial PS3 ports by undecuple, both under the MIT licence (Copyright (c) 2026 undecuple): Project Pyrrhus (Killzone 2) and Project Helghast (Killzone 3), from which Project Pyrrhus's installer was made.

• From Project Pyrrhus's installer: the layout of installer/jsp.iss, installer/launcher/launcher.c, installer/tools/firstrun.py, assemble_payload.py, assemble_portable.py, fetch_toolchain.py, installer_art.py and llvm-mingw.cmake. The game-specific parts are this repository's.
• From Project Helghast: tools/features.py. Also the approach of the pinned Inno Setup step in .github/workflows/installer.yml and of installer/tools/support_bundle.py, with no code copied for these two.

Each of these files names its source in a comment.

RPCS3

RPCS3 is a separate tool (GPL-2.0). The notes mention it for reference runs and comparison screenshots, and the port reads files from an RPCS3 installation at run time. No RPCS3 code is included in this tree.

Installer

installer/ builds a Windows installer with Inno Setup (Jordan Russell and Martijn Laan; its licence allows installers made with it to be distributed). Nothing of Inno Setup is in this tree. The installer package carries, besides this repository's own files, the embeddable Windows package of Python (Python Software Foundation licence, text kept in the package as toolchain\python\LICENSE.txt), which whoever builds the installer downloads from python.org; a pinned build of llvm-mingw (Martin Storsjö; LLVM: Apache-2.0 with LLVM exception; MinGW-w64: ZPL-2.1 and public-domain parts, some headers derived from Wine under LGPL-2.1 or later; winpthreads: MIT and BSD-3-Clause), CMake (Kitware, BSD-3-Clause) and Ninja (Apache-2.0), which whoever builds the installer downloads with installer/tools/fetch_toolchain.py (versions and SHA-256 in installer/tools/toolchain.json; their licence texts go into the package under licenses\, and installer/licenses/LGPL-2.1.txt is the one text kept in this tree); the ps3recomp toolkit with jstars/toolkit/ps3recomp-local.patch applied (MIT, see above; SMAA as above); and the licence texts of this repository. The wizard images are drawn at build time in IBM Plex Mono Bold (IBM Corp., SIL Open Font License 1.1; the font file is not included here and the images contain only the rendered text). The Port Settings menu labels and glyphs are drawn at build time in Fira Sans Heavy Italic 4.301 (bBoxType/FiraSans, SIL Open Font License 1.1); the font file is not included here or in the package, and the art contains only the rendered text.

Installer music

The installer has an "Enable Music?" box (off by default). The six tracks are bytebeat and floatbeat formulas in installer/music/, taken from the bytebeat-composer library (Copyright (c) 2021 SthephanShi, MIT licence, text below). installer/tools/installer_music.py renders them to sound files at build time; no sound file is stored here. Mode, rate and source of each are in installer/music/tracks.tsv.

• "true phonk indeed" by eSlashMachine, https://dollchan.net/btb/res/6946.html#11537 (the library's code is a close but not identical version of the formula kept here)
• "difficult level" by computerman113, https://www.reddit.com/r/bytebeat/comments/1hfy2uj/difficult_level/
• "Changsha wip" by D3nschøt, https://www.reddit.com/r/bytebeat/comments/1df4gxo/idk/
• "a new adventure" by Demari Smith, https://dollchan.net/btb/res/3.html#5895
• "generator" by eSlashMachine, https://dollchan.net/btb/res/6946.html#14913
• "dystopia" by eSlashMachine, https://dollchan.net/btb/res/6946.html#12004

MIT License

Copyright (c) 2021 SthephanShi

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Other software used at build or run time (not included)

• For a hand build: Visual Studio Build Tools, clang-cl, CMake and Ninja. The installer uses the bundled llvm-mingw, CMake and Ninja instead.
• FFmpeg libraries are loaded at run time from DLLs that you supply. None are included here.

Fonts in the images

The PNG files in assets/ are set in IBM Plex Mono Bold (copyright IBM Corp., SIL Open Font License 1.1). The font files are not included here; the images contain only the rendered text. The web page uses the system's monospace fonts.

The game

J-Stars Victory VS+ and its data belong to their rights holders. No game data is included here. This is an unofficial fan project; trademarks belong to their owners.

Licence of this repository's own files

MIT, see LICENSE. This matches the licence of ps3recomp.

Unofficial fan site. Unofficial fan project. No game files included. J-Stars Victory VS-EX is not affiliated with, authorized or endorsed by the game's publisher, developer or rights holders. Trademarks belong to their owners.

Source and notices: https://github.com/Tsamiuy/jsp-vs-ex. Community: https://discord.gg/h3j2wFwqvn

System monospace fonts only; nothing is loaded from elsewhere. Generated from the repository's README.md and NOTICE.md; no JavaScript.