[PR #257] [MERGED] skills(reverse-engineering): unpacking fully compressed UE3 .upk packages (UE Viewer's decompressor + an LZO fallback script) #256

New issue

Closed

opened 2026-10-15 20:54:51 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-15 20:54:51 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/rehan-remade/universal-modder/pull/257
Author: @Davidoff-byte
Created: 10/12/2026
Status: ✅ Merged
Merged: 10/12/2026
Merged by: @rehan-remade

Base: main ← Head: kb/handoff-psp-ports-skills

📝 Commits (2)

cbe55c8 skills: add the handoff and psp-ports skills, plus a UE3 .upk unpacker reference
3e9512c skills: keep the UE3 .upk unpacker reference, drop handoff and psp-ports (review fixes)

📊 Changes

9 files changed (+549 additions, -0 deletions)

View changed files

📝 .agents/skills/reverse-engineering/SKILL.md (+3 -0)
➕ .agents/skills/reverse-engineering/references/ue3-packages/README.md (+65 -0)
➕ .agents/skills/reverse-engineering/references/ue3-packages/unpack_upk.py (+115 -0)
📝 .claude/skills/reverse-engineering/SKILL.md (+3 -0)
➕ .claude/skills/reverse-engineering/references/ue3-packages/README.md (+65 -0)
➕ .claude/skills/reverse-engineering/references/ue3-packages/unpack_upk.py (+115 -0)
📝 skills/reverse-engineering/SKILL.md (+3 -0)
➕ skills/reverse-engineering/references/ue3-packages/README.md (+65 -0)
➕ skills/reverse-engineering/references/ue3-packages/unpack_upk.py (+115 -0)

📄 Description

What: Two new skills — handoff (write the live session to one portable file so a fresh agent in another harness, directory or machine can pick it up) and psp-ports (make a game run on PSP: the hardware ceiling, the five routes, the pspdev toolchain and EBOOT.PBP, PPSSPP-then-hardware testing, asset conversion, the no-ROMs/no-assets rules) — plus a UE3 .upk unpacker reference for the reverse-engineering skill.

Details

skills/handoff/ — SKILL.md + references/handoff-document.md
skills/psp-ports/ — SKILL.md + references/routes.md, references/port-plan.md
skills/reverse-engineering/SKILL.md — a three-line pointer to the new .upk reference
skills/reverse-engineering/references/ue3-packages/ — README.md + unpack_upk.py (a decoder for a fully LZO-compressed UE3 .upk, which UELib's stub decompressor and UPKUtils can't read; then clear only the CompressionFlags dword so UELib reads it)
Mirrored into .agents/skills/ and .claude/skills/, which this repo keeps as real copies of skills/ (tests/test_um.py::test_skill_copies_match enforces byte-for-byte parity, so new skills must land in all three trees)
README.md — two rows added to the skills table

Checklist

uv run --with pytest pytest -q tests passes (97 passed, 3 skipped)
um kb check --index passes (182 notes checked) — no field notes in this PR, index untouched
um publish check . — 544 files, 0 failures, 2 warnings (both pre-existing knowledge/ notes; the new files add none)
no game files, extracted assets, decompiled code dumps or secrets
nothing that cheats other players or bypasses anti-cheat / DRM / ownership checks — the psp-ports skill states the no-ROMs/no-assets publishing rules explicitly
versions, verification and what was NOT verified are written down
authored by (agent + model / human): OpenCode (deepseek-flash) with @Davidoff-byte

Not verified: the PSP skill's toolchain steps (pspdev install, EBOOT.PBP packaging, PPSSPP/hardware runs) were written from research, not executed on a PSP in this PR.

Rebased onto current main (2c22014); README.md merged cleanly with the upstream OpenCode-plugin changes (both kept).

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/rehan-remade/universal-modder/pull/257 **Author:** [@Davidoff-byte](https://github.com/Davidoff-byte) **Created:** 10/12/2026 **Status:** ✅ Merged **Merged:** 10/12/2026 **Merged by:** [@rehan-remade](https://github.com/rehan-remade) **Base:** `main` ← **Head:** `kb/handoff-psp-ports-skills` --- ### 📝 Commits (2) - [`cbe55c8`](https://github.com/rehan-remade/universal-modder/commit/cbe55c8b333320cac1c7b6aa990568432d1c614d) skills: add the handoff and psp-ports skills, plus a UE3 .upk unpacker reference - [`3e9512c`](https://github.com/rehan-remade/universal-modder/commit/3e9512c9281b93619d656dc992ccb7cad061f4ec) skills: keep the UE3 .upk unpacker reference, drop handoff and psp-ports (review fixes) ### 📊 Changes **9 files changed** (+549 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `.agents/skills/reverse-engineering/SKILL.md` (+3 -0) ➕ `.agents/skills/reverse-engineering/references/ue3-packages/README.md` (+65 -0) ➕ `.agents/skills/reverse-engineering/references/ue3-packages/unpack_upk.py` (+115 -0) 📝 `.claude/skills/reverse-engineering/SKILL.md` (+3 -0) ➕ `.claude/skills/reverse-engineering/references/ue3-packages/README.md` (+65 -0) ➕ `.claude/skills/reverse-engineering/references/ue3-packages/unpack_upk.py` (+115 -0) 📝 `skills/reverse-engineering/SKILL.md` (+3 -0) ➕ `skills/reverse-engineering/references/ue3-packages/README.md` (+65 -0) ➕ `skills/reverse-engineering/references/ue3-packages/unpack_upk.py` (+115 -0) </details> ### 📄 Description **What:** Two new skills — `handoff` (write the live session to one portable file so a fresh agent in another harness, directory or machine can pick it up) and `psp-ports` (make a game run on PSP: the hardware ceiling, the five routes, the pspdev toolchain and EBOOT.PBP, PPSSPP-then-hardware testing, asset conversion, the no-ROMs/no-assets rules) — plus a UE3 `.upk` unpacker reference for the reverse-engineering skill. **Details** - `skills/handoff/` — `SKILL.md` + `references/handoff-document.md` - `skills/psp-ports/` — `SKILL.md` + `references/routes.md`, `references/port-plan.md` - `skills/reverse-engineering/SKILL.md` — a three-line pointer to the new `.upk` reference - `skills/reverse-engineering/references/ue3-packages/` — `README.md` + `unpack_upk.py` (a decoder for a fully LZO-compressed UE3 `.upk`, which UELib's stub decompressor and UPKUtils can't read; then clear only the `CompressionFlags` dword so UELib reads it) - Mirrored into `.agents/skills/` and `.claude/skills/`, which this repo keeps as real copies of `skills/` (`tests/test_um.py::test_skill_copies_match` enforces byte-for-byte parity, so new skills must land in all three trees) - `README.md` — two rows added to the skills table **Checklist** - [x] `uv run --with pytest pytest -q tests` passes (97 passed, 3 skipped) - [x] `um kb check --index` passes (182 notes checked) — no field notes in this PR, index untouched - [x] `um publish check .` — 544 files, **0 failures**, 2 warnings (both pre-existing `knowledge/` notes; the new files add none) - [x] no game files, extracted assets, decompiled code dumps or secrets - [x] nothing that cheats other players or bypasses anti-cheat / DRM / ownership checks — the `psp-ports` skill states the no-ROMs/no-assets publishing rules explicitly - [x] versions, verification and what was NOT verified are written down - [x] authored by (agent + model / human): OpenCode (deepseek-flash) with @Davidoff-byte **Not verified:** the PSP skill's toolchain steps (pspdev install, EBOOT.PBP packaging, PPSSPP/hardware runs) were written from research, not executed on a PSP in this PR. Rebased onto current `main` (`2c22014`); `README.md` merged cleanly with the upstream OpenCode-plugin changes (both kept). --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-15 20:54:51 +00:00