Ghost Bot Tracker & Motivator

by xaerie

Provides real-time feedback on construction bots heading to build ghosts and adds a late-game tool to boost them.

Utilities
a day ago
2.0
42
Logistic network

Changelog

Version: 0.7.0
Date: 2025-12-14
  Features:
    - Adjusted Motivator teleport distance to be dynamic based on bot speed (Robot Speed Technology + Quality).
    - Base teleport is ~4 tiles, scaling up to 100 tiles max.
  Changes:
    - Removed "Electrotherapeutic Motivation" research upgrades (effectiveness) to reduce clutter.
    - Updated teleport logic to use 70x effective speed as distance.
Version: 0.6.5
Date: 2025-12-14

  Features:
    - **Performance Optimization**: Comprehensive refactor of internal modules (`eta_calculator`, `bot_finder`, `motivator`) for better performance and maintainability.
    - **Modded Support**: Motivator equipment now supports modded quality tiers above Legendary with custom scaling logic.
  Bugfixes:
    - Fixed `run_tests_headless.sh` syntax errors and log file detection for Mac/Linux environments.
    - Fixed crash in `eta_calculator` when accessing missing prototype properties.
    - Fixed crash in `gui.lua` related to `rendering` object validation.
    - Fixed stale globals `timeframe` and `alpha` persisting in save files.
Version: 0.6.4
Date: 2025-12-10

  Features:
    - **Deconstruction UI**: ETA display now explicitly labels deconstruction tasks as "Deconstruct" instead of "Build".
    - **Tracker Improvements**: Improved handling and visualization for deconstruction targets in the ETA tracker.
Version: 0.6.3
Date: 2025-12-09

  Features:
    - **Deconstruction Support**: Motivator can now target entities marked for deconstruction directly.
    - **Prioritized Searching**: Sparks now prioritize jumping to nearby entities marked for deconstruction before targeting ghosts, helping clear debris blocking construction.
Version: 0.6.2
Date: 2025-12-08

  Features:
    - **Bot Reliability Improvements**:
      - **Recharge**: Bots now receive 5kJ of energy when teleported to prevent depletion mid-task.
      - **Verification**: Cached bots are re-verified every 30 ticks to ensure they haven't changed targets (fixes sticky sparks).
      - **Timeout**: Sparks now automatically jump to a new ghost if stuck for more than 3 seconds.
Version: 0.6.1
Date: 2025-12-08

  Bugfixes:
    - Fixed duplicate statistics display in Factoriopedia by moving stat definitions to the Item prototype.
    - Removed unused "Max Output" statistic from Motivator tooltip.
    - Removed redundant shortcut tool button (hotkey functionality preserved).
Version: 0.6.0
Date: 08. 12. 2025
  Breaking Changes:
    - Removed "Motivator Gun" and "Motivator Ammo" items entirely.
    - Removed grenade/capsule prototype experiments.
    - Changed "Electrotherapeutic Motivator" equipment type to **Battery Equipment**.
  Features:
    - **Spark Mechanic**: Activate via **CTRL+M** (or shortcut) while hovering a ghost.
    - **Quality Scaling**: Sparks become more powerful and efficient with higher quality equipment.
      - **Jolts**: Scale up to +150% (Legendary).
      - **Efficiency**: Capacity (+150%) scales faster than Cost (+80%), allowing more shots per charge.
    - **Custom Stats UI**: Equipment tooltip now displays native-looking blue stats for **Jolts**, **Max Sparks**, and **Energy Cost**.
    - **Visuals & Audio**: Added dedicated sound effects and visual "spark explosion" on activation.
    - **Battery Integration**: Motivator now acts as a 50MJ battery (scales with quality) to power itself.
  Changes:
    - Renamed internal module `motivator_gun` to `motivator_spark`.
    - Removed `movement_bonus` (set to 0%) to prevent UI clutter.
    - Added comprehensive headless test suite for spark logic.
Version: 0.5.1
Date: 03. 12. 2025
  Bugfixes:
    - Fixed infinite chaining bug in motivator gun effect causing lag.
    - Fixed motivator teleporting bots to ghosts before they picked up items.
    - Added missing friendly names for motivator gun and ammo.
    - Updated motivator battery recipe to use copper cables instead of batteries.
Version: 0.5.0
Date: 03. 12. 2025
  Features:
    - Added "Electrotherapeutic Motivator" gun:
      - Implemented new "Tesla" beam mechanic with chain-lightning visuals.
      - Added Area-of-Effect (AOE) motivation along the beam path.
      - Integrated native beam rendering with robust script-driven hit detection.
      - Added dynamic asset loading to support Space Age Tesla Turret visuals while maintaining vanilla compatibility.
    - Performance & Logic Improvements:
      - Implemented TTL caching for bot searches to improve performance.
      - Fixed infinite chaining bug on unclaimed ghosts.
Version: 0.4.1
Date: 27. 11. 2025
  Features:
    - Added debug overlay setting for diagnosing performance issues.
Version: 0.4.0
Date: 25. 11. 2025
  Features:
    - Refactored code for better performance.
Version: 0.3.1
Date: 24. 11. 2025
  Features:
    - Added new icons.
Version: 0.3.0
Date: 23. 11. 2025
  Features:
    - Added a shortcut button and hotkey (CTRL + SHIFT + M) to toggle the Ghost Hover ETA effect.
    - Added "Electrotherapeutic Motivator" description to mod info.
Version: 0.2.2
Date: 23. 11. 2025
  Features:
    - Build changes.
Version: 0.2.1
Date: 23. 11. 2025
  Features:
    - Restructured mod.
Version: 0.2.0
Date: 21. 11. 2025
  Features:
    - Implemented motivator equipment.
Version: 0.1.0
Date: 20. 11. 2025
  Features:
    - Initial release.