• Релиз 1.0: современный браузер cvar доведён до финального пользовательского уровня.
• RU/EN-переключение, поиск, copy, resize, scroll и отдельный browser-local scale.
• Настройки из шестерёнки: server browser, cvar browser, mod overlay и LAGHAX HUD.
• LAGHAX HUD: отдельная прозрачность и новый optional runtime-блок weapon predict.
• Оверлеи возвращают пользователя назад после закрытия страницы настроек.
• Релизный пакет 1.0 ship'ится как чистый Q2PRO-X layer, без generated-конфигов.

Обновления релиза 1.0 относительно beta 0.99

• Современный браузер cvar: качественный unified EN+RU font, copy, scroll, resize, separate alpha и отдельный scale для читабельности.
• Курсор мыши и draw-state в браузере cvar дополнительно стабилизированы: клики, resize и текст снова работают предсказуемо.
• Во всех новых оверлеях появились кнопки настройки; после выхода из меню пользователь возвращается в исходный оверлей.
• LAGHAX HUD получил отдельную прозрачность и новый диагностический runtime-блок weapon predict, выключенный по умолчанию.
• Финальный пакет 1.0 включает оба menu-файла, q2pro.modhelp и browser-local font atlas, но по-прежнему не включает generated q2pro-x.cfg.
• Главный брендовый пакет обновлён и приведён к единому визуальному стилю Q2PRO-X 1.0.
• Документация и release-слой синхронизированы с текущим состоянием клиента, без старых beta-хвостов в названиях и логотипах.

Обновления релиза 1.0

Современный браузер cvar

В Q2PRO-X 1.0 современный браузер cvar переведён из стадии feature-preview в полноценный пользовательский интерфейс. Он умеет менять размер мышью, работать в RU/EN-режимах, открывать детальные описания, копировать описание переменной в буфер обмена и сохранять собственные настройки прозрачности и масштаба текста.

Отдельный параметр browser scale не зависит от scr_scale. Это важно для игроков, которые хотят оставить привычный HUD, но при этом сделать справочник cvar крупнее и читабельнее.

Прозрачность браузера cvar теперь следует собственной настройке и не запутывает пользователя скрытой зависимостью от scr_alpha.

Настройки из оверлеев

Во всех новых оверлеях появилась маленькая шестерёнка. Она открывает соответствующую страницу настроек без ручного поиска нужного раздела меню.

После закрытия этого меню пользователь возвращается обратно в тот оверлей, из которого пришёл. Это особенно удобно для server browser, mod overlay и cvar browser, где важно быстро подправить параметры и сразу увидеть результат.

LAGHAX HUD и диагностика weapon predict

LAGHAX HUD получил собственную прозрачность и перестал зависеть от scr_alpha. Это делает поведение HUD понятнее и предсказуемее.

Дополнительно в 1.0 появился опциональный блок runtime-диагностики weapon predict. Он выключен по умолчанию и нужен тем, кто хочет видеть живое внутреннее состояние ghost/predict-слоя: pending ammo, switch state, suppression bookkeeping и другие runtime-поля.

Новая диагностика не меняет поведение оружия и не ускоряет стрельбу. Это только наглядное окно в уже существующую внутреннюю логику клиента.

Что важно знать о релизном пакете 1.0

Пакет 1.0 продолжает философию чистого additive-layer: он не должен затирать пользовательские config-файлы, q2pro.menu или чужие pak-файлы.

В релизном слое обязательны оба menu-файла Q2PRO-X, q2pro.modhelp и browser-local font atlas. Generated q2pro-x.cfg в пакет не входит и создаётся у пользователя самостоятельно.

Q2PRO-X 1.0

Руководство пользователя

Главный автор проекта, инициатор ключевых идей и основной тестировщик: ly

Тестирование: Quake II community

Документ актуализирован для релиза 1.0; новые разделы в конце документа описывают изменения относительно beta 0.99.

Оглавление

2. Из чего состояла предыдущая beta 0.97 4

2.1. Что изменилось в beta 0.97 (предыдущая волна) 4

3. Короткий практический старт 5

4. Сетевые функции: что дают и как использовать 5

4.1. R1Q2-like movement feel: что это даёт на практике 5

5. Видео и графика: что реально появилось нового 6

5.1. Как выставить 4:3 и 800x600 6

6. Звук: как включать и в чём разница между слоями 7

7. Подсветки: для чего они нужны на практике 7

8. Новый браузер серверов 7

9. Mod Command Overlay 7

13. Полный обзор меню Q2PRO-X 8

13.1. Q2PRO-X / Global settings 8

13.2. Q2PRO-X / Local mod settings 8

13.3. Q2PRO-X / Config 9

13.4. Q2PRO-X / Mod overlay 9

13.5. Q2PRO-X / Server browser 9

14. Откуда пришли ключевые функции 10

15. OLED protection и безопасный pillarbox для OLED 10

16. Что важно именно в beta 0.97 11

16.1. Weapon predict follow-up: hyperblaster, machinegun, chaingun 11

16.2. Laghax HUD: теперь видно, что реально включено 11

16.3. R1Q2-style step smoothing на лифтах 12

15. Обновления beta 0.98 относительно 0.97 12

15.1. Display & Capture: windowed mode 12

15.2. Автоуправление звуком при потере фокуса и в OLED idle 13

15.3. OLED Protection: что важно знать теперь 13

15.4. Предикт оружия: что поменялось для игрока 13

15.5. Laghax: низкопинговая server-to-client starvation 14

15.6. Modern Server Browser: Favorites без ручной правки 14

1. Что такое Q2PRO-X и почему появился этот клиент

Q2PRO-X — это развитие классического Q2PRO, в котором объединены идеи, тестирование и пользовательские сценарии ly. Главная цель проекта — не просто добавить ещё один набор cvar, а превратить клиент в удобный, современный и управляемый инструмент для игры, просмотра матчей и тонкой настройки Quake II.

Проект появился потому, что многие реальные задачи годами решались неудобно: одни вещи жили в старых форках, другие — в редких конфиг-скриптах, третьи — вообще во внешних pak-файлах. Q2PRO-X собирает эти направления в один клиентский слой, который можно тестировать и развивать системно.

• Идеи, пользовательские сценарии и основное тестирование проекта принадлежат ly.
• Серверная физика не переписывается ради эффекта — клиент старается улучшать именно user experience.
• Новые возможности добавлены в виде управляемых меню и cvar, а не как скрытые магические переключатели.

2. Из чего состояла предыдущая beta 0.97

Текущая beta-сборка сделана как чистый release-слой. В неё включены только наши бинарники, нужные runtime-библиотеки и папка baseq2/q2pro-x с данными Q2PRO-X.

Старые пользовательские паки, baseq2-конфиги и оригинальный q2pro.menu в beta-пакет не включаются, чтобы не ломать существующую установку тестировщика.

2.1. Что изменилось в beta 0.97 (предыдущая волна)

• Добавлен управляемый сценарий 4:3 pillarbox для borderless desktop fullscreen: теперь можно получить centred 800x600 или 1024x768 с чёрными боковыми полями прямо из меню, без ручного перебора vid_modelist.
• В Display & Capture появились отдельные picker-элементы resolution и refresh rate. Пользователь выбирает поддерживаемое монитором разрешение и частоту напрямую, а Q2PRO-X сам сопоставляет это с реальным fullscreen mode.
• Сохранённые resolution и refresh теперь применяются уже на первом запуске после загрузки q2pro-x.cfg: больше не нужен отдельный vid_restart только ради того, чтобы вернуть сохранённый режим.
• Исправлена обработка мыши по чёрным полям pillarbox-режима: клики и колесо мыши вне видимой 4:3-области больше не должны задевать крайние элементы меню, server browser или mod overlay.
• Версия beta-сборки повышена до 0.97 и включает в себя предыдущие исправления 0.95-a вместе с новой display/video-веткой.
• Доведена ветка weapon prediction polish: для RL/RG/SG/SSG/GL исправлен held-fire predict, для centered hand убран неверный muzzle origin, а локальная анимация view weapon больше не должна уезжать в неправильные кадры после отпускания огня или при смене оружия.
• Добавлена отдельная debug-команда cl_weapon_anim_debug. Она печатает переходы gunframe-анимации и помогает разбирать спорные кейсы weapon predict отдельно от общего cl_predict_debug.

3. Короткий практический старт

1. Положите beta-файлы поверх своей рабочей клиентской установки.
2. Не заменяйте собственные пак-файлы и не удаляйте свой контент.
3. Запустите Q2PRO-X.exe.
4. Откройте Options -> Q2PRO-X.
5. Проверьте Global settings, Local mod settings и Config.
6. Для первого знакомства начинайте с conservative-настроек и включайте более агрессивные функции по одной.

4. Сетевые функции: что дают и как использовать

Сетевой стек Q2PRO-X в первую очередь про ощущение игры: насколько плавно двигается клиент на линии, насколько быстро откликается оружие и насколько привычным кажется движение.

4.1. R1Q2-like movement feel: что это даёт на практике

В Q2PRO-X это отдельный режим ощущения движения, а не заявление про "физику R1Q2". Он нужен для тех игроков, которым классический Q2PRO кажется слишком жёстким или менее привычным на разгоне, старте прыжка и общей cadence-команд.

• movement feel = r1q2-like переводит клиент на classic monolithic phys_frame cadence. Проще говоря, именно этот режим выбирает старый feel формирования movement command, а не современный fixedmove-subdivision path.
• В этом режиме cl_fixedmove не ломается и не "выключается глобально", но его 10 ms subdivision path для movement feel больше не является определяющим: режим r1q2-like intentionally bypasses этот scheduler и использует свой applied timing path.
• client predict mode (modern / legacy) и step smoothing остаются отдельными ручками. То есть можно сочетать r1q2-like feel с modern predict backend или с legacy predict backend, а R1Q2-style step smoothing включать или не включать отдельно.

Искать эту настройку нужно в Q2PRO-X / Global settings / Movement & Player. Там же рядом лежит action movement feel info..., который показывает, какой applied path сейчас реально активен.

5. Видео и графика: что реально появилось нового

Здесь Q2PRO-X даёт не только красивые ручки, но и ощутимый практический выигрыш: корректный borderless fullscreen, нормальный Alt+Tab, штатный Alt+F4 и более современный рендер-сценарий через win32egl.

• desktop fullscreen — основной удобный режим для современных Windows-систем
• Alt+Tab работает корректно и без старого ощущения застревания клиента
• Alt+F4 закрывает игру штатно
• render scale позволяет получить более чистую картинку без смены размера окна
• visual fx дают живой postprocess-путь поверх старого рендера

5.1. Как выставить 4:3 и 800x600

Для beta 0.97 этот сценарий больше не требует ручного перебора vid_modelist в консоли. Всё нужное вынесено в Q2PRO-X / Global settings / Display & Capture.

• desktop fullscreen = yes + resolution = 800x600 или 1024x768 + fullscreen fit = aspect -> centered 4:3-картинка внутри нативного desktop-режима, с чётко нарисованными чёрными полосами по бокам. Это лучший вариант, если нужен старый 4:3-вид, но при этом важны быстрый Alt+Tab и нормальный borderless fullscreen.
• desktop fullscreen = no + resolution = 800x600 или 1024x768 -> настоящий fullscreen mode switch. Монитор и драйвер реально переходят в выбранное разрешение, а дальнейшее масштабирование зависит уже от настроек видеокарты и самого дисплея.
• resolution = desktop + desktop fullscreen = yes + fullscreen fit = fill -> обычный современный fullscreen без чёрных полос, когда игра просто занимает весь desktop-native экран.
• refresh rate имеет практический смысл в первую очередь тогда, когда выбран конкретный режим, а не desktop. Если точной частоты нет, клиент подбирает ближайший валидный fullscreen mode вместо того, чтобы оставлять пользователя в подвешенном состоянии.

Разница между 800x600 и 1024x768 простая: оба режима дают 4:3, но 1024x768 выглядит чище и резче, а 800x600 сильнее подчёркивает классический ретро-вид и обычно чуть легче для системы.

6. Звук: как включать и в чём разница между слоями

У звука в Q2PRO-X несколько уровней. Обычному пользователю важнее понять не все внутренние детали, а порядок включения: сначала выбрать sound profile и room acoustics, потом при желании попробовать binaural/3D, а уже потом лезть в отдельные wet/decay/resampler ручки.

• Sound & Acoustics — основной раздел для повседневной настройки.
• Binaural / 3D — отдельный слой для игры в наушниках.
• Sound Volumes — отдельная тонкая настройка громкостей оружия и категорий звуков.
• High-precision output и resamplers полезны тем, кто хочет выжать из аудиотракта максимум.

7. Подсветки: для чего они нужны на практике

Подсветки в Q2PRO-X сделаны вместо внешних pak-файлов и специальных модельных замен. Это важно и для удобства, и для контроля — все ручки теперь живут в клиенте и доступны через меню.

8. Новый браузер серверов

Modern server browser — это уже не старое меню со списком серверов, а отдельное рабочее окно. В нём можно искать, сортировать, фильтровать, просматривать players/rules и сразу подключаться.

• Поиск работает по нескольким полям сразу.
• Столбцы сортируются мышью.
• Есть details pane с несколькими вкладками.
• Legacy browser при этом никуда не делся — его можно оставить как привычный вариант.

9. Mod Command Overlay

Mod overlay особенно полезен на OpenTDM и OpenFFA. Он показывает команды по разделам, умеет работать с prompt-командами и подсказывает готовые spectator- и voting-действия без необходимости помнить их наизусть.

• Открывается по отдельной bind-команде.
• Есть обычные instant-команды и строки с дополнительным вводом.
• Можно оставить только spectator-секции, если вы стример или кастер.
• Для опасных команд предусмотрено подтверждение.

13. Полный обзор меню Q2PRO-X

Ниже собран практический обзор всех новых страниц меню. Этот раздел нужен именно для обычного пользователя: если вы открыли Q2PRO-X и хотите понять, где искать нужную функцию, начинайте отсюда.

13.1. Q2PRO-X / Global settings

13.2. Q2PRO-X / Local mod settings

13.3. Q2PRO-X / Config

В beta 0.97 этот раздел по-прежнему держит важный пользовательский переключатель Alt+F4: по умолчанию быстрый выход включён, но его можно отключить, если вы не хотите случайно закрывать игру.

Этот же раздел остаётся центральной точкой для работы с q2pro-x.cfg, autosave и возвратом к значениям по умолчанию.

Если вы тестируете один и тот же клиент в нескольких модах, именно этот раздел помогает понять, что сохранится везде, а что останется привязанным только к текущему gamedir.

13.4. Q2PRO-X / Mod overlay

Если вы стример или кастер, чаще всего будет достаточно включить только spectator-related секции и открыть overlay по отдельной клавише.

13.5. Q2PRO-X / Server browser

14. Откуда пришли ключевые функции

Q2PRO-X не скрывает происхождение удачных идей. Наоборот, проект фиксирует прародителей функций, чтобы было понятно, откуда берётся тот или иной feel или пользовательский сценарий.

15. OLED protection и безопасный pillarbox для OLED

Ветка 0.97 делает 4:3 pillarbox не только удобным, но и безопаснее для OLED-панелей. Все настройки находятся в Q2PRO-X / Global settings / Display & Capture / OLED protection....

• OLED protection — общий мастер-переключатель всей ветки защиты.
• bar protection — оживляет чёрные pillarbox-поля, чтобы они не оставались статичными часами.
• bar preset / bar color A / bar color B — задают тип анимации и два цвета, между которыми будут дышать боковые поля.
• bar start delay / bar active time / bar idle interval — задают, когда защита начинается и как долго работает.
• idle screen protection — затемняет уже весь экран при бездействии, а не только pillarbox-поля.
• idle delay / idle fade time / idle restore time — отвечают за задержку старта, скорость затемнения и скорость возврата после движения мыши или нажатия клавиши.
• interface alpha protect — мягко меняет прозрачность draw-HUD, laghax HUD и modern server browser, не переписывая ваши обычные alpha-cvar.
• OLED info... — печатает в консоль текущие состояния OLED-ветки, что удобно для тестов и отладки.

Важная практическая деталь: когда idle-защита реально затемнила экран, Q2PRO-X теперь прячет системный курсор, чтобы на тёмном изображении не висела одна яркая белая точка. Как только пользователь снова взаимодействует с клиентом, курсор и яркость возвращаются корректно.

Если вы играете в 4:3 через desktop fullscreen = yes + fullscreen fit = aspect, то modern server browser и laghax HUD можно вынести в свободные pillarbox-зоны. Это особенно удобно для OLED, потому что сам игровой кадр остаётся чистым, а служебные панели живут в боковых полях.

16. Что важно именно в beta 0.97

16.1. Weapon predict follow-up: hyperblaster, machinegun, chaingun

В 0.97 закрыт один из самых неприятных beta-багов по предикту оружия: у hyperblaster локальный и серверный поток болтов больше не должны рисоваться двумя параллельными струями. Внутренняя классификация стала умнее: Q2PRO-X теперь матчится не только по effect-битам, но и по типу projectile, недавней локальной очереди и стабильной последовательности handoff.

При этом для machinegun / chaingun / hyperblaster сохранено честное поведение по view-weapon animation: модель в руках остаётся server-driven для continuous-fire оружия. Это сделано специально, чтобы не рисовать неверные gunframe на wrap-переходах. Локальный импульс выстрела по звуку, muzzle, ammo и эффектам при этом остаётся быстрым.

Для разбора спорных кейсов есть cl_weapon_anim_debug: он печатает, какой gunframe пришёл от сервера и что реально отрендерено.

16.2. Laghax HUD: теперь видно, что реально включено

Laghax overlay в 0.97 можно использовать уже не только как индикатор smoothing-окна. Он умеет показывать, какие weapon predicts / player predict реально включены, а также какие физические режимы сейчас активны: movement feel, step smoothing, legacy predict и fixed move. Причём обновление live: открытый overlay сразу реагирует на изменения, сделанные в меню.

Для игроков с 4:3 pillarbox добавлена отдельная логика pillarbox workspace: HUD можно перетащить мышью в свободную боковую область и тем самым не перекрывать центральную картинку уровня.

16.3. R1Q2-style step smoothing на лифтах

Ещё один закрытый bugfix 0.97 касается cl_step_smoothing_mode = r1q2-1 / r1q2-2 / r1q2-3. Раньше на лифтах и вертикальных mover-платформах камера могла ощутимо дёргаться, потому что движение платформы ошибочно принималось за stair-step. Теперь этот ложный сценарий отфильтрован, а обычное сглаживание настоящих ступенек сохранено.

15. Обновления beta 0.98 относительно 0.97

Ниже собраны изменения, которые вошли именно в текущую beta 0.98 по сравнению с beta 0.97. Этот раздел нужно читать как краткую актуализацию документа: базовые возможности Q2PRO-X из предыдущей версии сохраняются, а здесь перечислены новые пользовательские сценарии и наиболее важные изменения поведения.

15.1. Display & Capture: windowed mode

Раньше в некоторых сценариях отключение desktop fullscreen и выбор `800x600` всё равно переводили игру в exclusive fullscreen, а не в обычное окно. В beta 0.98 это разведено явно.

Если вам нужен обычный оконный режим для параллельной работы, стриминга или тестов с несколькими экземплярами клиента, теперь он выбирается штатно через меню Q2PRO-X / Display & Capture.

15.2. Автоуправление звуком при потере фокуса и в OLED idle

В beta 0.98 появились две отдельные пользовательские опции для звука.

• mute when inactive — отключает звук игры, когда окно клиента теряет фокус, например после Alt+Tab.
• mute audio on idle protect — отключает звук, когда срабатывает OLED idle protection.

Во второй ветке поведение сделано мягче: затухание и восстановление звука привязаны к параметрам idle fade / restore, поэтому звук не обрывается грубым мгновенным mute, а следует за OLED idle-логикой более плавно.

15.3. OLED Protection: что важно знать теперь

OLED-защита в текущей beta распространяется не только на desktop fullscreen. Для тестировщика важно различать её подрежимы.

• bar protection работает только там, где чёрные поля принадлежат самому Q2PRO-X, то есть в app-owned pillarbox/scaled presentation path.
• idle full-screen dim и UI alpha protection работают и в windowed, и в exclusive fullscreen, и в desktop fullscreen.
• для OLED idle доступен режим более агрессивной защиты с удержанием тёмной фазы; Windows-only DPMS monitor off остаётся опциональным и явно помечен как opt-in.

15.4. Предикт оружия: что поменялось для игрока

В beta 0.98 в публичную сборку вошёл большой пакет доработок предикта оружия, который закрывает не один частный баг, а сразу несколько архитектурных проблем локального предсказания.

• при переключении оружия больше не должен появляться ложный предиктовый выстрел от старого оружия в момент, когда сервер ещё не подтвердил смену;
• для непрерывно стреляющего оружия (machinegun / chaingun / hyperblaster) анимация view-weapon теперь намеренно остаётся привязанной к серверной `ps->gunframe`, а локально предсказываются только безопасные части отклика: звук, вспышка, попадание, локальный расход патронов и траектория там, где она поддержана;
• HyperBlaster получил более правильную локальную трассу с сопоставлением серверного entity, остановкой при попадании и локальным эффектом удара, поэтому исчезли наиболее заметные проблемы вида `double stream` и `нет нормального попадания в стену`;
• rocket prediction в мультиплеере стала безопаснее: логика определения `свой / не свой` для server entity теперь строже отделяет локальную ракету от чужой и не должна подменять траектории других игроков.

Отдельно для диагностики добавлен `cl_weapon_anim_debug`: он помогает сравнивать server-frame и rendered-frame без перегрузки общего `cl_predict_debug`.

15.5. Laghax: низкопинговая server-to-client starvation

Adaptive `cl_laghax 2` получил внутреннюю доработку для случаев, когда пинг маленький, но сервер присылает состояние рвано и с заметным packet loss по направлению server → client.

С точки зрения игрока это не новый режим в меню. Важное изменение в том, что laghax теперь лучше понимает, что проблема вызвана не просто джиттером RTT, а starvation-поведением канала. За счёт этого adaptive window выбирается более честно именно в таких кейсах.

Пока отдельное полевое тестирование на плохом сервере отложено, но сама архитектурная доработка уже включена в beta 0.98.

15.6. Modern Server Browser: Favorites без ручной правки

В современном browser overlay теперь можно управлять Favorites напрямую, не открывая legacy Address Book и не правя `servers.lst` вручную.

• вне Favorites доступна кнопка `Add to Fav` для выбранного сервера;
• внутри Favorites доступна кнопка `Del from Fav`;
• после удаления список Favorites обновляется сразу, без переоткрытия браузера;
• кнопки работают и мышью, и через клавиатурный focus chain.

Это особенно полезно тем, кто использует modern browser как основной интерфейс поиска и подключения к серверам.

Обновления 0.99 (для тестеров)