QuakeSpasmGui
Description:	ReAction GUI für QuakeSpasm
Download:	quakespasmgui.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size:	133kb
Version:	1.2
Date:	16 Sep 2026
Author:	Falke_34
Submitter:	Falke_34
Email:	falke 34/gmx de
Homepage:	http://falke34.bplaced.net
Requirements:	AmigaOS 4.1
Category:	game/fps
License:	Other
Distribute:	yes
Min OS Version:	4.1
FileID:	14080
Snapshots:
Comments:	0
Snapshots:	2
Videos:	0
Downloads:	10  (Current version)
	10  (Accumulated)
Votes:	0 (0/0)  (30 days/7 days)

Short:        ReAction settings GUI for the QuakeSpasm AmigaOS4 port
Uploader:     Falke_34
Author:       Falke_34
Type:         game/fps
Version:      1.0
Requires:     AmigaOS 4.1, QuakeSpasm
Architecture: ppc-amigaos >= 4.1.0
Distribution: Freeware

DESCRIPTION

QuakeSpasmGUI is a small, standalone ReAction settings editor for the
AmigaOS4 port of QuakeSpasm. Instead of hand-editing config.cfg or
remembering console commands, it gives you a normal Amiga GUI - with
tabs for Graphics, Audio, Controls, Gameplay and Launch - to change the
engine's settings and start the game.

It does not replace or modify the engine itself; it only edits
QuakeSpasm's own config.cfg and adds a couple of convenience features
around launching it.

FEATURES

- Five tabs, over 70 QuakeSpasm cvars in total:

  Graphics  - resolution, refresh rate, fullscreen/"fake" fullscreen/
              borderless, VSync, texture filter, render scale, FSAA,
              anisotropic filtering, contrast/gamma, flashblend, blob
              shadows, full-bright colours, overbright lighting (world
              + models), triplebuffer, max FPS, far clip plane, the
              gl_zfix texture-flicker workaround.

  Audio     - sound/music volume, filter quality, external music
              (ogg/mp3 tracks), mix-ahead buffer.

  Controls  - mouse sensitivity/pitch/invert, freelook/lookspring/
              lookstrafe, run mode (off/vanilla/QuakeSpasm-style),
              gamepad enable/invert/swap, joystick sensitivity,
              deadzones (look/move/trigger), response curve
              (exponent), outer thresholds, fine-grained m_forward/
              m_side/m_yaw, pitch clamping, weapon FOV scale.

  Gameplay  - crosshair, third-person camera, FOV adaption, weapon
              bob, console/menu/statusbar/crosshair scale and alpha,
              water/lava/slime/teleport alpha, dynamic lights, R_NoVis,
              classic sine water, particle style, view-model-in-Quake
              mode, alternate noclip, demo autostart, external
              entity/vis files.

- All settings are read from and written back to QuakeSpasm's own
  id1/config.cfg. Only the cvars this GUI knows about are touched -
  key bindings, aliases, and any other lines in config.cfg are left
  completely untouched.

- A "Launch" tab with QuakeSpasm-specific command-line switches
  (-novbo, -nomtex, -condebug, -fitz), an optional mod folder/basedir
  override, and a free-form field for any other command-line
  arguments - plus "Save & Launch" and "Launch Only" buttons to start
  QuakeSpasm directly from the GUI.

INSTALLATION

1. Copy QuakeSpasmGUI into the SAME drawer as your QuakeSpasm
   executable (the one containing "QuakeSpasm", "quakespasm.pak" and
   the "id1" drawer). QuakeSpasmGUI locates both config.cfg and the
   QuakeSpasm executable relative to its own program directory, so it
   will not work if placed anywhere else.
2. Double-click QuakeSpasmGUI, or start it from Shell.
3. Change whatever you like across the five tabs, then click "Save",
   or "Save & Launch" on the Launch tab to save and start QuakeSpasm
   in one step.

REQUIREMENTS

- AmigaOS 4.1
- The QuakeSpasm AmigaOS4 port, installed in the same drawer (see
  os4depot: game/fps/quakespasm.lha).

CONFIGURATION FILES

- PROGDIR:id1/config.cfg   - QuakeSpasm's own settings file. Only the
                              cvars listed above are managed; if the
                              file doesn't exist yet, it is created
                              with sensible defaults on first Save.
- PROGDIR:QuakeSpasmGUI.prefs - GUI-only launch switches (-novbo,
                              -nomtex, -condebug, -fitz, mod folder,
                              basedir, extra arguments). These are
                              pure command-line switches, not Quake
                              cvars, so they are kept separately from
                              config.cfg.

CHANGELOG

1.2 (15.09.2026)
- Fixed a crash on exit caused by the tab content area being freed
  twice.
- No more Workbench/Shell console window popping up on startup, or
  when launching QuakeSpasm from the GUI.
- Added mouseover help bubbles explaining every setting.

1.0 (14.09.2026)
- Initial release.
- Fixed a bug where the previous tab's content stayed visible instead
  of being fully replaced on tab switch.
- Fixed distortion when resizing the window.
- Removed the "seta" prefix: QuakeSpasm does not know this cvar
  prefix, so saved settings were never applied - now plain
  "name value" format is written.
- Fixed PROGDIR: resolution at launch: it was not visible to the
  child process - now a resolved absolute path is passed instead.
- Split joystick/gamepad deadzones into separate look/move/trigger
  settings.
- Added the "-fitz" switch (disables QuakeSpasm-specific changes) as
  a launch option.

KNOWN ISSUES

- This is an initial release; if a cvar you rely on isn't covered yet,
  it is left completely alone in config.cfg (nothing is deleted or
  overwritten) - please report it so it can be added.

CREDITS / THANKS

- The QuakeSpasm team, for the engine and its documented cvars.
- Hyperion Entertainment, for the ReAction GUI toolkit and AmigaOS4 SDK.

CONTACT

Please report bugs or feedback via the os4depot.net comments, or the
AmigaOS4 community forums (thread by Falke_34).

SOURCE / LICENSE

QuakeSpasmGUI is original AmigaOS4/ReAction code and is not part of,
nor derived from, the QuakeSpasm engine itself - it only reads and
writes QuakeSpasm's plain-text config.cfg. Provided as freeware, use
at your own risk. Source available on request from the author.