Skip to content

themuffinator/FnQ3

Repository files navigation

FnQ3

Fappin' and Fraggin'

Latest Release Getting Started Documentation License

Compatibility target: Retail Quake III Arena 1.32 · Base version: 0.1.0 · Current build: 0.1.0

1. Introduction

FnQ3 is a modernized Quake III Arena source port for players who want the original game to feel at home on current hardware without losing what made it special in the first place.

What sets it apart is the balance: FnQ3 keeps retail compatibility, demos, and classic content behavior front and center, while adding cleaner presentation, better platform support, a stronger day-to-day user experience, and carefully chosen modern features that still respect the base game.

2. Features

Play the original game with a cleaner modern fit

  • Keeps retail Quake III Arena compatibility as the priority, including classic game data, demo playback, and mod expectations.
  • Ships with modern platform support built around SDL3 for video, audio, and input.
  • Uses a modern OpenAL-based audio path by default, with spatial sound improvements and a safe fallback to the classic mixer when needed.

Sharper presentation without changing the identity of Quake III

  • Flexible display options with renderer choice, fullscreen and windowed play, render scaling, HDR, anti-aliasing, and bloom tuning. See the Display Guide.
  • Optional visual polish such as cel shading, player rim lighting, and stencil-style highlights. See the Visuals Guide.
  • Better widescreen handling for HUDs, menus, UI previews, and cinematics. See the Aspect Correction Guide.

Better everyday usability

  • An upgraded console with smoother scrolling, scaling options, mouse support, text selection, drag and drop, and live completion help. See the Console Guide.
  • Expanded screenshot tools with cleaner naming, optional metadata sidecars, watermark support, and cube-map capture. See the Screenshot Guide.
  • Quality-of-life touches like live rainbow text preview and more flexible player-facing configuration.

Wider content compatibility

  • Supports older Quake 3 IHV / q3test maps and legacy .dm3 demos alongside standard retail content.
  • Includes practical compatibility for selected Quake Live assets such as IBSP v47 maps, encrypted beta .pk3 archives, and related material behavior.
  • Reads Quake II .pak archives and .wal textures for broader content experimentation.

3. Getting Started

  1. Install Quake III Arena and make sure your original baseq3 game data is present.
  2. Download the latest FnQuake3 build from the latest release page.
  3. Extract the release archive into your Quake III Arena folder so the FnQuake3 executables sit next to your existing game files.
  4. Start the FnQuake3 executable for your platform.
  5. If you want to tune visuals, audio, screenshots, or the console, use the guides in the Documentation section below.

If you want to compile FnQuake3 yourself instead, start with the Build Guide.

4. Documentation

Player guides

  • Display Guide for renderer choice, video modes, render scaling, HDR, anti-aliasing, and bloom.
  • Visuals Guide for player highlighting and other presentation controls.
  • Aspect Correction Guide for HUD, menu, and cinematic layout options.
  • Audio Guide for backend selection, devices, HRTF, fallback behavior, and troubleshooting.
  • Console Guide for console layout, scaling, completion, and interaction.
  • Screenshot Guide for capture commands, naming, metadata sidecars, watermarks, and cube-map export.
  • Changelog for release-facing change history.

Technical and build docs

5. Credits

FnQuake3 follows a clear upstream lineage from the Quake III Arena SDK, through ioquake3, to Quake3e, and then onward through the project-specific work in this repository.

Additional compatibility and feature work draws from projects and references such as CNQ3, Spearmint, WolfcamQL, Luigi Auriemma's qldec, and DarkMatter-Q2.

See CREDITS.md for the fuller credits list and project acknowledgements.