A Path 1 game engine for the Sony® PlayStation 2 — Emotion Engine, VU1, DMA/VIF.

_{Boot → world · loop from retail capture (docs/media/loop-boot-to-world.gif)}

Overview

The EE issues DMA/VIF work; VU1 runs shader.vsm (transform, GIF packing, XGKICK to the GS). Offline tools hrc2ps2.py and obj2ps2.py emit mesh data for the reference floor.elf.

Engineering record and reproducibility baseline — not a general-purpose game template.

Build

git clone https://github.com/94BILLY/PANTHEON.git
cd PANTHEON
make -f Makefile.world

Output: floor.elf. Run in PCSX2 or on hardware. Toolchain and profiles: GETTING_STARTED.md.

Phase 1 baseline

• Boot title, timecycle skydome, walkable floor, third-person orbit camera
• Default: hybrid profile (CPU GIF floor + Path 1 skydome; avoids coplanar Z-fight)
• Strict Path 1: BETA_RELEASE.md

Narrative: FLIGHT_LOG.md

Core files

Media and site

Logo source and generator: docs/pantheon-oculus-straight-on-zenith.png · tools/generate_pantheon_zenith_logos.py · docs/LOGO.md

Gallery (Retail PS2): docs/media/VIEW_PANTHEON_MEDIA.html — loops and stills under docs/media/.

Scope

floor.elf is a fixed whitebox (boot, sky, ground plane, orbit camera, DualShock). Flags and defaults: BETA_RELEASE.md · BASELINE_ACCEPTANCE.md

Audience

Readers comfortable with PS2SDK, EE/VIF/VU1, and the GS. Start with pantheon_path1_contract.h and shader.vsm.

Documentation

Roadmap

• Phase 2 — Texturing (STQ, sampling in VU1)
• Phase 3 — Scale (chunking within VU1 data limits)
• Phase 4 — Atmosphere (timecycle, sky)

Repository policy

Public technical record. No LICENSE file; all rights reserved. Issues, pull requests, and unsolicited contributions are not accepted. Redistribution requires written permission.

github.com/94BILLY/PANTHEON
94BILLY · 94billy.com

_{© 2026 94BILLY · All rights reserved}

Bare-metal Path 1 PlayStation 2 engine. VU1 microcode. Softimage 3D pipeline. 60 FPS target.