Project Chimera
Меню

Исходники

440 строк · 26 КиБ

packaging/site/pages/wiki.html

1<section class="chl-section" style="padding-bottom:24px">
2 <div class="wrap">
3 <p class="lbl">Chimera Launcher</p>
4 <h1>Справка</h1>
5 <p class="lead">
6 Все разделы по порядку: где что искать и как этим пользоваться. Ищете
7 конкретное — содержание слева.
8 </p>
9 </div>
10</section>
11
12<section class="chl-section" style="padding-top:10px">
13<div class="wrap chl-wiki">
14
15 <nav class="chl-toc">
16 <p class="lbl">Содержание</p>
17 <ul>
18 <li><a href="#start">Первый запуск</a></li>
19 <li><a href="#library">Библиотека</a></li>
20 <li><a href="#game">Карточка игры</a></li>
21 <li><a href="#settings">Настройки игры</a></li>
22 <li><a href="#wine">Сборки Wine</a></li>
23 <li><a href="#prefix">Префикс и снимки</a></li>
24 <li><a href="#stores">Магазины</a></li>
25 <li><a href="#accounts">Аккаунты</a></li>
26 <li><a href="#media">Скриншоты</a></li>
27 <li><a href="#stats">Статистика</a></li>
28 <li><a href="#backups">Бэкапы сохранений</a></li>
29 <li><a href="#gamepad">Геймпад и приставка</a></li>
30 <li><a href="#doctor">Диагностика</a></li>
31 <li><a href="#updates">Обновления</a></li>
32 <li><a href="#cli">Командная строка</a></li>
33 </ul>
34 </nav>
35
36 <div class="chl-wiki-body">
37
38 <section id="start">
39 <h2>Первый запуск</h2>
40 <p>
41 При первом открытии лаунчер предлагает мастер настройки: куда класть
42 данные, какую сборку Wine поставить, подтянуть ли игры из Steam. Всё это
43 необязательно и меняется потом в разделах.
44 </p>
45 <p>
46 Три вещи, которые стоит сделать сразу, чтобы дальше было проще:
47 </p>
48 <ul>
49 <li><strong>Подтянуть игры из Steam</strong> — «Аккаунты» → Steam →
50 «Синхронизировать». Установленные игры Steam появятся в
51 библиотеке вместе с обложками.</li>
52 <li><strong>Войти в Epic и GOG</strong>, если они у вас есть, — там
53 же, в «Аккаунтах». Купленные игры появятся в библиотеке
54 отдельными плитками.</li>
55 <li><strong>Поставить сборку Wine</strong> — «Сборки Wine». Без неё
56 запускать игры не на чем (игры Steam — исключение, их запускает
57 Steam своим Proton).</li>
58 </ul>
59 </section>
60
61 <section id="library">
62 <h2>Библиотека</h2>
63 <p>
64 Главный раздел. Всё, что у вас есть, — в одной сетке: добавленные
65 вручную игры, синхронизированные из Steam и купленное в Epic и GOG.
66 </p>
67
68 <h3>Вкладки</h3>
69 <p>
70 <strong>Все · Steam · Epic Games · GOG.com · Свои.</strong> «Свои» —
71 добавленные вручную и перенесённые из StartWine: то, за чем не стоит
72 магазина.
73 </p>
74
75 <h3>Установленные и не установленные</h3>
76 <p>
77 Кнопки рядом с поиском: <strong>Все · Установленные · Не
78 установленные · Файлов нет</strong>. «Не установленные» — купленное в
79 магазине, чего нет на диске. «Файлов нет» — игра есть в библиотеке, но
80 по записанному пути её больше нет: так выглядят игры после переезда на
81 другой диск, и лаунчер умеет искать, куда они переехали.
82 </p>
83
84 <h3>Ряд «Продолжить»</h3>
85 <p>
86 Три последние запущенные игры, в какие бы вы ни играли — включая
87 запущенные прямо из Steam. Рядом с названием — когда и сколько длился
88 последний сеанс.
89 </p>
90
91 <h3>Добавить игру</h3>
92 <ul>
93 <li><strong>Добавить игру</strong> — выбрать <code>.exe</code>
94 вручную.</li>
95 <li><strong>Сканировать папку</strong> — найти в каталоге сразу
96 несколько игр и добавить отмеченные.</li>
97 <li>Открыть <code>.exe</code> из файлового менеджера «с помощью
98 Chimera Launcher» — тоже добавит.</li>
99 </ul>
100
101 <h3>Внешний вид сетки</h3>
102 <p>
103 Размер плиток — числом в процентах рядом с сортировкой. Постеры или
104 широкие баннеры — в разделе «Внешний вид». Обложки для игр без
105 картинки лаунчер ищет сам по названию.
106 </p>
107 </section>
108
109 <section id="game">
110 <h2>Карточка игры</h2>
111 <p>Щелчок по плитке открывает карточку. Она разложена вкладками:</p>
112 <ul>
113 <li><strong>Об игре</strong> — баннер, описание, переименование и
114 удаление из библиотеки.</li>
115 <li><strong>Запуск</strong> — путь к файлу, аргументы, рабочий
116 каталог, предполётные проверки.</li>
117 <li><strong>Настройки</strong> — всё про то, как игра запускается;
118 см. <a href="#settings">ниже</a>.</li>
119 <li><strong>База знаний</strong> — прохождения, гайды и советы по
120 этой игре. Выключено по умолчанию: включается один раз в
121 «Настройках лаунчера», и только после этого лаунчер идёт за ними
122 в сеть.</li>
123 <li><strong>Префикс</strong> — снимки, служебные инструменты Wine,
124 отчёт о совместимости. У игр Steam этой вкладки нет: префиксом
125 там распоряжается Steam.</li>
126 <li><strong>Картинки</strong> — обложка, баннер и ваши снимки из этой
127 игры.</li>
128 </ul>
129 <p>
130 Кнопка «Запустить» — в шапке карточки. Пока игра идёт, она
131 превращается в «Завершить».
132 </p>
133 </section>
134
135 <section id="settings">
136 <h2>Настройки игры</h2>
137 <p>
138 Настройки живут в двух местах, и это одно и то же дерево:
139 </p>
140 <ul>
141 <li><strong>«Настройки игры» в боковой панели</strong> — общие
142 умолчания, которые действуют на все игры сразу.</li>
143 <li><strong>Вкладка «Настройки» в карточке</strong> — то же самое, но
144 только для этой игры, поверх общих.</li>
145 </ul>
146
147 <h3>Откуда берётся значение</h3>
148 <p>Четыре слоя, каждый следующий перебивает предыдущий:</p>
149 <ol>
150 <li><strong>Умолчание</strong> — то, что считается разумным для всех.</li>
151 <li><strong>Совет сообщества</strong> — профиль, подтверждённый
152 чужими успешными запусками именно этой игры. Такие строки помечены
153 подписью «совет сообщества».</li>
154 <li><strong>Общие умолчания</strong> — то, что вы выставили на все
155 игры.</li>
156 <li><strong>Настройка этой игры</strong> — ваш выбор здесь. Он
157 сильнее всех остальных всегда.</li>
158 </ol>
159
160 <h3>Уровни</h3>
161 <p>
162 Переключатель «Уровень» наверху: <strong>только простые</strong>,
163 <strong>обычные</strong>, <strong>все</strong>. Каждый следующий
164 добавляет к предыдущему. Если не знаете, что искать, — оставьте
165 «только простые»: там то, что нужно знать всем.
166 </p>
167
168 <h3>Что где лежит</h3>
169 <ul>
170 <li><strong>Запуск</strong> — версия Windows, рабочий стол в окне,
171 приоритет процесса, переменные окружения.</li>
172 <li><strong>Графика</strong> — DXVK и VKD3D, HDR, FSR, масштаб
173 разрешения, ограничение кадров, синхронизация.</li>
174 <li><strong>MangoHud</strong> — что показывать оверлеем и где.</li>
175 <li><strong>Античиты</strong> — BattlEye и EAC. Лаунчер их не
176 обходит: задача обратная — чтобы они работали и игра пускала в
177 сеть.</li>
178 <li><strong>Продвинутое</strong> — то, что обычно трогать не нужно:
179 подмены библиотек, отладочные переменные Wine.</li>
180 </ul>
181 <p>
182 Поиск наверху ищет не только по названию настройки, но и по описанию
183 и по строке «когда менять» — если знаете симптом, а не название,
184 ищите симптом.
185 </p>
186
187 <h3>Игры Steam</h3>
188 <p>
189 Их запускает Steam, а не лаунчер, — но настройки к ним всё равно
190 применяются, если в свойствах игры выбран слой совместимости
191 «Chimera Launcher». Поставить его можно в разделе «Аккаунты» → Steam.
192 Перезапускать Steam после смены настроек не нужно: они читаются в
193 момент запуска игры.
194 </p>
195 </section>
196
197 <section id="wine">
198 <h2>Сборки Wine</h2>
199 <p>
200 Раздел показывает установленные сборки и те, что можно поставить.
201 Список приходит подписанным манифестом — лаунчер проверяет подпись и
202 контрольную сумму каждого файла перед распаковкой.
203 </p>
204 <p>
205 Какую выбрать, если непонятно: свежую <strong>GE-Proton</strong> —
206 она покрывает большинство случаев. Если игра работала, а после смены
207 сломалась, вернитесь на прежнюю: смена сборки — первая причина, по
208 которой рабочая игра перестаёт запускаться.
209 </p>
210 <p>
211 Перед сменой сборки лаунчер сам снимает копию префикса. Это не
212 перестраховка ради красивой фразы: сборка Wine меняет содержимое
213 префикса необратимо.
214 </p>
215 </section>
216
217 <section id="prefix">
218 <h2>Префикс и снимки</h2>
219 <p>
220 Префикс — это «диск C:» для Windows-игры. По умолчанию он общий на
221 все игры: отдельный префикс на игру занимал бы десятки гигабайт на
222 ровном месте.
223 </p>
224 <p>Снимок префикса делается автоматически перед тем, что его меняет:</p>
225 <ul>
226 <li>смена сборки Wine;</li>
227 <li>новый или изменившийся патч реестра;</li>
228 <li>запуск winetricks;</li>
229 <li>открытие winecfg, regedit, uninstaller или cmd.</li>
230 </ul>
231 <p>
232 Снимки видны на вкладке «Префикс» карточки игры: там же — вернуться к
233 любому из них и удалить лишние. Снимки, снятые вручную, автоматическая
234 уборка не трогает никогда.
235 </p>
236 </section>
237
238 <section id="stores">
239 <h2>Магазины</h2>
240 <p>
241 Раздел «Магазины» — это витрины, и только они: Epic, GOG, Steam и
242 обычный браузер. Сюда заходят посмотреть и купить; играть — из
243 библиотеки.
244 </p>
245 <p>
246 Вход берётся из того, во что лаунчер уже вошёл: отдельно входить в
247 магазин не нужно. Для Epic и GOG — из аккаунта, в который вы вошли в
248 разделе «Аккаунты». Для Steam — из клиента Steam на этой машине; эти
249 данные не покидают компьютер, и это выключается в «Настройках
250 лаунчера».
251 </p>
252 </section>
253
254 <section id="accounts">
255 <h2>Аккаунты</h2>
256 <p>
257 Вход в магазины, синхронизация и выход. Отдельно от витрин намеренно:
258 вход настраивают один раз, а в магазин заходят регулярно.
259 </p>
260 <ul>
261 <li><strong>Steam</strong> — «Синхронизировать» подтягивает
262 установленные игры Steam в библиотеку вместе с обложками. Там же
263 ставится слой совместимости, через который к играм Steam
264 применяются настройки лаунчера.</li>
265 <li><strong>Epic</strong> — вход открывает настоящую страницу Epic в
266 окне: адрес видно, пароль вводится там же и лаунчеру не виден.
267 Код после входа лаунчер подхватывает сам. Если не сработало —
268 рядом есть запасной путь через обычный браузер и поле для кода.</li>
269 <li><strong>GOG</strong> — так же.</li>
270 </ul>
271 <p>
272 Купленные игры здесь не показываются — они в библиотеке, вместе с
273 установленными. Одна игра не должна жить в двух списках.
274 </p>
275 </section>
276
277 <section id="media">
278 <h2>Скриншоты</h2>
279 <p>
280 <strong>Ctrl+Shift+Insert</strong> во время игры — снимок экрана.
281 Хоткей ловится независимо от того, какое окно в фокусе: именно для
282 того, чтобы срабатывать в игре.
283 </p>
284 <p>
285 Это требует доступа к устройствам ввода, поэтому по умолчанию
286 выключено: «Настройки лаунчера» → «Скриншот и запись» → «Ловить
287 хоткей». Там же написано, сколько клавиатур сейчас видно, — если ноль,
288 нужно добавить себя в группу <code>input</code> и войти в систему
289 заново.
290 </p>
291 <p>
292 Снимки складываются в системный каталог «Изображения», а имя игры
293 попадает прямо в имя файла: кадр знает, во что вы играли. Раздел
294 «Медиа» показывает последние снимки с подписью «во что и когда», даёт
295 открыть каталог и убрать лишний кадр в корзину — именно в корзину, а
296 не насовсем: кадр не переснять.
297 </p>
298 <p>
299 Свои кадры из конкретной игры видны и на её карточке, вкладка
300 «Картинки».
301 </p>
302 <p class="chl-muted">
303 Запись экрана пока не реализована — хоткей под неё зарезервирован, но
304 ничего не делает.
305 </p>
306 </section>
307
308 <section id="stats">
309 <h2>Статистика</h2>
310 <p>
311 Сколько наиграно в каждую игру, сколько раз запускали, когда в
312 последний раз и сколько длился последний сеанс.
313 </p>
314 <p>
315 Считается по времени жизни процесса игры. У игр, которые запускает
316 внешний лончер и сразу отдаёт управление (Ubisoft Connect, EA App), а
317 также у запущенных из Steam число будет заниженным или нулевым — наш
318 процесс к тому моменту уже вышел. Это видно и написано, а не спрятано.
319 </p>
320 <p>Данные лежат у вас на диске и никуда не отправляются.</p>
321 </section>
322
323 <section id="backups">
324 <h2>Бэкапы сохранений</h2>
325 <p>
326 Сохранения копируются отдельно от префикса — чтобы переустановка игры
327 или пересборка префикса не значили «начать заново».
328 </p>
329 <p>
330 Лаунчер знает типичные места, где игры держат сохранения, и находит их
331 сам; своё место можно указать руками. Копии версионные: видно, когда
332 каждая сделана, и можно вернуть любую.
333 </p>
334 </section>
335
336 <section id="gamepad">
337 <h2>Геймпад и режим приставки</h2>
338 <p>
339 <strong>F11</strong> или кнопка в шапке — режим приставки: полный
340 экран, крупные плитки, навигация геймпадом. Тот же интерфейс, а не
341 второй, урезанный.
342 </p>
343 <p>
344 Раздел «Геймпад» показывает, какой контроллер подключён, и даёт
345 переназначить кнопки. Без подключённого пада страница «нажмите
346 кнопку» была бы разговором в пустоту, поэтому состояние видно сразу.
347 </p>
348 <p><strong>F9</strong> сворачивает боковую панель до полосы значков.</p>
349 </section>
350
351 <section id="doctor">
352 <h2>Диагностика и отчёты</h2>
353 <p>
354 Перед каждым запуском лаунчер проверяет то, из-за чего запуск сорвётся:
355 есть ли файл игры (и не переехал ли он), есть ли сборка Wine, можно ли
356 писать в префикс, на месте ли нужные инструменты. Все причины
357 показываются сразу и до того, как что-то сделано, — а не по одной и не
358 после того, как префикс уже собран.
359 </p>
360 <p>
361 Раздел «Диагностика» собирает состояние системы: видеокарта и драйверы,
362 Vulkan, звук, сессия, установленные сборки.
363 </p>
364
365 <h3>Отправить отчёт</h3>
366 <p>
367 «Диагностика» → «Отправить отчёт». Выбираете симптом — не запускается,
368 чёрный экран, вылетает, тормозит, нет звука, геймпад, что-то не так в
369 самом лаунчере, — и лаунчер собирает то, что нужно именно под этот
370 симптом. Рядом с каждым разделом написано, зачем он собран.
371 </p>
372 <p>
373 <strong>Перед отправкой всё показывается целиком</strong>, и любой
374 раздел можно выключить. Отчёт сначала ложится файлом на ваш диск и
375 только потом, отдельным нажатием, уходит. Кнопка «Сохранить файлом»
376 рядом в сеть не ходит вовсе.
377 </p>
378 <p>
379 Предложить функцию — тем же путём: симптом «что-то не так в самом
380 лаунчере» подходит и для «хочу вот так».
381 </p>
382
383 <h3>Поделиться своим опытом</h3>
384 <p>
385 На карточке игры, вкладка «Префикс». Отправляет то, что видно на
386 экране: сборку Wine, изменённые относительно умолчаний настройки и ваш
387 вердикт — работает, работает с оговорками, не работает. Из этого
388 складывается <a href="/launcher/db/">база запусков</a> и те самые
389 «советы сообщества» в настройках.
390 </p>
391 </section>
392
393 <section id="updates">
394 <h2>Обновления</h2>
395 <p>
396 Лаунчер проверяет новую версию при запуске и, если она есть, показывает
397 полосу под шапкой окна и системное уведомление. Полоса висит, пока
398 обновление не поставлено; уведомление приходит один раз на версию.
399 </p>
400 <p>
401 <strong>Ничего не ставится само.</strong> Кнопка ведёт в раздел
402 «Обновления», где видно, что изменилось, и есть выбор: поставить
403 сейчас, потом или пропустить эту версию.
404 </p>
405 <p>
406 Проверка — обычный анонимный запрос одного статического файла: о вас не
407 отправляется ничего. Подлинность обновления держится на подписи и
408 контрольных суммах; неподписанное не ставится вовсе. Прошлая версия
409 сохраняется, и откат делается одной командой.
410 </p>
411 <p>
412 Выключается в двух местах, это одна настройка: «Настройки лаунчера» →
413 «Обновление лаунчера» и «Обновления» → «Проверять при запуске».
414 </p>
415 </section>
416
417 <section id="cli">
418 <h2>Командная строка</h2>
419 <p>
420 Всё, что делает интерфейс, умеет и <code>chl</code> — он ставится
421 рядом с лаунчером.
422 </p>
423 <pre><code>chl list # что в библиотеке
424chl run "Metro Exodus" # запустить
425chl stop "Metro Exodus" # закрыть
426chl env "Metro Exodus" # какие переменные уйдут в игру
427chl settings "Metro Exodus" # какие настройки применятся и откуда взялись
428chl doctor # проверка системы
429chl update --check # есть ли новая версия
430chl steam import # подтянуть игры Steam</code></pre>
431 <p>
432 <code>chl settings</code> отвечает на главный вопрос при разборе
433 проблемы — «почему игра запускается вот так».
434 </p>
435 </section>
436
437 </div>
438</div>
439</section>
440