About this project

SolarpunkTrainer is a Windows x64 companion utility described as an adaptive biome runtime calibrator. It pairs a Dear ImGui overlay with fail-closed runtime schema validation, aiming to adjust in-memory variables of solarpunk-themed games or simulations while avoiding undefined states. Core ideas - Overlay: a low-latency Dear ImGui interface with solarpunk-themed palettes (Solar Flare, Forest Canopy, Bioluminescent), keyboard navigation and dynamic resolution adaptation. - Fail-closed validation: every touched variable is bound to a schema covering type, range and dependency graph. A triple check covers structure, value bounds and change-rate thresholds. If any check fails, adjustments freeze and a diagnostic is shown rather than leaving the system in an undefined state. - Telemetry dashboard: live graphs of variable drift, validation pass rates and resource usage, with a stated 60ms refresh window. - Mod profiles: calibration setups saved as portable JSON files that can be shared; the validator rejects incompatible schemas. - Guardian mode: background operation that only adjusts variables when the schema permits. - Localization: English, Spanish, French, German, Japanese, Simplified Chinese and Brazilian Portuguese, with OS auto-detection and manual override. Getting started Prerequisites are Windows 10/11 x64, a windowed or borderless target application, and about 200MB of disk space. Installation is described as downloading a release archive, extracting it, and running SolarpunkTrainer.exe, which auto-detects compatible running processes. The tool states it does not inject into protected system processes and only targets user-level application threads. Usage flow Launch alongside the target, select the active process from the overlay dropdown (F2 toggles visibility), browse the variable tree showing current value, safe range and validation status, adjust via sliders or numeric input, then apply. The validator approves or rolls back instantly. Project layout The README shows a structure with a Rust validator core (schema_checker.rs, fail_closed.rs), a C++ Dear ImGui overlay with themes, telemetry collection, i18n strings, example mod profiles, docs and an MIT license. FAQ highlights The README states the tool is for offline single-player use and will not bypass integrity checks or anti-cheat systems. Mods can be exported and imported, with incompatible schemas rejected. The overlay is said to run on a dedicated thread with a 10ms tick rate and typically under 1% CPU on modern x64 processors. A manual attach mode allows custom schemas for unusual memory layouts. The release is portable, with no registry entries or background services. Contributing and roadmap Contributions are invited for stability, localization and validation patterns, with tests via cargo test for the Rust core and ctest for the C++ overlay. The 2026 roadmap lists multi-monitor overlay anchoring, a read-only community mod repository, a libsolarpunk library for third-party integration, and an AI-assisted auto-tuner that learns safe ranges from user corrections. License and disclaimer MIT licensed. The README includes a no-warranty disclaimer and advises backing up save files before using tuning tools.