ClusterRocketProgress v1.4.3
=============================

НАЗНАЧЕНИЕ
----------
Мод для 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%.
- После посадки шкала исчезает.
- В панели "Планетоид" (правый верхний угол) у летящей ракеты за названием
  появляется шкала-фон на всю строку; наведите на неё курсор — увидите процент
  и оставшееся время.

НАСТРОЙКА ВНЕШНЕГО ВИДА
-----------------------
Все настройки — в файле config.yaml (рядом с DLL, в папке мода).
Измените файл и перезапустите игру (или перезагрузите моды).

  ShowClusterBar: true   — шкала над ракетами на карте кластера
  ShowPlanetoidBar: true — мини-шкала в панели «Планетоид»
  BarWidthPx: 260        — ширина шкалы (экранные пиксели, не зависят от зума)
  BarHeightPx: 40        — высота шкалы
  BarOffsetYPx: 88       — насколько выше иконки ракеты висит шкала

Чтобы полностью убрать шкалу с карты — поставьте ShowClusterBar: false.
Имя ракеты выводится внутри шкалы заглавными буквами.

ИЗМЕНЕНИЯ
---------
- v1.4.3: исправлен вылет при заходе ракеты в разлом (NullReferenceException —
  бар обновлялся на уничтоженной ракете). Добавлен файл config.yaml:
  шкалу на карте и в панели «Планетоид» можно отключить или изменить размер.
- 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.3.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.

SETTINGS
--------
All settings live in config.yaml (next to the DLL, inside the mod folder).
Edit the file and restart the game (or reload mods).

  ShowClusterBar: true   — bar above rockets on the cluster map
  ShowPlanetoidBar: true — mini-bar in the "Planetoid" panel
  BarWidthPx: 260        — bar width (screen pixels, zoom-independent)
  BarHeightPx: 40        — bar height
  BarOffsetYPx: 88       — how far above the rocket icon the bar hangs

To fully remove the bar from the map, set ShowClusterBar: false.

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.3: fixed a crash when a rocket enters a space rift (NullReferenceException
  — the bar was refreshed on a destroyed rocket). Added config.yaml: you can now
  disable the bar on the cluster map / in the Planetoid panel, or resize it.
- 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.
