# Tekken 3 PC (Native Static Recompilation)

A native x86_64 PC port of **Tekken 3 (USA)** for Windows.

Runs as a standalone native Windows executable without any emulator or launcher wrapper, featuring direct loose PC asset loading, true 16:9 fullscreen presentation, 1080p supersampling, and locked 60 FPS.

---

## Features

- **100% Native x64 Execution:** Original PlayStation 1 MIPS R3000A CPU instructions statically recompiled to native x86_64 code via [PSXRecomp](https://github.com/mstan/psxrecomp).
- **Loose PC Asset Architecture:** Game data files (`TEKKEN3.XAS`, `TEKKEN3.BNS`, audio tracks) are extracted into loose PC data files under `game_data/` — no raw `.bin` or `.cue` CD images required.
- **Direct Startup (No Launcher):** Simply launch `Tekken3.exe` directly.
- **True 16:9 Fullscreen Presentation:** Clean fullscreen display filling 16:9 modern monitors with authentic character proportions (geometry hack disabled to eliminate model clipping or distortion).
- **Full HD 1080p Supersampling:** 3x internal resolution rendering via native OpenGL hardware acceleration.
- **Low-End CPU Optimized:** Optimized floating-point vertex pipeline (`geometry_correction = false`) for smooth 60 FPS on low-end dual-core / quad-core processors.
- **Instant Boot:** Skips console BIOS intro animations and jumps straight to the game.
- **CD-DA Streaming Audio:** Full CD audio soundtrack support with CDDA playback loop protection.

---

## Quick Start

1. **Clone the repository:**
   ```bash
   git clone https://github.com/Muqaddas12/Tekken3-PC.git
   cd Tekken3-PC
   ```

2. **Extract Game Assets:**
   Place your legal *Tekken 3 (USA)* `.bin`/`.cue` dump nearby and run:
   ```bash
   python setup_game_data.py
   ```

3. **Play:**
   Double-click **`Tekken3.exe`** to start playing immediately.

---

## Configuration (`settings.toml`)

All settings can be customized with Notepad in `settings.toml`:

```toml
[video]
# Resolution scale:
#   1 = 1x Native PS1 (320x240)
#   2 = 2x HD (720p)
#   3 = 3x Full HD (1080p - Recommended)
#   4 = 4x 2K (1440p)
#   5 = 5x 4K (2160p)
supersampling = 3

# Screen Aspect Ratio:
aspect_ratio = "16:9"

# Fullscreen mode: 1 = Fullscreen, 0 = Windowed
fullscreen = 1

# VSync: "off" for lowest latency & locked 60 FPS
vsync = "off"

# Graphics Renderer: "opengl" or "vulkan"
renderer = "opengl"
```

---

## Controls

* **Default Keyboard Layout:**
  * **Arrow Keys / D-Pad:** Movement / Jumping / Crouching
  * **Square / Triangle / X / Circle:** Attacks
  * **Start:** Enter / Pause
* **Controllers:** Standard Xbox, PlayStation, and generic XInput/DirectInput gamepads are automatically detected when plugged in.

---

## Legal & Attribution

This repository does not distribute copyrighted commercial ROMs or game disc assets. Assets must be extracted from your legally owned copy of *Tekken 3 (USA)* using the provided setup script.

- **Original Game:** © 1998 BANDAI NAMCO Entertainment Inc.
- **Recompilation Framework:** [PSXRecomp](https://github.com/mstan/psxrecomp) by mstan
- **Engine Patches:** [Tekken3Recomp](https://github.com/fabioap-cpu/Tekken3Recomp) by fabioap-cpu