Q2PRO-X 1.2

Q2PRO-X 1.2: cvars, конфиги и Cvar Browser

Cvars, конфиги и встроенный справочник переменных

Русское издание

28 апреля 2026

q2pro-x.com

Оглавление

• 1. Что такое cvar
• 2. Три основных scope Q2PRO-X
• Global
• Mod-local
• Demo visual
• 3. Почему релиз не поставляет q2pro-x.cfg
• 4. Миграция схемы 1.2
• 5. Команды сохранения и сброса
• 6. Почему не стоит вручную чистить cfg без причины
• 7. Что умеет Cvar Browser
• 8. Favorites
• 9. Commands tab
• 10. Поиск
• 11. Язык и шрифты
• 12. Как понять, где сохранится значение
• 13. Мини-рецепты
• Сохранить всё перед выходом
• Сбросить только demo visuals
• Найти все demo cvar
• Проверить, почему значение не сохраняется

Q2PRO-X 1.2: cvars, конфиги и Cvar Browser

Этот документ объясняет, как в Q2PRO-X 1.2 устроены переменные, scopes,

сохранение настроек и встроенный cvar browser.

1. Что такое cvar

cvar - console variable. Это именованная переменная движка, которую можно:

• читать через консоль;
• менять через консоль;
• менять через меню;
• сохранять в cfg;
• использовать как состояние для UI и runtime-логики.

Примеры:

• sensitivity;
• vid_driver;
• cl_vis_enable;
• vc_enable;
• cl_demo_analytics_mode.

В 1.2 большая часть пользовательских Q2PRO-X cvar имеет понятный scope,

чтобы настройки сохранялись в правильное место.

2. Три основных scope Q2PRO-X

Global

Global-настройки пишутся в:

baseq2/q2pro-x/q2pro-x.cfg

Это вещи, которые обычно одинаковы везде:

• меню и UI;
• язык / типографика;
• мышь и zoom;
• видео backend;
• voice;
• server browser;
• demo browser/player общие настройки;
• cvar browser;
• сетевые инструменты.

Mod-local

Mod-local настройки пишутся в:

<game>/q2pro-x/q2pro-x.cfg

Это вещи, которые могут зависеть от мода:

• visibility highlights;
• визуальные эффекты;
• item/weapon/player highlight colors;
• часть render-профиля;
• mod-local binds.

Demo visual

Во время просмотра .dm2 / .mvd2 mod-local визуальные настройки могут

писаться не в папку мода, а в единый профиль:

baseq2/q2pro-x/demo_visual/q2pro-x.demo.cfg

Он нужен, чтобы демки из разных модов выглядели одинаково.

3. Почему релиз не поставляет q2pro-x.cfg

Релизный пакет 1.2 не кладёт пользовательский q2pro-x.cfg в baseq2.

Это сделано намеренно:

• не перетирать существующий конфиг пользователя;
• не привозить чужие local/demo состояния;
• не смешивать release runtime с personal profile;
• позволить движку создать чистый cfg на первом запуске.

Если cfg отсутствует, Q2PRO-X стартует с compiled defaults и создаёт свои

файлы при сохранении настроек.

4. Миграция схемы 1.2

В 1.2 добавлен internal marker:

cl_q2prox_cfg_version

Если маркер отсутствует или старее 1.2, движок применяет только безопасные

рекомендованные настройки интерфейса, например:

• guided menu as default;
• autosave Q2PRO-X config;
• современный autoscale меню.

После этого в global cfg пишется:

set cl_q2prox_cfg_version "1.2"

На следующем запуске эта миграция не повторяется.

Важно: это не defaults all. Пользовательская чувствительность, звук, voice,

мышь, zoom и другие настройки не должны сбрасываться полностью.

5. Команды сохранения и сброса

Основные команды:

• q2prox_cfg_save - сохранить global + local;
• q2prox_cfg_save_global - сохранить global profile;
• q2prox_cfg_save_local - сохранить mod-local profile, а во время demo

playback - demo-visual profile;

• q2prox_cfg_save_demo_visual - явно сохранить demo-visual profile;
• q2prox_cfg_defaults - сбросить все Q2PRO-X настройки;
• q2prox_cfg_defaults_global - сбросить только global scope;
• q2prox_cfg_defaults_local - сбросить local scope, а во время demo

playback - только demo visual cvar, binds сохраняются;

• q2prox_cfg_defaults_demo_visual - сбросить только demo-visual cvar.

Autosave управляется:

• cl_q2prox_cfg_autosave.

По умолчанию в 1.2 autosave включён.

6. Почему не стоит вручную чистить cfg без причины

Q2PRO-X 1.2 уже умеет не перезаписывать чужие значения полным reset-ом при

обычном старте. Если что-то выглядит странно, лучше сначала:

1. открыть соответствующую страницу меню;
2. проверить значение в cvar browser;
3. использовать scope-specific defaults, например

q2prox_cfg_defaults_demo_visual, а не удалять весь baseq2.

Полное удаление cfg полезно только когда вы действительно хотите начать с

чистого профиля.

7. Что умеет Cvar Browser

Cvar Browser - это встроенный справочник и редактор переменных.

Путь:

• Options -> Cvar Browser;
• или bind на cvar_browser_toggle;
• или console command cvar_help.

Основные возможности:

• вкладки: All, Favorites, Demo, Visual, Audio, Input, Network, Gameplay,

HUD/UI, Server, System;

• commands tab;
• поиск по имени, описанию и values;
• RU/EN отображение в зависимости от общего режима русской локализации;
• value column с текущим live значением;
• detail pane с описанием и допустимыми значениями;
• mouse selection и copy;
• Ctrl+A, Backspace/Delete clear;
• favorites state;
• resize / drag / fullscreen;
• remember last tab.

8. Favorites

Favorites - это локальный список часто используемых cvar.

Состояние хранится отдельно:

baseq2/q2pro-x/cvar_browser_state.txt

Полезно добавить туда:

• vid_driver;
• vid_resolution;
• sensitivity;
• cl_mouse_behavior_mode;
• cl_zoom_fov;
• cl_vis_enable;
• cl_demo_analytics_mode;
• vc_enable;
• cl_laghax.

9. Commands tab

Commands tab - это способ быстро найти и выполнить связанные команды:

• открыть menu page;
• выполнить action;
• открыть overlay;
• запустить helper-команду;
• перейти в console command with prefilled text.

Когда команда требует консольного ввода, browser открывает консоль поверх

себя и затем может вернуться в прежнее состояние.

10. Поиск

Поиск работает не только по имени cvar. Он также ищет по описаниям,

категориям и command metadata. В русской локализации поддерживается

кириллический ввод.

Практические примеры:

• demo - найти demo browser/player/analytics cvar;
• voice или голос - voice chat;
• mouse, zoom, мышь - управление;
• highlight, подсвет - visibility highlights;
• порт, clientport, xq3a - advanced network.

11. Язык и шрифты

Cvar Browser следует общему режиму русской локализации, а не отдельному

старому cl_cvar_browser_lang. Старый cvar сохранён для совместимости, но

его значение больше не является главным переключателем языка.

Связанные UI cvar:

• cl_browser_font_mode - типографика browser/UI chrome;
• cl_cvar_browser_alpha;
• cl_cvar_browser_scale;
• cl_cvar_browser_remember_tab;
• cl_cvar_browser_last_tab.

12. Как понять, где сохранится значение

Простое правило:

• мышь, звук, voice, сеть, browser UI - global;
• визуал мода, highlights, render look - mod-local;
• те же визуальные настройки во время demo playback - demo visual.

Если сомневаетесь, откройте cvar browser и прочитайте описание. Для новых

Q2PRO-X cvar в 1.2 metadata обычно прямо указывает назначение и смысл.

13. Мини-рецепты

Сохранить всё перед выходом

В консоли:

q2prox_cfg_save

Сбросить только demo visuals

В консоли:

q2prox_cfg_defaults_demo_visual

Затем при необходимости:

q2prox_cfg_save_demo_visual

Найти все demo cvar

Откройте cvar browser и перейдите на вкладку Demo, либо введите demo в

поиск.

Проверить, почему значение не сохраняется

1. Убедитесь, что cl_q2prox_cfg_autosave 1.
2. Проверьте, что меняете не debug/internal cvar.
3. Проверьте scope: global, local или demo visual.
4. Выполните явный q2prox_cfg_save* для нужного scope.