# ampedup-2001/ampedup architecture

> Architecture diagram of the GitHub repository ampedup-2001/ampedup, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ampedup-2001/ampedup
- Repository: https://github.com/ampedup-2001/ampedup

## Overview

AMPEDUP! is a Windows x64 static recompilation of Amped: Freestyle Snowboarding. The player supplies a supported disc image; setup extracts game data and compiles locally, then the host launches the recompiled game. At runtime, translated guest code relies on Xbox kernel services and the NV2A graphics emulation, with host input, presentation, settings, audio, and soundtrack support around it. The README documents capabilities beyond the sampled source; those branches are included with directory-level paths where implementation files were not sampled. Arrows are limited to relationships shown in excerpts or the README.

Main entry points: [`Amped-Host/src/main.c`](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/src/main.c) (Windows game host), [`Amped-Host/src/recomp_manual.c`](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/src/recomp_manual.c) (Recompiled guest), [`Amped-Host/packaging/windows/Bootstrap.cs`](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/packaging/windows/Bootstrap.cs) (Setup and compile), [`Amped-Host/toolkit/src/d3d/nv2a_pb_vulkan.c`](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/d3d/nv2a_pb_vulkan.c) (NV2A Vulkan renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launch["Launch and game"]
  node_installer["Setup and compile<br/>[Bootstrap.cs]"]
  node_disc_install["Disc extraction<br/>[disc_install.c]"]
  node_host["Windows game host<br/>[main.c]"]
  node_guest_code["Recompiled guest<br/>[recomp_manual.c]"]
end

subgraph group_runtime["Xbox runtime"]
  node_kernel["Xbox kernel services<br/>[kernel_bridge.c]"]
  node_memory["Guest memory layout"]
  node_env["Runtime configuration<br/>[recomp_env.h]"]
end

subgraph group_graphics["Graphics and display"]
  node_render["NV2A Vulkan renderer<br/>[nv2a_pb_vulkan.c]"]
  node_nv2a_common["NV2A shared state"]
  node_present["Frame presentation"]
  node_video["Video playback<br/>[video_player.c]"]
end

subgraph group_player["Player features"]
  node_input["Controller and keyboard"]
  node_overlay["Settings overlay<br/>[overlay_ui.cpp]"]
  node_settings["Game settings<br/>[xbox_settings.h]"]
end

subgraph group_media["Audio and media"]
  node_audio["Xbox audio runtime<br/>[apu_core.c]"]
  node_soundtrack_import["Soundtrack import"]
  node_soundtrack["Soundtrack library<br/>[xst_library.c]"]
end

node_player_actor(("Player"))
node_disc["Game disc image"]

node_player_actor -->|"installs"| node_installer
node_disc -->|"supplies image"| node_installer
node_installer -->|"extracts data"| node_disc_install
node_installer -->|"compiles locally"| node_host
node_player_actor -->|"starts game"| node_host
node_host -->|"initializes"| node_env
node_host -->|"runs entry point"| node_guest_code
node_guest_code -.->|"uses services"| node_kernel
node_kernel -->|"maps guest memory"| node_memory
node_host -->|"configures settings"| node_overlay
node_host -.->|"initializes host input"| node_input
node_overlay -->|"reads settings"| node_settings
node_guest_code -.->|"issues graphics work"| node_render
node_render -->|"uses shared state"| node_nv2a_common
node_render -.->|"presents frames"| node_present
node_host -->|"initializes player"| node_video
node_guest_code -.->|"produces game audio"| node_audio
node_player_actor -->|"imports tracks"| node_soundtrack_import
node_soundtrack_import -->|"adds genre"| node_soundtrack

click node_installer "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/packaging/windows/Bootstrap.cs"
click node_disc_install "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/install/disc_install.c"
click node_host "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/src/main.c"
click node_guest_code "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/src/recomp_manual.c"
click node_kernel "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/kernel/kernel_bridge.c"
click node_memory "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/kernel/xbox_memory_layout.h"
click node_env "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/platform/recomp_env.h"
click node_input "https://github.com/ampedup-2001/ampedup/tree/main/Amped-Host/toolkit/src/input"
click node_overlay "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/overlay/overlay_ui.cpp"
click node_settings "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/overlay/xbox_settings.h"
click node_render "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/d3d/nv2a_pb_vulkan.c"
click node_nv2a_common "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/kernel/nv2a_backend_common.h"
click node_present "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/video/fb_present_vulkan.c"
click node_video "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/video/video_player.c"
click node_audio "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/apu/apu_core.c"
click node_soundtrack_import "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/src/soundtrack_import.c"
click node_soundtrack "https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/soundtrack/xst_library.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_installer,node_disc_install,node_host,node_guest_code toneBlue
class node_kernel,node_memory,node_env toneAmber
class node_render,node_nv2a_common,node_present,node_video toneMint
class node_input,node_overlay,node_settings toneRose
class node_audio,node_soundtrack_import,node_soundtrack,node_player_actor,node_disc toneIndigo
```

## Components

### Launch and game

- [Setup and compile](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/packaging/windows/Bootstrap.cs): `Amped-Host/packaging/windows/Bootstrap.cs`
- [Disc extraction](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/install/disc_install.c): `Amped-Host/toolkit/src/install/disc_install.c`
- [Windows game host](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/src/main.c): `Amped-Host/src/main.c`
- [Recompiled guest](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/src/recomp_manual.c): `Amped-Host/src/recomp_manual.c`

### Xbox runtime

- [Xbox kernel services](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/kernel/kernel_bridge.c): `Amped-Host/toolkit/src/kernel/kernel_bridge.c`
- [Guest memory layout](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/kernel/xbox_memory_layout.h): `Amped-Host/toolkit/src/kernel/xbox_memory_layout.h`
- [Runtime configuration](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/platform/recomp_env.h): `Amped-Host/toolkit/src/platform/recomp_env.h`

### Graphics and display

- [NV2A Vulkan renderer](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/d3d/nv2a_pb_vulkan.c): `Amped-Host/toolkit/src/d3d/nv2a_pb_vulkan.c`
- [NV2A shared state](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/kernel/nv2a_backend_common.h): `Amped-Host/toolkit/src/kernel/nv2a_backend_common.h`
- [Frame presentation](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/video/fb_present_vulkan.c): `Amped-Host/toolkit/src/video/fb_present_vulkan.c`
- [Video playback](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/video/video_player.c): `Amped-Host/toolkit/src/video/video_player.c`

### Player features

- [Controller and keyboard](https://github.com/ampedup-2001/ampedup/tree/main/Amped-Host/toolkit/src/input): `Amped-Host/toolkit/src/input`
- [Settings overlay](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/overlay/overlay_ui.cpp): `Amped-Host/toolkit/src/overlay/overlay_ui.cpp`
- [Game settings](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/overlay/xbox_settings.h): `Amped-Host/toolkit/src/overlay/xbox_settings.h`

### Audio and media

- [Xbox audio runtime](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/apu/apu_core.c): `Amped-Host/toolkit/src/apu/apu_core.c`
- [Soundtrack import](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/src/soundtrack_import.c): `Amped-Host/src/soundtrack_import.c`
- [Soundtrack library](https://github.com/ampedup-2001/ampedup/blob/main/Amped-Host/toolkit/src/soundtrack/xst_library.c): `Amped-Host/toolkit/src/soundtrack/xst_library.c`

### Other components

- **Player**
- **Game disc image**

## Connections

- Player → Setup and compile: installs (evidence: `README.md`)
- Game disc image → Setup and compile: supplies image (evidence: `README.md`)
- Setup and compile → Disc extraction: extracts data (evidence: `README.md`)
- Setup and compile → Windows game host: compiles locally (evidence: `README.md`)
- Player → Windows game host: starts game (evidence: `README.md`)
- Windows game host → Runtime configuration: initializes (evidence: `Amped-Host/src/main.c`)
- Windows game host → Recompiled guest: runs entry point (evidence: `Amped-Host/src/main.c`)
- Recompiled guest → Xbox kernel services: uses services
- Xbox kernel services → Guest memory layout: maps guest memory (evidence: `Amped-Host/toolkit/src/kernel/kernel_bridge.c`)
- Windows game host → Settings overlay: configures settings (evidence: `Amped-Host/src/main.c`)
- Windows game host → Controller and keyboard: initializes host input
- Settings overlay → Game settings: reads settings
- Recompiled guest → NV2A Vulkan renderer: issues graphics work
- NV2A Vulkan renderer → NV2A shared state: uses shared state (evidence: `Amped-Host/toolkit/src/d3d/nv2a_pb_vulkan.c`)
- NV2A Vulkan renderer → Frame presentation: presents frames
- Windows game host → Video playback: initializes player (evidence: `Amped-Host/src/main.c`)
- Recompiled guest → Xbox audio runtime: produces game audio
- Player → Soundtrack import: imports tracks (evidence: `README.md`)
- Soundtrack import → Soundtrack library: adds genre (evidence: `Amped-Host/src/soundtrack_import.c`)
