PANTHEON

A Path 1 game engine for the Sony® PlayStation 2.

v1.0.0-Beta

Pantheon is a bare-metal Path 1 PlayStation 2 engine built from scratch in C and VU1 vector assembly — utilizing the same pipeline architecture that powered the most technically demanding titles of the PlayStation 2 era. Engineered for zero abstraction, Pantheon eliminates every software layer between the developer and the silicon, delegating all geometric transformation and rasterization authority directly to Vector Unit 1.

Born on March 23rd, 2026, Pantheon enforces a strict manager–worker execution contract: the Emotion Engine sequences 128-bit DMA command chains while VU1 executes a bespoke VLIW microprogram — shader.vsm — that transforms vertices, builds GIF packets, and fires XGKICK directly to the Graphics Synthesizer. Geometry originates in Softimage 3D, the same production tool used by Kojima Productions and Rockstar North. The EE never touches a vertex.

1. Phase 1 Baseline — v1.0.0-Beta

  • 60 FPS Locked: Sustained asynchronous rendering in a pure Path 1 environment. Verified on PCSX2 2.7.x and real PS2 hardware.
  • VU1 Skydome: Hemisphere geometry authored in Softimage 3D, crunched through the offline pipeline, rendered entirely by VU1 microcode via XGKICK.
  • San Andreas-Style Timecycle: Four weather presets across eight time slots with per-channel linear RGB interpolation. 24-minute game day cycle.
  • GTA-Style Orbital Camera: Spherical camera telemetry with analog deadzone, pitch/yaw smoothing, and dynamic zoom.
  • Compile-Time Memory Contract: Shared EE/VU1 address layout enforced by pantheon_path1_contract.h. Misalignment is a build error, not a runtime failure.
  • Strategic VRAM Allocator: Linear word-bump allocator over 4 MB GS local memory. Zero-overlap layout audited via boot-time telemetry.
  • 94BILLY STUDIOS Boot Sequence: Luma ramp with bitmap title. Path 1 world deferred until reveal completes.

2. Field Demonstration: v1.0.0-Beta

Pantheon — Path 1 demo (retail PS2 capture)

Field demo — boot through Path 1 world.

3. The VU1 Microprogram

Pantheon’s shader.vsm is compiled with dvp-as and linked directly into the ELF binary as a standard object. The entry point PantheonShader resolves to a non-zero address at link time. The memory contract it executes against is defined in pantheon_path1_contract.h and verified at compile time:

PIPELINE: EE → VIF1 → VU1 → XGKICK → GS

MPG: Upload shader.vsm to VU1 instruction memory
UNPACK: Burst MVP matrix + vertex stream into VU1 data memory
MSCAL: Execute PantheonShader — transform, perspective divide, pack GIF tags
XGKICK: Fire packed GIF packet directly to Graphics Synthesizer
FLUSHE: Synchronize VU1 pipeline before next batch

4. Build Sequence

Requirements: ps2sdk · ee-gcc 15.2.0 · dvp-as · PCSX2 2.7.x · Python 3.x

Option A — Default Hybrid Build (Recommended):

  1. Clone: git clone https://github.com/94BILLY/PANTHEON.git
  2. Build: make -f Makefile.world
  3. Deploy: Open floor.elf in PCSX2 2.7.x or copy to PS2 hardware via OPL.

Option B — Strict Path 1 Validation:

  1. Build: make -f Makefile.world EE_CFLAGS='-DPANTHEON_RENDER_PROFILE=1'
  2. Result: VU1 renders all geometry. CPU GIF overlay disabled. Pure Path 1 pipeline validation.
View on GitHub

“Imagination unleashed.”

Engineered by 94BILLY