English | νκ΅μ΄ | Changelog
An in-game node graph calculator and flowchart editor for GregTech CEu Modern, EMI, JEI, and multi-mod ecosystems. Designed for planning and balancing complex multi-step production lines directly inside Minecraft without relying on external spreadsheets or web calculators.
- Pluggable Recipe Viewer Integration: Native integration with EMI, JEI, and JEI++ via pluggable SPI, plus an offline pure vanilla fallback. Add recipes via the collapsible Favorites Dock (
[β Favorites (N) βΆ]) or click EMI's native[+]button. - Contextual Drag-to-Search & Auto-Wiring: Drag wires from any port onto empty canvas to instantly search matching producer or consumer recipes and auto-connect with integer ratio matching (
Shift). - In-Place Recipe Switching: Switch recipes on existing nodes with one click (
[π Switch Recipe]) without severing compatible wire connections (IngredientStack.getId()). - Port Multi-Selection & Wire Bundling: Marquee port selection box,
Ctrl/Shiftmulti-select, and bundle dragging with real-time multi-bezier curve rendering. - Port Hiding & Selective Restore: Right-click ports to hide unused I/O ports for compact machine cards, with one-click restore via hidden count badge.
- Canvas Navigation & Subgraphs: 16px grid snapping (
G), quick page switcher (Ctrl + K), folder tree drawer, compound submodules (Ctrl + Shift + G), visual group frames (Ctrl + G), and full Undo/Redo (Ctrl + Z/Ctrl + Y).
- GregTech CEu Modern: Full ULV~MAX voltage tiers, Standard/Perfect/Lossless overclocking, subtick CPS batching, and dual energy hatch support.
- Hardware Addons & Multiblocks: Deductive calculation for heating coils (temperature & duration bonuses), parallel hatches, configurable maintenance hatches, and turbine rotors.
- Multi-Mod Energy Systems: Kinetic calculations for Create & Create: New Age (SU, RPM, generator coils), RF/t dynamos & tier kits for Thermal Series, steam consumption modeling for Systeams / Boilers, and TerraFirmaGreg (TFG) Large Bronze and Steel Boilers with 9 booster fluids and dual-fuel Super Boiler mode.
- Master Anchor & Auto-Ratio Sizing: Designate bottleneck machines as Base Anchors to automatically scale all upstream production chains backwards using integer ceiling, with full support for expanded group frames and steady-state recirculation balancing.
- Recipe Manual Override: Manually customize base processing duration, power consumption/generation, and input/output ingredient quantities in the machine settings dialog for custom or mod-tweaked recipes with one-click restoration.
- Automated Multiblock Bill of Materials (BOM): Aggregates all multiblock and singleblock construction requirements (casings, coils, hatches, controllers) across pages, frames, and compound modules (
Bhotkey). Export shopping lists directly to EMI Recipe Tree, JEI++, or clipboard. - Shared Machine Pools (Time-Sharing Frame): Group multiple recipes sharing physical machines into a pool frame (
Ctrl + Shift + S). Automatically calculates cumulative duty cycles (Total Duty %), quantized machine counts (Ceil), and de-duplicated multiblock BOM. - Hardware Config Synchronization: Synchronize voltage tiers, overclock modes, parallel counts, and addons across all enclosed machines from the frame header.
- AE2 Autocrafting Integration: Bind board pages directly to AE2 Processing Patterns (
[π Bind AE2 Pattern]). Displays calculated completion times (ETA) and bottleneck overlays directly on AE2's Crafting Confirmation screen (CraftConfirmScreen). - DAG Pipeline & Critical Path ETA: Evaluates multi-tier autocrafting jobs over a directed acyclic graph (DAG), accounting for machine parallelism, batch counts, and stage pipeline delays.
- Batch Run Calculator: Calculate total processing duration, required raw materials, projected output yields, and energy consumption based on finite input batches or target production goals via the Optimize menu or Process Summary panel.
- Target Batch Quantity & Real-Time ETA: Define batch goals (e.g.
100x,1,000x,10 B) on goal and reroute nodes to compute remaining completion time, total energy (EU), and raw material requirements.
- Live Team Collaboration: Design factory blueprints concurrently with teammates on dedicated servers with sub-second synchronization.
- Team System Integration: Native support for FTB Teams, Phoenix Guilds, and Vanilla Scoreboard Teams.
- Edit Concurrency Control: Automatic per-page edit locks and live teammate presence indicators prevent concurrent overwrite collisions, backed by automated background saving and revision history forks.
-
Local Web Dashboard: Real-time read-only board viewer and page browser for secondary monitors or web browsers (
/gtcalcboard web), powered by an embedded local daemon with background prewarming and authentic Minecraft slot styling. -
Flow Saturation Wire Modulation: Dynamically modulates wire pulse animation speeds, stalls (duty cycle stutter), and RGB colors (Cyan -> Amber -> Crimson) based on real-time supply saturation ratios (
$R = \text{Supply} / \text{Demand}$ ), with pulsing glow outlines indicating starved bottleneck machines. -
Full-Flow PNG Clipboard Export: One-click clipboard copy (
Share / I/Omenu) of the active canvas page as a clear, high-resolution image regardless of viewport position or zoom level. - Interactive 3-Track Tutorial & Academy: 45-second starter tutorial, 4 specialized academy chapters (ratio solving, wiring, module subpages, workspace management), and contextual in-game design tips.
-
Junction Void Sink & Port-Level Voiding: Configure Junction nodes into infinite void sinks (
SupplyMode.VOID_SINK) orAlt + Right-Clickoutput ports to absorb surplus byproducts and exclude them from net production summaries without severing topology. -
Responsive Toolbar & Adaptive UI: Adaptive toolbar contracts title and collapses overflow buttons on compact screens, high-density addon list view (
[β¦ / β°]), 5-level UI font scaling ([Aa 1.0x]), and Level-of-Detail (LOD) rendering for large graphs (1,200+ nodes).
| Action | Shortcut | Description |
|---|---|---|
| Pan / Zoom Canvas | Right/Middle Click + Drag / Mouse Wheel | Move around and zoom in/out (zooms to cursor) |
| Quick Add Recipe | Space or Double-Click on canvas |
Open recipe browser / search dialog |
| Hotkey Guide HUD | H |
Toggle in-game overlay showing all context hotkeys |
| Multiblock BOM Dialog | B |
Open factory bill of materials breakdown |
| Quick Page Switcher | Ctrl + K |
Fuzzy search and instantly switch between board pages |
| Undo / Redo | Ctrl + Z / Ctrl + Y (or Ctrl + Shift + Z) |
Step backward or forward through edit history |
Full Controls & Shortcuts Cheatsheet (Click to expand)
| Action | Key / Mouse |
|---|---|
| Open Calculator Board | Configurable in Options -> Controls |
| Pan Canvas | Right Click + Drag or Middle Click + Drag |
| Zoom Canvas | Mouse Wheel (Zooms to cursor) |
| Quick Add Recipe | Space or Double-Click on empty canvas space |
| Marquee Box Selection | Left Click + Drag on empty canvas space (Shift + Click to toggle) |
| Multi-Node Dragging | Drag any selected node to move all selected nodes together |
| Create Frame | Ctrl + G |
| Create Shared Machine Pool | Ctrl + Shift + S |
| Group into Module | Ctrl + Shift + G |
| Quick Page Switcher | Ctrl + K (Fuzzy search and instant jump) |
| Toggle 16px Grid Snap | G or lower-left HUD checkbox |
| Undo / Redo | Ctrl + Z (Undo) / Ctrl + Y or Ctrl + Shift + Z (Redo) |
| Clipboard Operations | Ctrl + C (Copy) / Ctrl + X (Cut) / Ctrl + V (Paste) / Ctrl + D (Duplicate) |
| Select All Nodes | Ctrl + A |
| Delete Selected Nodes | Delete or Backspace |
| Rename Machine Title | Double-Click on machine card header title |
| Toggle Hotkey Guide HUD | H |
| Toggle Multiblock BOM Dialog | B |
| Connect Wire | Left Click & Drag between ports |
| Drag to Search & Auto-Wire | Drag from port onto empty canvas -> Select recipe |
| Smart Match Connect (Bidirectional) | Shift + Drag between ports (Integer Ceiling matching) |
| Target Output Rate Inverse Solver | Ctrl + Left Click on output port |
| Context Menu | Right Click on empty canvas, node, port, or selection |
| Unreal Pan & Diagonal Movement | Right-Click Drag or WASD / Arrow Keys (Shift to accelerate) |
| Disconnect Wire / Port | Right Click on wire or port socket |
| Toggle Void Marking | Alt + Right Click on output port |
| Switch Recipe (In-Place) | Click [π Switch Recipe] in Machine Config or Node Context Menu |
| Cycle Rate Time Unit | T (/s -> /min -> /h -> /d -> /t -> 1x per-craft batch) |
| Cycle Global Fluid Unit | Shift + T (Auto -> Always mB -> Always B) |
| Adjust UI Font Scale | Click [Aa 1.0x] (Left/Right), Mouse Wheel, or [+] / [-] |
| Set Master Anchor | Click Anchor icon on recipe card header |
| Edit Machine Count | Click count box -> type number -> Enter / Esc, or use [-] / [+] / [/2] / [x2] |
| Adjust Parallel (Par) | Click [Par] to type number, Mouse Wheel to scale, Right Click for 1/2 |
| Equip Turbine Rotor | Click rotor button -> Select from rotor dialog |
| Change Voltage Tier | Click or Mouse Wheel over Tier button (LV, MV, HV...) |
| Toggle Overclock Mode | Click [STD OC] / [PERF OC] button |
| Blueprint Text Export / Import | Click [Share] / [Import] on top toolbar |
| Recipe / Uses Lookup | Hover over port and press R (Recipes) or U (Uses) |
| Scroll Tabs & Toolbar | Mouse Wheel or click [Β«] / [Β»] overflow indicators |
- CurseForge: GregTech Calculator Board - Minecraft Mods - CurseForge
- Modrinth: GTCalcBoard - Minecraft Mod
GregTech Calculator Board is completely optional on both client and server sides:
- Client Only (Vanilla / Non-Modded Server): You can install the mod on your client and join any multiplayer server, even if the server does not have the mod installed. Personal calculation boards remain fully functional.
- Server Only (Vanilla Clients): Server owners can install the mod on dedicated servers without requiring connecting clients to have the mod installed.
- Both Client & Server: When installed on both client and server, real-time multiplayer team workspace synchronization and live collaboration features are enabled.
- Minecraft:
1.20.1 - Mod Loader:
Minecraft Forge (47.2.0+) - Required Dependencies: None (Fully standalone, 0 hard dependencies required)
- Supported Recipe Viewers (At least one required):
- EMI (1.1.0+ recommended)
- JEI (Just Enough Items) (15.2.0+) / JEI Unofficial
- JEI++ (Just Enough Calculation) (BOM recipe tree integration)
- Supported Tech & Factory Mods:
- GregTech CEu Modern (1.7.0+ or Star Technology forks)
- Applied Energistics 2 (AE2) (Autocrafting pattern binding & DAG ETA evaluation)
- Create (0.5.1 / 6.0+)
- Create: New Age
- Greate (Tiered kinetic machine & shaft integration)
- Thermal Series (Expansion, Foundation, Cultivation)
- Systeams
- Optional Team Synchronization:
- FTB Teams (For dedicated server multiplayer team workspaces)
- Phoenix Guilds (Teams & Guilds integration)
GregTech Calculator Board is an ideal companion for modern GregTech ecosystems. While not officially affiliated with or bundled in these packs, players and server administrators can freely add this mod to their client or dedicated server to enable both personal factory planning and real-time multiplayer team collaboration:
- Star Technology: Tested & Compatible (Supports GTCEu Modern, Create, and Thermal production lines)
- TerraFirmaGreg: Tested & Compatible (Large Bronze and Steel Boiler support)
Disclaimer: These modpacks do not officially endorse, bundle, or maintain this mod. It is an optional third-party addition supported on both client and server sides. If you encounter any calculation issues or conflicts while playing, please report them directly to our GitHub Issues tracker, not to the modpack authors.
git clone https://github.com/Amvermain/GregTechCalculatorBoard.git
cd GregTechCalculatorBoard
./gradlew buildThe compiled jar will be located in build/libs/gtcalcboard-1.20.1-2.3.0.jar.
- Architecture & Developer Guide (English): Internal solver engine, 4-tier architecture, multi-mod physical models, and rendering pipeline.
- Architecture & Developer Guide (Korean): λ΄λΆ μμ§ κ΅¬μ‘°, 4κ³μΈ΅ μν€ν μ², λ©ν° λͺ¨λ 물리 λͺ¨λΈ λ° λ λλ§ νμ΄νλΌμΈ.
- Detailed Code Specification (English): Full system architecture, 5 graph algorithms, overclocking formulas,
CategoryCapabilityMatrix, multiplayer concurrency lock protocol, and SavedData persistence schemas. - Detailed Code Specification (Korean): μ 체 μμ€ν
μν€ν
μ², 5λ κ·Έλν μκ³ λ¦¬μ¦, μ€λ²ν΄λ μ°μ° 곡μ,
CategoryCapabilityMatrix, λ©ν°νλ μ΄ λμμ± λ½ νλ‘ν μ½ λ° μμν μ€ν€λ§. - Architecture Decision Records (ADR): System design decisions and evolution records.
- Discord: Join our Discord Server - Discuss factory blueprints, ask questions, and chat with the community.
- Issue Tracker: GitHub Issues - Report bugs and submit feature requests.
- SirEdvin - For contributing the high-resolution full-flow PNG clipboard export feature (#9).
- The Reel One - For providing UX/UI feedback, design suggestions, and community testing.
- rafaelpnsm - For providing UX/UI feedback, design suggestions, and community testing.
- GenerusWeebius - For thorough testing, meticulous bug reporting, and mathematical verification.
- SatisFlow - Interactive node-graph factory calculator and flowchart planner for Satisfactory.
- Foreman 2 - Node-based visual flowchart production line calculator for Factorio.
- Helmod - Feature-rich in-game factory calculation and recipe matrix solver mod for Factorio.
This project was developed through pair programming between the maintainer and an AI coding assistant (Google Antigravity / Gemini). System architecture, domain requirements, code reviews, in-game verification, and final decision-making were strictly guided and validated by the maintainer.
MIT License - see LICENSE for details.