GregTech Calculator Board

## \[1.0.3\] - 2026-08-18 ### Added * **Interactive Onboarding Tutorial & Welcome Modal (`TutorialManager`, `TutorialOverlay`)**: * **Welcome Dialog (`WelcomeTutorialDialog`)**: Welcomes first-time players with an option to start a step-by-step interactive flowsheet tutorial. * **5-Step Core Tutorial Guide**: 1. **Step 1. Add Recipe Nodes**: Use the canvas quick-add marker `[+]` or the top toolbar `[➕ Add]` button. 2. **Step 2. Connect Basic Wires**: Drag from an output port (green) to an input port (blue) to establish resource flow. 3. **Step 3. Shift + Drag 1:1 Auto-Ratio**: Hold `Shift` while wiring to automatically calculate and balance machine counts based on production/consumption rates. 4. **Step 4. Base Master Anchor & Auto Ratio**: Toggle `[🎯]` on the final product node and click `[⚖ Ratio]` to synchronize the entire upstream production line. 5. **Step 5. Disconnecting Wires & Canvas Clear**: Right-click any wire curve or port to disconnect, and use `[🗑 Clear]` to reset. * Features translucent tutorial cards, animated pulsating target highlights, and skip/restart options. * **Contextual Quick-Add Canvas Marker (`[+]`)**: * Left-clicking any empty canvas area spawns a subtle, translucent **`[+]` quick-add button** at the clicked coordinates. * Clicking `[+]` opens the recipe search dialog and immediately spawns the selected machine node at the exact clicked canvas location. * **Vector / Delta-Based Undo & Redo System (`HistoryManager`, `BoardCommand`)**: * **Ultra-Low Memory Command/Delta Architecture**: Records only relative positional deltas (`dx, dy`), node/wire references, and property old/new values instead of heavy full-graph snapshots. * **Hotkeys**: `Ctrl + Z` (Undo), `Ctrl + Y` or `Ctrl + Shift + Z` (Redo). * **Toolbar Controls**: Added `[↶ Undo]` and `[↷ Redo]` buttons with dynamic enabled/disabled styling. * **Comprehensive Action Coverage**: Supports undoing/redoing node movements (single & multi-drag), adding/deleting nodes, connecting/disconnecting wires (including Shift-scaling counts), inline/button property edits (machine counts, voltage tiers, OC modes, parallels, custom names, master anchors, turbine rotors), module grouping/expanding, auto-connect, auto-ratio, and max-flow optimizations. * **Independent Per-Tab History**: Each page tab maintains its own isolated undo/redo history stacks. * **Collapsible Hotkey HUD (`HotkeyHudWidget`)**: * Added a collapsible hotkey guide overlay in the bottom-right corner of the canvas. * Press **`H`** to toggle the HUD open/closed at any time to check keybindings (`Ctrl+Z`, `Ctrl+Y`, `Ctrl+C/V/X/D`, `Shift+Wire`, `H`, `Delete`, `R/U`). * **Dynamic Port & Wire Dragging Guidance Tooltips**: * Hovering over ingredient ports displays localized port descriptions and connection tips. * Live wire dragging renders contextual guidance tooltips: * Normal Drag: _"Click target port to connect wire."_ * **`Shift + Drag`**: _"✨ Shift Connect: Automatically balances target machine count to 1:1 supply-demand ratio."_ * **Page Tab Management & Confirmation Dialogs (`PageTabBarWidget`, `DeletePageConfirmDialog`)**: * **Double-Click / Right-Click Tab Renaming**: Double-click or right-click any page tab header to edit its name inline with keyboard typing. * **Horizontal Drag & Wheel Scrolling**: Drag across the tab bar or use the mouse wheel to scroll horizontally when managing many preset tabs. * **Page Deletion Confirmation**: Added `DeletePageConfirmDialog` to prevent accidental deletion of important build flowcharts. * **Switchable Power Display Modes (`PowerDisplayMode`)**: * Click the power summary row in the Process Summary panel to cycle through display units: * **`EU/t`** (Default GT tick rate) * **`EU/s`** (Per-second EU) * **`RF/t` / `FE/t`** (FE/RF equivalent for Thermal and cross-mod builds) * **Standalone In-Game Manual & Guidebook Dialog (`GuideDialog`)**: * Added `[📖 Guide]` button on the top toolbar to access a built-in, 6-chapter manual modal directly over the canvas with zero external mod dependencies. * **Multi-Selection & Batch Operations (Marquee Box, Multi-Drag, Clipboard)**: * **Marquee Box Selection**: Left-click and drag on empty canvas space to draw a cyan selection box and select multiple nodes at once. * **Shift + Click Multi-Select**: Toggle individual nodes into or out of selection. * **Batch Dragging**: Dragging any selected node moves all selected machines together while preserving relative positions and internal wires. * **Clipboard Shortcuts**: * `Ctrl + X`: Cut selected nodes and internal wires. * `Ctrl + C`: Copy selected nodes and internal wires to clipboard. * `Ctrl + V`: Paste copied nodes at cursor position with fresh unique IDs (UUIDs). * `Ctrl + D`: Duplicate selected nodes immediately. * `Delete` / `Backspace`: Batch delete selected nodes and connections. * `Ctrl + A`: Select all nodes on canvas. * **Inline Custom Title Renaming (`NodeNameEditor`)**: * Double-click any node header title to open the inline text editor and rename machines (e.g. `Sulfuric Acid Line 1`, `Turbine Power Plant`) persistently. * **Compound Module Subgraph Abstraction & Expansion**: * **`[📦 Group]`**: Condense complex interconnected production facilities into a single **Compound Module Card**. * **Automatic Byproduct Encapsulation**: Hides 100% self-recycled and internally consumed intermediate fluids/items, exposing only raw external inputs, net final outputs, combined EU/t, and total contained machines. * **`[⤢ Expand]` Restoration**: Click the expand button on a module card at any time to restore all individual machines and internal wires onto the canvas. * **Selective Module Grouping**: Group only a selected subset of nodes with automatic external wire rewiring. * **Soft Dependency Mod Compatibility Guard (`ModCompatHelper`)**: * Isolates mod-specific bytecode calls for GregTech (`gtceu`), Thermal (`thermal`), and EnderIO (`enderio`). ### Fixes & Improvements * **Z-Index & Depth Buffer Bleed-Through Fixes**: * Completely eliminated 3D item models and fluid sprites bleeding through overlapping node cards via explicit depth test disabling and per-node Z-offset layers. * SummaryOverlay, ToolbarWidget, PageTabBarWidget, and Dialogs now render reliably on top of all canvas elements. * **Fixed Module Machine Count in Process Summary**: * Summary Overlay now accurately aggregates the total count of physical machines contained within compound modules (e.g. 58 machines) and lists detailed breakdown in tooltips. * **Fixed Module Card UI Overlap & Clean Minimal Design**: * Compacted module badges (`📦 58 machines`) and tags with safety margins to prevent text clipping. * Completely hides irrelevant tier, generator, OC, rotor, and parallel buttons on compound module cards. * **Comprehensive I18n Audit & Localization**: * Audited all UI components, dialogs, tutorial hints, and error messages to ensure 100% complete 1:1 translation coverage in English (`en_us.json`) and Korean (`ko_kr.json`). * **Streamlined Top Toolbar Layout**: * Reorganized toolbar buttons into a clean, intuitive layout with responsive scrolling and rich tooltips.