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

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

Q2PRO-X 1.4

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

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

5 июля 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.4: cvars, конфиги и Cvar Browser

Примечание по версии 1.4: основной текст этого руководства сохраняет проверенную базу 1.2; новые возможности и изменения 1.4 описаны в разделе "Дополнение 1.4" ниже. Этот документ объясняет, как в Q2PRO-X 1.4 устроены переменные, 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.4 уже умеет не перезаписывать чужие значения полным reset-ом при

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

открыть соответствующую страницу меню;

проверить значение в cvar browser;

использовать scope-specific defaults, например

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

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

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

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