Files
libretro/emulators/opengoal.yml
T

86 lines
5.0 KiB
YAML

emulator: OpenGOAL
type: standalone
core_classification: game_engine
source: "https://github.com/open-goal/jak-project"
upstream: "https://github.com/open-goal/jak-project"
source_commit: "6445b4a50a7540df512e3c82c62216521421410c"
pin_frozen: "RetroBat, the only platform that ships it, installs this release: the gk.exe of its opengoal.7z package (10 October 2026) is byte identical to the one in opengoal-windows-v0.3.8.zip. Later releases are not part of that package."
profiled_date: "2026-10-20"
core_version: "v0.3.8"
display_name: "Jak and Daxter (OpenGOAL)"
cores: [opengoal]
systems: [opengoal]
notes: |
Native port of the Jak and Daxter games built from the decompiled GOAL
code. gk runs the game, goalc compiles GOAL source, and extractor turns the
user's PS2 ISO into the data gk loads.
RetroBat installs v0.3.8: the gk.exe, goalc.exe and extractor.exe of its
opengoal.7z are byte identical to opengoal-windows-v0.3.8.zip, and its data
tree has the same files, so the profile is pinned to that tag. The
launcher reads the game name (jak1, jak2 or jak3) from the first line of
the ROM file, then checks data/out/<game>/iso. When that folder is missing
it runs "extractor.exe -g <game> -e -d -c <iso>" with the ISO path set in
the system options, and refuses to start without one. It then starts
gk.exe -g <game> with its own config folder.
extractor (decompiler/extractor/main.cpp):
1. -e takes a file whose extension is .iso and which is larger than
1000000000 bytes, unpacks it into iso_data/_temp and computes an XXH64
over the hashes of all its files (decompiler/extractor/extractor_util.cpp:278-304,
decompiler/extractor/main.cpp:295-317).
2. validate needs a DGO folder in the extraction. It reads the serial
from the boot ELF name (SCUS_971.24 gives SCUS-97124) and hashes that
ELF with XXH64, then looks both up in extractor_iso_database
(decompiler/extractor/main.cpp:35-110, decompiler/extractor/extractor_util.cpp:30-166, 229-251). A missing DGO
folder stops extraction. Any other mismatch only fails the run under
-v, which RetroBat does not pass, and leaves the data in
iso_data/_temp instead of iso_data/<game> (decompiler/extractor/main.cpp:318-335).
3. -d decompiles with the config of the detected release, -c compiles
goal_src into data/out/<game>.
The database knows Jak 1 as SCUS-97124 (Black Label and Greatest Hits),
SCES-50361, SCPS-15021 and SCPS-56003, Jak 2 as SCUS-97265, SCES-51608,
SCPS-15057 and SCKA-20010, and Jak 3 as SCUS-97330, SCUS-97516,
SCKA-20040 and SCES-52460. The contents hashes it stores are XXH64
values over per file hashes, not hashes of the ISO file, so no entry
below carries one.
At run time gk reads only what the extractor and compiler built:
out/<game>/iso, listed by the fake ISO file system, and out/<game>/fr3
for the renderer (game/overlord/common/fake_iso.cpp:57-71,
game/graphics/pipelines/opengl.cpp:90). The data folder of the release
(goal_src, decompiler/config, custom_assets, game/assets, launcher) is
program source and configuration the compiler reads, shipped with every
build. goal_src/jakx is present, but the extractor accepts only jak1, jak2
and jak3 at this tag (decompiler/extractor/main.cpp:16-18, 289-292).
files:
- name: "jak1.iso"
category: game_data
system: opengoal
required: true
description: "Jak and Daxter: The Precursor Legacy PS2 disc image"
source_ref: "decompiler/extractor/main.cpp:295-335, decompiler/extractor/extractor_util.cpp:30-79, 278-294"
note: "No file name is fixed. Accepted serials SCUS-97124, SCES-50361, SCPS-15021 and SCPS-56003, identified by the boot ELF name and its XXH64. Read once by the extractor, which builds out/jak1 for gk."
unsourceable: "retail disc image the collection does not hold, and a same-named image of another game must not stand in"
- name: "jak2.iso"
category: game_data
system: opengoal
required: true
description: "Jak II PS2 disc image"
source_ref: "decompiler/extractor/main.cpp:295-335, decompiler/extractor/extractor_util.cpp:80-123, 278-294"
note: "No file name is fixed. Accepted serials SCUS-97265, SCES-51608, SCPS-15057 and SCKA-20010, identified by the boot ELF name and its XXH64. Read once by the extractor, which builds out/jak2 for gk."
unsourceable: "retail disc image the collection does not hold, and a same-named image of another game must not stand in"
- name: "jak3.iso"
category: game_data
system: opengoal
required: true
description: "Jak 3 PS2 disc image"
source_ref: "decompiler/extractor/main.cpp:295-335, decompiler/extractor/extractor_util.cpp:124-163, 278-294"
note: "No file name is fixed. Accepted serials SCUS-97330, SCUS-97516, SCKA-20040 and SCES-52460, identified by the boot ELF name and its XXH64. Read once by the extractor, which builds out/jak3 for gk."
unsourceable: "retail disc image the collection does not hold, and a same-named image of another game must not stand in"