Q2PRO-X 1.2: демки, Demo Browser и Demo Player

Просмотр документа на сайте Q2PRO-X. Оригинальный файл можно скачать из окна сайта.

Q2PRO-X 1.2

Q2PRO-X 1.2: демки, Demo Browser и Demo Player

Демки, браузер, проигрыватель, аналитика и таймеры

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

28 апреля 2026

q2pro-x.com

Оглавление

  • 1. Какие форматы поддерживаются
  • 2. Demo Browser
  • 3. Вкладки и организация
  • 4. Playlist flow
  • 5. Demo Player Overlay
  • 6. Pause, seek и keys
  • 7. Demo volume, gun и skins
  • 8. MVD Director
  • 9. Demo Analytics
  • 10. Trail mode
  • 11. Analytics colors
  • 12. Demo Item Timers
  • 13. Какие предметы отслеживаются
  • 14. Item timer colors
  • 15. Demo visual cfg
  • 16. Практические сценарии
  • Просто смотреть демки
  • Смотреть MVD дуэль с аналитикой
  • Разбирать контроль предметов
  • Делать красивый demo capture

Q2PRO-X 1.2: демки, Demo Browser и Demo Player

В 1.2 просмотр демок стал отдельной большой областью клиента. Этот документ

объясняет modern demo browser, demo player overlay, MVD/DM2 особенности,

analytics, trail mode, director mode, item timers и demo-visual cfg.

1. Какие форматы поддерживаются

Основные форматы:

  • .dm2 - обычная single-POV демка;
  • .mvd2 - multi-view demo с дополнительной информацией для MVD playback.

Часть функций работает в обоих форматах, часть только в MVD2:

  • demo browser - оба формата;
  • demo player overlay - оба формата;
  • pause/seek - оба, с разной внутренней реализацией;
  • analytics traffic/frags/pickups - полноценно MVD2, DM2 fallback через live

POV sampling;

  • director mode - MVD2;
  • item timers - MVD2.

2. Demo Browser

Путь:

  • Options -> Demo Browser;
  • команда demo_browser_open;
  • bind demo_browser_toggle.

Главные настройки:

  • cl_demo_browser_alpha;
  • cl_demo_browser_scale;
  • cl_demo_browser_fullscreen;
  • cl_demo_browser_show_details;
  • cl_demo_browser_row_colors;
  • cl_demo_browser_show_broken;
  • cl_demo_browser_show_packed;
  • cl_demo_browser_remember_tab;
  • cl_demo_browser_last_tab.

Browser использует центральный индекс:

  • demo_index_rebuild - полный rescan;
  • demo_index_refresh - incremental refresh.

Индекс не должен быть частью релизного пакета. Он создаётся у пользователя

локально.

3. Вкладки и организация

Modern demo browser группирует демки по рабочим представлениям, например:

  • All;
  • Favorites;
  • Date;
  • Mod;
  • Map;
  • POV.

Точная видимость зависит от найденных демо и metadata. remember tab

возвращает browser на последнюю вкладку при следующем открытии.

Partial/unreadable демки можно показывать или скрывать. Packed demos из

engine-visible паков по умолчанию скрыты, чтобы не смешивать пользовательскую

библиотеку с содержимым pak, если это не нужно.

4. Playlist flow

Demo browser поддерживает выбор нескольких демок и playlist-поведение.

Полезные действия:

  • отметить демки;
  • запустить selected queue;
  • перейти к следующей / предыдущей;
  • очистить playlist.

Binds в Demo Player:

  • demo_playlist_next;
  • demo_playlist_prev;
  • demo_playlist_clear.

Если playlist активен, demo player overlay показывает соответствующий

кластер управления.

5. Demo Player Overlay

Путь:

  • Options -> Demo Player;
  • команда demo_player_open;
  • bind demo_player_toggle.

Ключевые настройки:

  • cl_demoplayer_overlay;
  • cl_demoplayer_overlay_alpha;
  • cl_demoplayer_overlay_scale;
  • cl_demoplayer_overlay_autohide_sec;
  • cl_demoplayer_overlay_seek_step_sec;
  • cl_demoplayer_overlay_seek_jump_sec;
  • cl_demoplayer_overlay_y;
  • cl_demoplayer_overlay_show_score;
  • cl_demoplayer_hide_draws;
  • cl_demoplayer_volume;
  • cl_demoplayer_gun;
  • cl_demoplayer_noskins.

Overlay показывает playback controls, timeline, текущие mode pills и

popup-меню для частей управления.

6. Pause, seek и keys

Основные binds:

  • demo_pause_toggle;
  • +demo_seek_back;
  • +demo_seek_forward;
  • demo_player_toggle;
  • demo_browser_toggle.

По умолчанию:

  • Space - pause/resume;
  • Left Arrow - seek back;
  • Right Arrow - seek forward.

Seek step и jump настраиваются отдельно. Для длинных MVD лучше поднять jump,

для коротких дуэлей - оставить небольшой шаг.

7. Demo volume, gun и skins

cl_demoplayer_volume - временный volume override во время demo playback.

После окончания демки обычная игровая громкость восстанавливается.

cl_demoplayer_gun:

  • show gun;
  • hide gun.

Это demo-playback override, он не меняет обычный cl_gun.

cl_demoplayer_noskins:

  • original;
  • no skins.

Это тоже playback override, он не меняет обычный cl_noskins.

8. MVD Director

MVD-only director помогает автоматически выбирать POV.

Режим:

  • cl_demoplayer_mvd_director_mode;

Значения:

  • off;
  • next frag;
  • quad;
  • penta;
  • leader.

Lead time:

  • cl_demoplayer_mvd_director_lead_sec.

Debug:

  • cl_demoplayer_nextfrag_debug.

next frag использует pre-scanned frag timeline, чтобы переключиться до

события. Manual POV override временно ставит director на cooldown, чтобы он

не отбирал управление мгновенно обратно.

9. Demo Analytics

Путь:

  • Options -> Demo Player -> Demo Analytics.

Главный mode:

  • cl_demo_analytics_mode: off / traffic / frags / pickups / all.

Style:

  • cl_demo_analytics_style: overview / world / both.

Time scope:

  • cl_demo_analytics_time_scope: full / elapsed / window;
  • cl_demo_analytics_window_sec.

MVD/DM2:

  • cl_demo_analytics_mvd_autoscan;
  • cl_demo_analytics_dm2_mode.

Density/performance:

  • cl_demo_analytics_sample_ms;
  • cl_demo_analytics_cell_size;
  • cl_demo_analytics_draw_max_cells;
  • cl_demo_analytics_draw_max_events.

Visibility:

  • cl_demo_analytics_overview_alpha;
  • cl_demo_analytics_world_alpha;
  • cl_demo_analytics_world_scale;
  • cl_demo_analytics_show_legend.

Commands:

  • demo_analytics_rescan;
  • demo_analytics_info.

10. Trail mode

Trail mode включается, когда:

  • cl_demo_analytics_world_lifetime_sec > 0.

Вместо агрегированной heatmap рисуются per-sample точки, которые живут N

секунд и могут соединяться линиями.

Настройки:

  • cl_demo_analytics_trail_stride;
  • cl_demo_analytics_trail_lines;
  • cl_demo_analytics_trail_height_mode;
  • cl_demo_analytics_trail_feet_z;
  • cl_demo_analytics_trail_hover_z;
  • cl_demo_analytics_trail_outline;
  • cl_demo_analytics_trail_outline_alpha;
  • cl_demo_analytics_trail_outline_scale.

trail_height_mode feet рисует след ближе к ногам игрока, учитывая прыжки,

падения и перемещения по ящикам. hover_z поднимает точки чуть выше, чтобы

они не клиппились в пол.

11. Analytics colors

Цвета analytics редактируются через отдельный menu editor:

  • Analytics colors....

Ключевые cvar:

  • cl_demo_analytics_traffic_low_color;
  • cl_demo_analytics_traffic_high_color;
  • cl_demo_analytics_frag_color;
  • cl_demo_analytics_pickup_color;
  • cl_demo_analytics_trail_line_color;
  • cl_demo_analytics_trail_outline_color;
  • cl_demo_analytics_world_adaptive_colors.

В меню используется preset-style выбор цветов, как в редакторах моделей и

item timers. Hex-значения также можно менять через console/cvar browser.

12. Demo Item Timers

Item timers показывают respawn timers для важных предметов в MVD2.

Master:

  • cl_demo_item_timers_world: off / world only / strip only / both.

World view:

  • translucent ghost item models;
  • countdown labels над местом предмета;
  • отключение countdown, когда предмет появился.

Strip:

  • demo player strip с item icons;
  • полупрозрачное состояние, когда item ждёт respawn;
  • timer поверх icon;
  • full-color icon, когда item доступен.

Настройки:

  • cl_demo_item_timers_world_alpha;
  • cl_demo_item_timers_world_scale;
  • cl_demo_item_timers_strip_alpha;
  • cl_demo_item_timers_strip_pillarbox_workspace;
  • demo_item_timers_strip_edit;
  • demo_item_timers_strip_reset;
  • demo_item_timers_info.

13. Какие предметы отслеживаются

Armor:

  • green jacket armor;
  • yellow combat armor;
  • red body armor.

Powerups/items:

  • Quad Damage;
  • Invulnerability;
  • Silencer;
  • Rebreather;
  • Environment Suit;
  • Adrenaline;
  • Mega Health;
  • Power Screen;
  • Power Shield.

Weapons, off by default:

  • Rocket Launcher;
  • BFG10K;
  • Railgun.

Per-item toggles:

  • cl_demo_item_timers_show_armor_green;
  • cl_demo_item_timers_show_armor_yellow;
  • cl_demo_item_timers_show_armor_red;
  • cl_demo_item_timers_show_quad;
  • cl_demo_item_timers_show_invuln;
  • cl_demo_item_timers_show_silencer;
  • cl_demo_item_timers_show_breather;
  • cl_demo_item_timers_show_enviro;
  • cl_demo_item_timers_show_adrenal;
  • cl_demo_item_timers_show_megahealth;
  • cl_demo_item_timers_show_power_screen;
  • cl_demo_item_timers_show_power_shield;
  • cl_demo_item_timers_show_rl;
  • cl_demo_item_timers_show_bfg;
  • cl_demo_item_timers_show_rail.

14. Item timer colors

Item timer colors редактируются через:

  • Items colors....

Есть adaptive mode:

  • cl_demo_item_timers_adaptive_colors.

Когда adaptive включён, цвета могут наследоваться из item-highlight palette.

Когда выключен, manual per-item text/ring colors управляются отдельно.

15. Demo visual cfg

Все demo visual настройки должны сохраняться в:

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

Это важно для:

  • visibility highlights;
  • model color overrides;
  • analytics;
  • trail;
  • item timers;
  • item timer colors.

Идея: демка из opentdm, k1, xatrix или другого mod не должна внезапно

подменять вашу графику просмотра только потому, что playback временно вошёл

в gamedir этой демки.

16. Практические сценарии

Просто смотреть демки

  • открыть Demo Browser;
  • rebuild index один раз;
  • включить Demo Player overlay;
  • cl_demoplayer_volume настроить под запись;
  • gun/skins по вкусу.

Смотреть MVD дуэль с аналитикой

  • cl_demo_analytics_mode all;
  • cl_demo_analytics_style both;
  • cl_demo_analytics_time_scope elapsed;
  • trail lifetime 3-10 sec;
  • trail_height_mode feet;
  • trail_outline 1.

Разбирать контроль предметов

  • item timers = both;
  • включить armor, megahealth, quad, invuln, power shield;
  • weapons оставить off, если они засоряют strip;
  • переместить strip через demo_item_timers_strip_edit.

Делать красивый demo capture

  • использовать demo-visual cfg;
  • cl_vis_players_mode model;
  • настроить player model colors;
  • trail outline включить;
  • item timers включать только если они нужны в кадре.