Q2PRO-X

Q2PRO-X 1.6 Beta 5 by ly — Q2PRO-X 1.6 Beta 5 Startup Intro Settings Guide

The complete guide in HTML. The original DOCX is available from its documentation card.

Q2PRO-X 1.6 Beta 5 by ly

Q2PRO-X 1.6 Beta 5 Startup Intro Settings Guide

Q2PRO-X document image

Project author: ly

The cold-start presentation, its music, lighting and personal facts

English edition • Q2PRO-X 1.6 Beta 5 by ly • 2026-10-10


Contents

The entries are links: click one to jump to that section.

Beta4: transition to demo playback

Music handoff on map entry

Automatic return to online play in beta 2

What the startup intro is

What the presentation is made of

1. Where the settings live

1.1. The Primary Settings Masters page

2. The intro switches

2.1. Startup intro

2.2. Persistent logo light

2.3. Persistent logo lightning

3. Intro music and the interface language

3.1. Where the track comes from

Replacing intro music

3.2. How the language is chosen

3.3. How the individual track is chosen

3.4. Volume and muting

4. Personal facts in the intro

4.1. What the layer is

4.2. Two mandatory conditions

4.3. Which data is counted

4.4. Which facts may appear

5. What happens after the intro

5.1. Online music

5.2. Main-menu light

5.3. Loading a map

6. Troubleshooting

6.1. The intro does not start

6.2. The intro runs but there is no sound

6.3. The screen stayed black or appeared stuck

6.4. Personal facts never appear

6.5. Diagnostics

7. Quick reference


Beta4: transition to demo playback

Launching a recording from the browser fades intro music as normal map startup does. Loading the demo's separate AVFX/music profile no longer cancels the transition; its music autostart waits for fade completion.


Music handoff on map entry

The intro yields through its normal fade. If player-state ambient is enabled for that game mode, it follows the intro; the loading-time volume spike and click are fixed. Explicit music selection retains priority. You can replace the intro PAK: the engine discovers available FLAC files for the selected language and reads the chosen track’s actual duration.



Automatic return to online play in beta 2

When optional automatic connection is enabled and the preceding session was remote online play, startup targets the last stored server and skips the intro/main menu. It is disabled by default. Explicit startup commands take priority; single-player, locally hosted play and demos retain normal startup. Settings are in the online recent-server section.


What the startup intro is

The startup intro is a short Q2PRO-X presentation that plays once when the client is launched cold into the menu. While it runs, the top-level Guided menu in its modern visual style stays on screen and stays fully usable: the Q2PRO-X logo carries its own light, electrical discharges travel around it, and personal facts from your own match statistics can appear beside the menu.

The intro is a startup event, not ordinary game music. It never loops, never plays a second time in the same process, and never delays a map load, a server connection or quitting the game.

The one thing worth knowing. The intro is on by default, entirely optional, and switched off with a single toggle. None of its elements affect gameplay, ping or the score in a match.

What the presentation is made of

A music track. A FLAC track from the factory or user-replaced intro PAK.
Logo light. A smooth brightness and bloom pulse on the logo, a downward light field, and matching menu shadows.
Logo lightning. Animated electrical tracers and branching discharges around the wordmark.
Personal facts. An optional layer: a short sequence of moments from your own match statistics, one fact at a time.
Sound controls. Small round buttons beside the menu: mute the intro sound, and end the intro smoothly.



1. Where the settings live

Every intro switch is collected on one compact page, Primary Settings Masters. The intro toggle itself is repeated on the configuration page, because that is where people look for launch behaviour.

What you are settingMenu path
Intro, logo light, lightning, statistics in the introMain menu → Primary Settings Masters
Startup intro (the same toggle)Main menu → Options → Config & Files
Which personal facts the intro may showMain menu → Primary Settings Masters → Intro Statistics Content
Online-music autoplay after the introMain menu → Online Music (PROMODJ)

1.1. The Primary Settings Masters page

The rows below are the real rows of that page exactly as the built client presents them.

Primary Settings Masters

TypeSectionRowVariable or targetWhat it does
SectionStartup & Main MenuStartup & Main Menu
ToggleStartup & Main MenuMenu on startupui_openDefault ON. Open the existing Q2PRO-X main menu on an ordinary cold launch. Direct map/server/demo starts are unchanged.
ToggleStartup & Main MenuStartup introcl_q2prox_startup_introDefault ON. Play the separate Q2PRO-X intro only on a cold menu/console launch; any map load stops it.
ToggleStartup & Main MenuAutomatic game statisticscl_game_stats_autoDefault OFF. Refresh your personal game statistics automatically on a plain cold start. Nothing is scanned or parsed in the background while this is off. Applies immediately.
ToggleStartup & Main MenuStatistics in introcl_game_stats_introDefault ON, and inert unless both automatic game statistics and the startup intro are active. During the intro it shows a short sequence of personal moments beside the menu — one fact at a time, appearing and dissolving. With no qualifying match nothing is drawn at all. Applies immediately.
NavigationStartup & Main MenuIntro statistics content...q2prox_game_statistics_introChoose every type of personal fact that may appear in the startup intro. All types are enabled by default.
ToggleStartup & Main MenuPersistent logo lightcl_q2prox_menu_logo_lightDefault OFF. Keep the smooth Q2PRO-X logo brightness, bloom and downward menu spotlights running on the top-level Guided menu while the modern visual style is active after Intro. Independent of Startup intro; no fireworks or travelling objects. Applies immediately.
ToggleStartup & Main MenuPersistent logo lightningcl_q2prox_menu_logo_lightningDefault OFF. Keep the animated electrical discharges around the Q2PRO-X logo running on the top-level Guided menu while the modern visual style is active after Intro. Independent of the persistent logo-light master. Applies immediately.
SectionVisual SystemsVisual Systems
ListVisual SystemsAVFX globallycl_avfx_global_disableGlobal AVFX override shared by every mod. ON preserves and uses each mod's own AVFX settings. OFF suppresses AVFX globally without erasing them. Applies immediately. [On / Off]
ToggleVisual SystemsCurrent-mod AVFXcl_avfxMaster switch for the active mod's AVFX atmospheric layer and its dependent effects. Applies immediately.
ToggleVisual SystemsVisual highlightscl_vis_enableMaster switch for item, weapon and player visibility highlighting. Applies immediately.
ToggleVisual SystemsParticlescl_particlesMaster switch for all classic particle effects. Applies immediately.
SectionRenderer EffectsRenderer Effects
ListRenderer EffectsDynamic lightinggl_dynamicMaster mode for dynamic lightmap lighting. Applies immediately. [no / yes / only switchable]
ListRenderer EffectsBloomgl_bloomBloom master and blur-pass count. Off disables bloom; 1..8 select its quality/strength path. Applies immediately. [off / 1 / 2 / 3 / 4 / 5 / 6 / 7 / 8]
ToggleRenderer EffectsPost-processgl_postfxMaster switch for the selected Pixel/CRT/Film/VHS/Noir/Sepia post-process. Applies immediately.
SectionOnline MusicOnline Music
ToggleOnline MusicOnline musiccl_music_online_enableMaster switch for the online music player. Off means no network activity at all. Same setting as the Online Music page. Applies immediately.
SliderOnline MusicVolumecl_music_online_volumeOnline music volume. The global sound volume stays the master. Applies immediately.
ToggleOnline MusicAutoplaycl_music_online_autoplayStart a track by itself at launch. The startup intro always plays first; autoplay begins when it ends. Applies immediately.
ToggleOnline MusicPause in gamecl_music_online_autopause_gamePause the online music while you are in a map. Applies immediately.
ToggleOnline MusicResume after gamecl_music_online_resume_after_gameResume it when you come back to the menu, if it was paused automatically. Applies immediately.
SectionDiagnosticsDiagnostics
ToggleDiagnosticsPerformance HUDcl_perf_hudDefault OFF. Live performance and budget HUD: occupancy bars plus measured CPU/GPU cost. Informative only; with it off nothing is measured, queried, counted or drawn. Applies immediately.



2. The intro switches

2.1. Startup intro

VariableAccepted valuesDescription
cl_q2prox_startup_intro0=no startup intro / 1=one-shot intro on eligible cold launch (default)Permit the separate Q2PRO-X FLAC intro to play once on an eligible cold idle process launch into the menu/console. Default ON. It is a startup event, not ordinary game music: ogg_enable and ogg_volume do not gate or attenuate it; the normal master sound/backend gain still applies. Any explicit direct map/server/demo/cinematic startup action suppresses decoder work before playback. Beginning any map load stops and consumes an active intro for the rest of the process. Turning this OFF while it plays stops it immediately; turning it ON arms only the next eligible full launch. Never loops.

What matters in practice:

The intro plays only on a cold launch into the menu or console. If you started the game straight into a map, a server, a demo or a cinematic, the presentation never even begins decoding.
Beginning any map load ends the intro smoothly and prevents it from starting again until the client is restarted.
Game-music settings do not reach it: ogg_enable and ogg_volume neither gate nor attenuate it. The overall sound master and the gain of the selected sound backend still apply as usual.
Turning the switch off while the intro plays stops it immediately. Turning it on only arms the next eligible launch.

2.2. Persistent logo light

VariableAccepted valuesDescription
cl_q2prox_menu_logo_light0=ordinary static menu logo (default) / 1=persistent animated logo light and spotlightsPersistent Q2PRO-X logo-light master for the top-level Guided menu in its modern visual style. Default OFF. When enabled, the accepted smooth logo brightness/bloom pulse, downward light field and matching menu shadows continue after the one-shot startup Intro finishes; if no Intro runs, they begin whenever the exact top-level Guided menu with the modern visual style active is visible. This does not enable fireworks, ships, meteors, comets, music or lightning. Live; no restart required. Stored in the global Q2PRO-X config.

This switch is independent of the intro itself. It answers a different question: should the logo light keep running after the presentation whenever the top-level Guided menu is shown with its modern visual style?

2.3. Persistent logo lightning

VariableAccepted valuesDescription
cl_q2prox_menu_logo_lightning0=no persistent logo lightning (default) / 1=persistent animated electrical dischargesPersistent Q2PRO-X logo-lightning master for the top-level Guided menu in its modern visual style. Default OFF. When enabled, the accepted animated electrical tracers and branching discharges around the wordmark continue after the startup Intro; if no Intro runs, they begin whenever the exact top-level Guided menu with the modern visual style active is visible. Independent of cl_q2prox_menu_logo_light and does not enable any other Intro scene element or audio. Live; no restart required. Stored in the global Q2PRO-X config.

Lightning is independent too: you can enable it without the light, and the other way round.

What these two switches do not do. They do not enable fireworks, travelling objects, meteors, comets or music. They are only the light and the discharges around the logo.



3. Intro music and the interface language

3.1. Where the track comes from

Replacing intro music

The intro demonstrates Q2PRO-X features and supports your own music replacements. No EXE rebuild or compiled-manifest update is required.

1. Close the game and back up baseq2/q2pro-x/q2prox_startup_intro.pak.

2. Create a valid Quake II PAK with your FLAC files. Put Russian tracks directly

under music/q2prox_intro/ru/ and English tracks under music/q2prox_intro/en/. For example: music/q2prox_intro/en/my_song.flac.

3. Replace baseq2/q2pro-x/q2prox_startup_intro.pak with your archive.

4. Start the game normally into its main menu. The interface language selects

the language folder; one available track is chosen randomly.

FLAC filenames are yours to choose; retaining intro_01 through intro_13 is unnecessary. Keep one track or add a hundred: the playlist is discovered from the PAK at startup. A single available track is always selected. Intro timing and the finale use the chosen file's actual duration, including tracks longer than three minutes.

Removing the PAK, or providing no tracks for the selected language, leaves the visual intro without its music. Ordinary menu sounds still work. Use actual FLAC files; renaming a different format does not convert it. This replacement uses the specified PAK, not an identically named loose file. The factory distribution contains 13 RU and 13 EN tracks; this is not an engine limit.

3.2. How the language is chosen

The language of the track follows the interface language — the same Interface Language setting in the main menu that switches the menu captions:

Interface Language valueWhich tracks are used
AutoRussian on a Russian Windows, English otherwise
OffEnglish
OnRussian

There is no separate "intro music language" setting and none is needed: one language setting governs both the captions and the presentation.

3.3. How the individual track is chosen

The track is chosen afresh on every eligible launch, at random and uniformly inside the selected language pool. There is no queue, no fixed order and no memory between launches: two consecutive launches can pick the same track.

The selection uses the operating system's own random-number source. If that source is unavailable for any reason, the client prints a warning to the console and continues with an internal fallback — the intro is not cancelled because of it.

3.4. Volume and muting

While the intro plays, small round buttons are visible beside the menu:

ButtonWhat it does
Intro soundMutes and unmutes the intro sound without ending it
End the introFades the intro out — with the same ramp a map load uses

Muting applies only to the current presentation; it is never inherited by whatever plays next.



4. Personal facts in the intro

4.1. What the layer is

VariableAccepted valuesDescription
cl_game_stats_intro0=off / 1=on (default)While the startup intro plays, show a short sequence of personal moments beside the main menu: ONE fact at a time, flying in, holding a single readable instant, then widening and dissolving. There is no panel, no frame and no card — typography and its own light are the whole scene, and an echo never covers the logo, the menu, the controls or the status line. On by default, but inert unless BOTH automatic statistics and the intro itself are active. Only unambiguous real matches of the current player with a proven positive contribution are counted here — never the overall session count, never another player's data. With no qualifying match, nothing is drawn at all rather than a zero-filled scene.

The personal-fact layer shows one fact at a time beside the menu. Each fact flies in, holds a single readable instant, then widens and dissolves. There is no panel, no frame and no card: typography and its own light are the whole scene. A fact never covers the logo, the menu, the controls or the status line.

4.2. Two mandatory conditions

The layer stays inert until both conditions are met:

1. automatic game statistics are enabled;

2. the intro itself is enabled.

If either condition fails, the layer draws nothing. If there is no qualifying match, it also draws nothing — not a zero-filled scene, but genuinely nothing.

4.3. Which data is counted

Only unambiguous real matches of the current player with a proven positive contribution are counted. The overall session counter is never used, and another player's data is never used. How the client separates a real match from an observed session and from ordinary spectating is explained in the game statistics guide.

4.4. Which facts may appear

Every fact type is switched separately. All of them are on by default.

Intro Statistics Content

TypeSectionRowVariable or targetWhat it does
SectionOpeningOpening
ToggleOpeningGreeting and periodcl_game_stats_intro_greetingShow the player greeting and the exact analysed date span. Applies immediately.
ToggleOpeningLast gamecl_game_stats_intro_last_gameShow the date of the newest demo included in the displayed match statistics. Applies immediately.
SectionResultsResults
ToggleResultsMatches playedcl_game_stats_intro_matchesApplies immediately.
ToggleResultsWins, losses and drawscl_game_stats_intro_resultsApplies immediately.
ToggleResultsFrags and deathscl_game_stats_intro_combatApplies immediately.
ToggleResultsFavorite kill weaponcl_game_stats_intro_kill_weaponApplies immediately.
ToggleResultsWeapon that killed youcl_game_stats_intro_death_weaponApplies immediately.
ToggleResultsStrategic item pickupscl_game_stats_intro_itemsShow every strategic item found in the accepted matches as its own cinematic line on every intro; no rotation between launches. Applies immediately.
SectionPreferencesPreferences
TogglePreferencesFavorite mapcl_game_stats_intro_mapApplies immediately.
TogglePreferencesFavorite modcl_game_stats_intro_modApplies immediately.
TogglePreferencesFrequent opponentcl_game_stats_intro_opponentApplies immediately.
NavigationPreferencesBackpopmenu



5. What happens after the intro

5.1. Online music

If online-music autoplay is enabled, it does not compete with the presentation: the intro always plays first, and autoplay begins when the intro ends.

VariableAccepted valuesDescription
cl_music_online_autoplaydefault 0 / 0 or 1Auto-start playback when enabled. Mod-local.

5.2. Main-menu light

Once the intro has finished, the logo light and lightning continue exactly when the matching persistent masters are enabled. With both off, the main menu returns to its ordinary static logo.

The pulse phase does not reset or jump when the main menu hands off to the map-preparation screen: the preparation screen uses the same compositor and the same clock.

5.3. Loading a map

Beginning a map load ends the intro with a smooth fade rather than a hard cut. Music is never allowed to delay core work: the fade runs on its own and holds up neither the map load, nor connecting, nor quitting.



6. Troubleshooting

6.1. The intro does not start

Check in this order:

1. How you launched the game. Any direct map, server, demo or cinematic start from the command line or from a shortcut makes the launch ineligible, and the intro is deliberately skipped. Launch the client without such arguments.

2. The toggle. Startup intro must be set to Yes.

3. This is not the first launch in this process. The intro plays once per process. If you have already loaded a map, it will not appear again in this session — restart the client.

4. Sound works at all. If the audio device is unavailable, the presentation ends cleanly instead of hanging in silence.

6.2. The intro runs but there is no sound

Check the overall volume and the selected sound backend in the sound guide. The overall sound master and the backend gain do apply to the intro.
Game-music settings are not involved here: switching them off must not silence the presentation.
Check whether the track is muted by the Intro sound button beside the menu.
If the audio device changed during launch (headphones plugged in, for example), the client makes a bounded number of recovery attempts and only then ends the presentation.

6.3. The screen stayed black or appeared stuck

Logo light and lightning are drawn by a separate scene program. If that program could not be built for any reason, the menu remains fully usable and simply draws the ordinary static logo: the intro cannot block the interface.

If the black screen appears when you change the graphics backend, start with the video guide instead: changing the backend rebuilds the whole graphics subsystem on its own, and the intro is not involved.

6.4. Personal facts never appear

This is correct behaviour when:

automatic game statistics are off;
the intro itself is off;
the database still holds no qualifying personal match;
every fact type is switched off on the content page.

In none of these cases does the client show an empty frame or print zeroes — it simply draws nothing.

6.5. Diagnostics

The startup_intro_info command prints the current state of the presentation to the console: whether the launch qualified as a cold start, the value of the toggle, the selected track and language pool, the state of the PAK and directory validation, the state of the decoder and of the menu compositor, and the reason it ended if it already has.

The command changes nothing and requires no developer-only mode to be enabled.



7. Quick reference

QuestionShort answer
Turn the intro off permanentlyPrimary Settings Masters → Startup intro → No
End it right nowThe End the intro button beside the menu
Silence it without ending itThe Intro sound button beside the menu
Keep the logo light foreverPersistent logo light → Yes
Remove the personal factsStatistics in intro → No
Choose the track languageThe Interface Language setting in the main menu
Why it does not play when launching into a mapBy design: a direct start makes the launch ineligible