Skip to content

Build the European version (GPOP8P) - #237

Open
Elias843 wants to merge 15 commits into
zeroz41:masterfrom
Elias843:pal-build
Open

Elias843 wants to merge 15 commits into
zeroz41:masterfrom
Elias843:pal-build

Conversation

@Elias843

@Elias843 Elias843 commented Nov 9, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Adds the European release, Phantasy Star Online Episode I & II (GPOP8P), as a second version of the build, and
decompiles the code where it differs from the USA version. Every European difference is behind
#if VERSION == VERSION_GPOP8P (include/versions.h); the USA build is unchanged.

  • python configure.py --version GPOP8P && ninja: European PsoV3.dol OK, 100% code matched, every unit
    linked (2,450), data 100%. The European config leaves out two USA-only units that have no bytes there
    (NetworkInfoRequests, text_8036F764).
  • python configure.py && python tools/check_pr.py: PASS on every commit, no USA changes in the report.

Commits

  1. Tools: configure.py --version, VERSION define, link_units.py / localize_split_globals.py /
    report_delta.py / orig_asm.py take the version, check_pr.py refuses a non-USA configure.
  2. config/GPOP8P/psov3/: symbols, splits and config at the European addresses; links every unit whose code
    is already the same in both versions (2,309).
  3. to 14. One commit per area for the European code (SDK video mode, CRC-32 file in the keyboard code, PRS
    decompressors, ntInf network configuration, modem check, disc error messages, protocol and lobby, quests and
    challenges, character select and save files, title and menus, in-game windows, game objects). Each links the
    units it completes.
  4. Links the SDK, TRK and MSL units and QuestOpcodeTables.

From the second commit on, each commit builds both DOLs OK (the first adds no European config yet).

Shared code

A few USA lines change without changing the USA objects: state numbers and table sizes go through macros
(CHR_SEL_A_STATE(n) etc., (n) in the USA build) where the European version drops states, a few constants are
named, and two files have a second part included under a define (TEXT_803F3BF8_SECOND_FILE,
TKEYBOARDCONTROL_SECOND_FILE) because the European disc builds those parts as their own files.

@github-actions

github-actions Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

✅ CI passed · 849346f899 · run

Check Result
Build + DOL SHA-1 ✅
No regressions (report_delta --check) ✅
Linked units still link ✅
Metric Base PR Δ
Matched data (bytes) 1,758,510 1,758,510 0
Complete data (bytes) 1,758,510 1,758,510 0
Matched code (bytes) 4,353,092 4,353,092 0
Complete code (bytes) 4,353,092 4,353,092 0
Matched functions 27,572 27,572 0
Linked units 2,449 2,449 0

0 new exact functions, 0 function regressions, 0 renamed functions.

@Elias843
Elias843 force-pushed the pal-build branch 2 times, most recently from e8b2284 to 1d7a9bb Compare November 9, 2026 11:17
@Elias843
Elias843 marked this pull request as ready for review November 9, 2026 11:55
@zeroz41
zeroz41 requested a review from humarpso November 9, 2026 17:33
@zeroz41

zeroz41 commented Nov 9, 2026

Copy link
Copy Markdown
Owner

I'd be overall ok having this.

Couple things:
As more units from US versions get folded into real TUs and consolidated named homes, how would the workflow look for assuring other versions paritys. It looks like you were able to get most things lined up via addresses offsets based on US version?

Would you maintain this, or have plans to automate parts?

Changes to CI needed?

@humarpso hope for your input. thanks

@Elias843

Copy link
Copy Markdown
Collaborator Author

Yeah they're mostly the same and the European one is based on the US one with a mapping between them (for almost all functions). I'm happy to look after it. I can make a PR after this to build both versions in CI

@zeroz41

zeroz41 commented Nov 10, 2026

Copy link
Copy Markdown
Owner

apparently there is no plus version for PAL? This decomp is about plus version.

@zeroz41

zeroz41 commented Nov 10, 2026 •

Copy link
Copy Markdown
Owner

closing. no plus version exists for pal. not in scope.

@zeroz41 zeroz41 closed this Nov 10, 2026
@zeroz41

zeroz41 commented Nov 11, 2026

Copy link
Copy Markdown
Owner

@Elias843 btw sorry for closing this so quick. we can potentially put this in scope later. but perhaps too soon?
jp plus version would be an option as well i'd imagine.

@zeroz41 zeroz41 reopened this Nov 11, 2026
@Elias843

Copy link
Copy Markdown
Collaborator Author

No worries, yeah it may be a bit too soon now I agree. I think it'll be easier once we've fully matched (and linked?) the US DOL first. Anyways, I'll keep doing the work locally until we're ready. I'll change this to a draft PR for now

Also was thinking jp plus would be nice to have here as well, yeah 😄

@Elias843
Elias843 marked this pull request as ready for review November 20, 2026 07:34

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants