ClusterRocketProgress v1.4.2
=============================

НАЗНАЧЕНИЕ
----------
Мод для Oxygen Not Included: Spaced Out (DLC).
1) Показывает шкалу прогресса полёта над каждой ракетой на карте кластера.
   Когда ракета летит к своей цели, шкала заполняется — сразу видно, сколько
   пролетела и когда долетит. Имя ракеты отображается прямо внутри шкалы,
   размер шкалы и подписи не зависят от масштаба карты (зума).
2) Дублирует шкалу в панель "Планетоид" в правом верхнем углу (список
   планетоидов и ракет): у летящей ракеты в списке за названием появляется
   шкала-фон на всю строку с тултипом (процент и оставшееся время). Панель
   видна и во время игры на астероиде, и на карте кластера.

СОСТАВ МОДА
-----------
- ClusterRocketProgress.dll — сам мод (Harmony-патч).
- mod.yaml / mod_info.yaml — метаданные мода.
- README.txt — этот файл.

ТРЕБОВАНИЯ
----------
- Oxygen Not Included с дополнением Spaced Out (без DLC мод не нужен:
  в базовой игре шкала полёта в списке ракет уже есть).
- Любая актуальная версия игры (мод собран под актуальные DLL).

УСТАНОВКА
---------
1. Скачайте и распакуйте архив ClusterRocketProgress_v1.4.2.zip.
2. Скопируйте папку ClusterRocketProgress в папку локальных модов игры:
   - Steam Workshop/локально: SteamLibrary\steamapps\common\OxygenNotIncluded\Mods\
   - Или в папку модов Klei (локальные моды):
     C:\Users\<имя_пользователя>\Documents\Klei\OxygenNotIncluded\mods\Local\
   Важно: внутри этой папки должны лежать ClusterRocketProgress.dll,
   mod.yaml и mod_info.yaml (можно класть в подпапку ClusterRocketProgress).
3. Запустите игру, в меню "Моды" включите мод ClusterRocketProgress.
4. (Пере)загрузите сейв.

ИСПОЛЬЗОВАНИЕ
-------------
- Откройте карту кластера (Spaced Out) и запустите ракету.
- Над ракетой появится шкала с именем ракеты внутри; шкала заполняется
  во время полёта.
- Наведите курсор на шкалу, чтобы увидеть процент полёта и оставшееся время.
- Когда ракета достигает цели (ожидает посадки) — шкала заполнена на 100%.
- После посадки шкала исчезает.
- В панели "Планетоид" (правый верхний угол) у летящей ракеты за названием
  появляется шкала-фон на всю строку; наведите на неё курсор — увидите процент
  и оставшееся время.

НАСТРОЙКА ВНЕШНЕГО ВИДА
-----------------------
Размеры и позиция шкалы задаются константами в исходнике
(файл src\ClusterRocketProgress.cs, класс RocketProgressBar). Размеры —
в пикселях экрана (не зависят от зума):
  BarWidthPx   = 260  — ширина шкалы;
  BarHeightPx  = 40   — высота шкалы;
  BarOffsetYPx = 88   — насколько выше иконки ракеты висит шкала.
Имя ракеты выводится внутри шкалы заглавными буквами.
Если шкала висит слишком высоко/низко — измените BarOffsetYPx
и пересоберите мод.

ИЗМЕНЕНИЯ
---------
- v1.4.2 (03.08.2026): исправлен баг — шкала в панели "Планетоид" не появлялась,
  если ракета запускалась уже во время игровой сессии (шкала появлялась только
  при загрузке сейва с уже летящей ракетой). Добавлена пересинхронизация баров
  раз в 4 секунды (Sim4000ms), сам бар больше не отключается при нахождении
  ракеты на земле.
- v1.4.1: архив для Steam Workshop.
- v1.4.0: добавлена шкала полёта в панель "Планетоид".
- v1.3.0: шкала 260×40, шрифт 20, имя ракеты заглавными.
- v1.2.0: шкала 180×28, шрифт 15.
- v1.1.0: имя ракеты внутри шкалы, постоянный размер при зуме.
- v1.0.0: первая версия (шкала над ракетой на карте кластера).

УДАЛЕНИЕ
--------
Удалите папку ClusterRocketProgress из папок модов и отключите мод в меню игры.

ЛИЦЕНЗИЯ
--------
Бесплатно, без каких-либо гарантий. Используйте на свой страх и риск.

========================================================================
ENGLISH
========================================================================

ABOUT
-----
A mod for Oxygen Not Included: Spaced Out (DLC).
1) Shows a flight progress bar above each rocket on the cluster map. While a
   rocket is flying to its destination, the bar fills up, so you can always see
   how far it has traveled and when it will arrive. The rocket's name is shown
   right inside the bar, and the bar keeps a constant size regardless of map
   zoom, so the label always stays readable.
2) Mirrors the progress into the "Planetoid" panel in the top-right corner
   (the list of planetoids and rockets): flying rockets get a full-row progress
   bar behind their name, with a tooltip showing the flight percentage and the
   remaining time. The panel is visible both in-game on an asteroid and on the
   cluster map.

REQUIREMENTS
------------
- Oxygen Not Included with the Spaced Out DLC (not needed in the base game,
  where the rocket list already shows flight progress).
- Any current game version (built against the current DLLs).

INSTALL
-------
1. Extract ClusterRocketProgress_v1.4.2.zip.
2. Copy the ClusterRocketProgress folder into your local mods folder:
   C:\Users\<username>\Documents\Klei\OxygenNotIncluded\mods\Local\
   The folder must contain ClusterRocketProgress.dll, mod.yaml and mod_info.yaml.
3. Launch the game and enable "Cluster Rocket Flight Progress" in the Mods menu.
4. (Re)load your save.

USAGE
-----
- Open the cluster map (Spaced Out) and launch a rocket.
- A bar with the rocket's name appears above it and fills during the flight.
- Hover the bar to see the flight percentage and remaining time.
- When the rocket reaches its target (waiting to land) the bar is 100% full.
- After landing the bar disappears.
- In the "Planetoid" panel (top-right corner) a flying rocket gets a full-row
  progress bar behind its name; hover it to see the percentage and remaining time.

CHANGELOG
---------
- v1.4.2 (2026-08-03): fixed a bug where the bar in the "Planetoid" panel did not
  appear if the rocket was launched during a game session (it only appeared when
  loading a save with an already-flying rocket). Bars are now re-synced every
  4 seconds (Sim4000ms), and the bar itself no longer disables itself while the
  rocket is grounded.
- v1.4.1: Steam Workshop release archive.
- v1.4.0: added the flight bar to the "Planetoid" panel.
- v1.3.0: bar 260x40, font 20, uppercase rocket name.
- v1.2.0: bar 180x28, font 15.
- v1.1.0: rocket name inside the bar, constant size at any zoom.
- v1.0.0: first version (bar above the rocket on the cluster map).

LICENSE
-------
Free, without any warranty. Use at your own risk.
