⚡ BlueLine (Core)

Clean Wires • Shared Tags • Pure Blueprint Architecture

📺 Showcase Demo  •  🎬 Update #1  •  🎬 Update #2  •  🎬 Update #3  •  💬 Discord Support

Tip

Enterprise & B2B Consulting: This repository deals with advanced low-level engine bypasses of standard Unreal C++ & Blueprint bottlenecks. Currently available for remote contract, custom tooling development, and Co-Dev integration (CET Timezone). Get in Touch →

BlueLine Core (v0.2.0) is the lightweight, modular, open-source Blueprint productivity & wire-organization plugin for Unreal Engine 5.5 floor through 5.8+. Built specifically for high-velocity teams and complex graph architectures, it eliminates "Spaghetti Code" by delivering non-destructive grid formatting, orthogonal Manhattan wire pathfinding with sub-pixel knot centering, Genetic Algorithm crossing minimization, magnetic pin snapping, and semantic smart tag categorization.

---

🌟 Feature Comparison: Core OSS vs Full Fab Edition

Feature / Capability	BlueLine Core (Open Source - MIT)	BlueLine Pro on Fab (Commercial)
Distribution & License	Source Code (MIT)	Precompiled Binaries + Source (Epic Fab)
Engine Support	UE 5.5, 5.6, 5.7, 5.8+	UE 5.5, 5.6, 5.7, 5.8+ (Regular updates)
Magnet Auto-Format	✅ Shift + Q	✅ Shift + Q
Manhattan Wire Rigidify	✅ Shift + R (Centered Knots)	✅ Shift + R (Centered Knots)
Genetic Graph Cleaner	✅ Shift + C (GA Crossing Optimizer)	✅ Shift + C (GA Crossing Optimizer)
Smart Semantic Auto-Tagging	✅ Shift + T (Knot Traversal)	✅ Shift + T (Knot Traversal)
Magnetic Wire Pin Snapping	✅ Included (Compatibility Aware)	✅ Included (Compatibility Aware)
Interactive Wire Style Cycling	✅ Shift + Alt + W	✅ Shift + Alt + W
Theme System & Data Asset Colors	✅ Included (UBlueLineThemeData)	✅ Included (UBlueLineThemeData)
Runtime Debug Visualizer Library	✅ Included (UBlueLineDebugLib)	✅ Included (UBlueLineDebugLib)
Context Menu & Benchmark Spawner	✅ Included (Right-Click Menu + Messy Demo)	✅ Included (Right-Click Menu + Messy Demo)
Automated Regression Suite	✅ 10 Unit Tests (Core Engine)	✅ 16 Unit Tests (Full Enterprise)
Level Viewport Radial Pie Menu	❌ Commercial only	✅ Alt + X (Pivot & Cursor Snapping)
Material & Actor Scope Selection	❌ Commercial only	✅ Included (Viewport Scope Filter)
Blueprint Subsystem Extractor	❌ Commercial only	✅ Shift + B
Blueprint Graph Exporter to Text	❌ Commercial only	✅ Shift + E (LLM / Debug Ready)
Quick Bookmarks System	❌ Commercial only	✅ Alt + 1..9 / Alt + Shift + 1..9
Dockable Snippet Tab & Palette	❌ Commercial only	✅ Shift + S / Shift + I
Static Blueprint Linter & CI/CD	❌ Commercial only	✅ Shift + L + Commandlet
Zero-Latency Wireless Nodes	❌ Commercial only	✅ Decl / Use Wireless Links
Interactive Setup Wizard	❌ Commercial only	✅ Included (Slate Wizard Window)
Dedicated Epic Marketplace Support	GitHub Issues	Direct Priority Email & Discord Role

---

⚡ Core Hotkeys & Shortcuts

Hotkey	Action	Description
Shift + Q	Magnet Align	Non-destructive selection format: aligns selected nodes to the grid relative to input connections without moving unselected logic. Safe for VCS diffs.
Shift + R	Rigidify Wires	Inserts grid-snapped Knots (Reroute Nodes) with sub-pixel centering (CornerX - 16, CornerY - 16) to turn curved wires into clean 90° Manhattan lines.
Shift + C	Clean Graph	Global topological layout pass using Genetic Algorithm crossing reduction, pure-node flow, and comment box position locking.
Shift + T	Auto-Tag	Scans cluster semantics across knots (Combat, Movement, AI, Data) and wraps nodes in colored UBlueLineTagCommentNode boxes.
Shift + Alt + W	Toggle Wire Style	Cycles dynamically through Curved (Vanilla), Manhattan, Circuit Board, and Hybrid wire rendering styles.

---

🏛️ BlueLine Core Pillars

1. 🔀 Pathfinding & Orthogonal Rerouting (Clean Wires)

• Manhattan Routing (Shift+R): Inserts Knot (Reroute) nodes at calculated 90° bends with backward-loop clearance and precise pin centering (CornerX - 16, CornerY - 16).
• Staggered Parallel Connections: Multiple connections between the same node pair receive staggered bend offsets to prevent wire overlap.
• Auto-Routing Interceptor: Automatically routes newly created connections on the fly using deterministic object-ID hashing.
• Magnetic Wire Snapping: Automatically detects nearby compatible pins during wire drag operations and snaps cleanly into position.

   VANILLA SPLINES (CURVED)                   BLUELINE MANHATTAN (90° ORTHOGONAL)
   [Node A]                                  [Node A]
      (Out) ──╮                                 (Out) ──────┐
               ╲                                            │
                ╰──► (In)                                   ▼ (Knot Centered)
                    [Node B]                                └───► (In)
                                                                 [Node B]

---

2. 🏷️ Smart Tag System (Visual Semantics)

• Property Customization: Replaces plain text FGameplayTag entries with styled, colored chips.
• Semantic Analysis Engine: Multi-factored heuristic analyzer that inspects function calls, variable names, and pin topology.
• Auto-Tagging (Shift+T): Clusters connected nodes (traversing through reroute knots) and generates labeled, semantically tinted UBlueLineTagCommentNode boxes.
• Built-in Messy Demo Spawner: Right-click context menu action to spawn benchmark logic chains for test-driving formatting and tagging tools.

---

3. 🧬 Evolutionary Graph Cleaner (Shift+C)

• Hierarchical Organization: Uses topological BFS ranking to structure chaotic graph execution flows into clean left-to-right columns.
• Genetic Algorithm Crossing Minimization: Re-orders parallel execution chains to drastically reduce visual line overlaps.
• Pure Node Placement: Places pure math/data nodes cleanly to the left of their consumer execution nodes.
• Comment Box Preservation: Preserves existing comment boxes and their encapsulated node positions.
• Safe Scoped Transactions: Every operation is registered in Unreal's Undo/Redo buffer (Ctrl+Z supported).

   GENETIC GRAPH LAYOUT PASS
   [Pure Math] ────────┐
                       ▼
   [Exec In] ────► [Exec Node] ────► [Next Step]
   (Execution wires aligned horizontally, comments preserved)

---

4. 🎨 Shared Team Themes & Runtime Debugging

• UBlueLineThemeData: Centralized Data Asset stored in /Game/BlueLine/ so whole teams share color palettes without local config discrepancies.
• UBlueLineDebugLib: Static C++ and Blueprint library that renders colored 3D floating debug text matching your editor tag themes in PIE and runtime builds.

---

🧪 Automated Testing Suite

BlueLine Core ships with an integrated automated testing suite featuring 10 unit and regression tests under the BlueLine.Graph.* and BlueLine.SmartTags.* namespaces:

Test Name	Namespace	Description
BasicMetrics	BlueLine.Graph.Analyzer	Node counts, connection tracking, and complexity score calculations.
ClusterDetection	BlueLine.Graph.Analyzer	BFS graph partitioning across isolated logic blocks.
BoundsCalculation	BlueLine.Graph.Analyzer	Validates cluster bounding box computation with Knot 32×32 bounding.
WireCrossings	BlueLine.Graph.Analyzer	Geometric line intersection math with shared-endpoint exclusion.
ExecAlignment	BlueLine.Graph.Formatter	Shift+Q downstream column push and horizontal exec pin Y-alignment.
CyclesAndComments	BlueLine.Graph.Cleaner	Directed cyclic graphs and comment box position locking.
PureNodeFlow	BlueLine.Graph.Cleaner	Left-of-consumer placement for pure nodes and straight exec wires.
KnotCenteringAndPinPos	BlueLine.Graph.Routing	Sub-pixel (NodePosX + 16, NodePosY + 16) knot centering math.
PersistsMetadata	BlueLine.SmartTags.AutoTag	Semantic tag container persistence on generated comment nodes.
RespectsColorSetting	BlueLine.SmartTags.AutoTag	Compliance with Blueprint color edit toggle (bAllowBlueprintColorEdits).

Run tests directly inside Unreal Editor:

Window > Developer Tools > Session Frontend > Automation Tab > BlueLine

---

🏗️ Installation & Setup

1. Clone to Plugins: Clone this repository directly into your project's Plugins directory:

   git clone https://github.com/gregorik/BlueLine.git YourProject/Plugins/BlueLineCore

2. Generate Project Files: Right-click your .uproject file and select Generate Visual Studio Project Files.
3. Compile: Open the solution in Visual Studio / Rider and build for Development Editor.
4. Enable: In Unreal Engine, navigate to Edit > Plugins and confirm BlueLine Core is enabled.

---

🧩 Architecture

graph TD
    classDef core fill:#1E293B,stroke:#38BDF8,stroke-width:2px,color:#F8FAFC;
    classDef graph fill:#1E293B,stroke:#34D399,stroke-width:2px,color:#F8FAFC;
    classDef tags fill:#1E293B,stroke:#F472B6,stroke-width:2px,color:#F8FAFC;

    CoreModule[BlueLineCore Module<br/>PreDefault]:::core
    GraphModule[BlueLineGraph Module<br/>PreDefault]:::graph
    TagsModule[BlueLineSmartTags Module<br/>Default]:::tags

    CoreModule --> GraphModule
    CoreModule --> TagsModule

    subgraph BlueLineCore ["🔷 BlueLineCore (Runtime & Shared Styles)"]
        Settings["⚙️ UBlueLineEditorSettings"]
        Theme["🎨 UBlueLineThemeData Asset"]
        Analyzer["📊 FBlueLineGraphAnalyzer"]
        Utils["🛠️ FBlueLineContextUtils"]
        Debug["🔮 UBlueLineDebugLib (Runtime 3D HUD)"]
    end

    subgraph BlueLineGraph ["🟢 BlueLineGraph (Wire & Layout Engine)"]
        Formatter["🧲 BlueLineFormatter (Shift+Q)"]
        Router["🔀 FBlueLineManhattanRouter (Shift+R)"]
        Cleaner["🧬 FBlueLineGraphCleaner (Shift+C)"]
        Interceptor["⚡ FBlueLineConnectionInterceptor"]
        Snapper["🎯 FBlueLineWireSnapper"]
        Policy["📐 FBlueLineConnectionPolicy"]
    end

    subgraph BlueLineSmartTags ["🟣 BlueLineSmartTags (Visual Semantics)"]
        TagAnalyzer["🏷️ FBlueLineSmartTagAnalyzer (Shift+T)"]
        TagChip["🔖 SBlueLineTagChip (Slate Customization)"]
        TagComment["📦 UBlueLineTagCommentNode"]
        TagCustomization["✨ FBlueLineTagCustomization"]
        MenuExtender["📋 FBlueLineSmartTagMenuExtender (Demo Spawner)"]
    end

Loading

---

📄 License

This open-source core edition of BlueLine is released under the MIT License.

For the full commercial edition with Level Editor Pie Menu, Subsystem Extractor, Graph Exporter, Bookmarks, Snippets, Static Linter, and Wireless Nodes, visit BlueLine on Fab.