ZFORGE · TOPOGUARD · MMXXVI
TOPOLOGY · SAFETY · REAL-TIME

TOPOGUARD

Real-time topology safety, at 10 Hz.

Continuous mesh-health vigilance while you sculpt — n-gons, poles, non-manifold edges, flagged the instant they appear.

MIT LICENSE BLENDER 4.0+ 10 HZ MONITOR

FREE · NAME YOUR PRICE

§ 01 / 02

What ships

TopoGuard — Gumroad Product Listing

Product Name

TopoGuard — Real-Time Topology Safety for Blender

Price

$0+ (Name Your Price / Free)

Thumbnail

Use nostromo-deep/topology/topo-check.svg on #070809 background with "TOPOGUARD" in abyss teal (#2A6B6B).

Short Description

Real-time topology checker that highlights non-manifold edges, self-intersections, and curvature spikes as colored overlays in Blender's viewport. Four independent safety checks running at 10Hz. Never ship a broken mesh again.

Full Description

What it does

TopoGuard watches your mesh while you model, running four independent topology checks every 100ms:

Self-Intersection Detection (Red overlay) Finds places where your mesh folds through itself — non-adjacent faces closer than a configurable threshold. Uses spatial hashing for O(N*k) performance instead of brute-force O(N^2). Works on meshes up to 100K vertices without viewport lag.

Curvature Spike Alert (Orange overlay) Highlights vertices where curvature exceeds your threshold — degenerate corners, pinched edges, collapsed faces. Uses vectorized angle-defect computation (147x faster than per-vertex Python loops).

Gauss-Bonnet Violation (Yellow overlay) Checks that your mesh's total curvature matches its expected topology. A sphere should integrate to 4pi. A torus to 0. When the integral doesn't match, something is topologically wrong — even if it looks fine visually.

Pinch-Off Warning (Blue overlay) Detects thin bridges where medial distance drops below threshold AND curvature is high — geometry that's about to break under subdivision or deformation.

How to use it

  1. Install the addon (Edit > Preferences > Add-ons > Install from File)
  2. Enter Edit Mode on any mesh
  3. Open the N-Panel > ZForge > TopoGuard
  4. Toggle "Live Mode" — hazards appear as colored overlays instantly
  5. Click "Validate" for a full report with hazard counts and locations

What's under the hood

Built on zforge-core, the open-source geometry intelligence library (pip install zforge-core). The same math engine powers all ZForge products — topology safety, conformal parameterization, spectral analysis.

  • Pure NumPy — no compiled extensions, no CUDA, no external binaries
  • 4 curvature estimators with MAD outlier rejection
  • SpatialHash for O(N*k) proximity queries
  • Composite safety gate (topology + conformal + spectral)
  • 120 tests passing

Requirements

  • Blender 4.0+
  • Python 3.10+ (ships with Blender)
  • No additional dependencies (NumPy included with Blender)

Changelog

v0.1.0 — Initial release

  • 4-check topology safety gate
  • Live viewport overlay at 10Hz
  • N-Panel with hazard counts
  • Vectorized Gaussian curvature (147x speedup)

Tags

blender, addon, topology, mesh-validation, 3d-modeling, retopology, quality-check

File

topoguard-v0.1.0.zip (Blender addon zip)


SpectralMesh Analyzer — Gumroad Product Listing

Product Name

SpectralMesh Analyzer — Mesh Quality Scoring for Blender

Price

$0+ (Name Your Price / Free)

Short Description

Objective mesh quality scoring via Laplacian eigenspectrum analysis. 0-100 score, spectral gap, eigenvalue decay, Euler validity. Blender N-Panel + CLI for batch processing.

Full Description

What it does

SpectralMesh computes your mesh's Laplacian eigenspectrum — the mathematical fingerprint that captures global shape independent of vertex count or tessellation. From those eigenvalues, it derives three metrics:

Spectral Gap (40 points) How well-separated are your mesh's topological features? A high spectral gap means clean, distinct geometric regions. A low gap means muddled, entangled topology.

Eigenvalue Decay Regularity (30 points) How smoothly does geometric detail distribute across scales? Regular decay = clean subdivision-ready mesh. Irregular decay = problematic geometry at specific frequencies.

Euler Characteristic Validity (30 points) Does the topology make mathematical sense? Closed manifold? Correct genus? Consistent orientation?

The three combine into a 0-100 quality score:

  • 85+ : Production-ready subdivision surface
  • 60-84 : Workable, some cleanup needed
  • 30-59 : Significant topology issues
  • <30 : Broken — boolean residue, non-manifold, degenerate

CLI Mode


python -m spectralmesh analyze model.obj

Output:


{
  "score": 82,
  "spectral_gap": 0.342,
  "decay_regularity": 0.78,
  "euler_valid": true,
  "eigenvalues": [0.0, 0.342, 1.12, 2.87, ...]
}

Batch an entire asset library:


python -m spectralmesh analyze ./models/*.obj --output scores.json

Requirements

  • Blender 4.0+ (addon mode)
  • Python 3.10+ with scipy (CLI mode)
  • pip install zforge-core for CLI

Tags

blender, mesh-quality, spectral-analysis, eigenspectrum, batch-processing, quality-score


ConformalUV — Gumroad Product Listing

Product Name

ConformalUV — Conformal UV Unwrapping for Blender

Price

$29

Short Description

True conformal UV unwrapping via Boundary-First Flattening. Orthogonal grid lines in UV space that follow your mesh's natural edge flow. Yamabe distortion visualization shows exactly where to place seams.

Full Description

Why conformal matters

Standard UV unwrapping (LSCM, ABF++) minimizes distortion but doesn't guarantee orthogonality. ConformalUV uses Boundary-First Flattening — the same algorithm used in academic geometry processing research — to compute parameterizations where the Cauchy-Riemann equations hold exactly.

The result: UV grid lines that are perpendicular everywhere. Textures align with edge flow. Checker patterns stay square. Seams go where mathematics says they should, not where a heuristic guessed.

Features

  • BFF Solver: Cotangent-weight discrete Laplacian with Cherrier boundary conditions
  • Yamabe Distortion: Solve delta(u) = -K to quantify distortion per-vertex. Red = high distortion (add a seam here). Green = low distortion (leave it alone).
  • Conformal Isoline Preview: Toggle a ghost overlay showing where the UV grid maps onto your surface. These ARE the ideal edge loops.
  • Automatic Boundary Detection: Identifies mesh boundaries and island borders for BFF input.
  • Mobius Composition: Conformal transforms compose losslessly — no floating-point drift from repeated operations.

The math

The core equation: partial_n(u) = kappa - e^u * kappa_tilde

Where kappa is the boundary geodesic curvature and kappa_tilde is the target curvature. BFF solves this to find the conformal factor u that maps your mesh to the target domain with minimal angle distortion.

Requirements

  • Blender 4.0+
  • scipy (for sparse linear algebra)
  • zforge-core (included)

Tags

blender, uv-unwrapping, conformal, bff, parameterization, texturing, uv-mapping


QuadFlow Preview — Gumroad Product Listing

Product Name

QuadFlow Preview — Retopology Guide Overlay for Blender

Price

$19

Short Description

See where the ideal quad edge loops would go — before you cut a single edge. Conformal isoline ghost overlay on your mesh surface. Toggle with G, adjust density with a slider.

Full Description

See the invisible geometry

Every smooth surface has an inherent quad structure hiding inside it — determined by its conformal parameterization. QuadFlow makes that structure visible.

Press G to toggle the overlay. Blue lines appear on your mesh surface showing where mathematically optimal edge loops would go. Where lines bunch together, curvature is high. Where they spread, the surface is flat. The density slider controls how many isolines appear (8-20 typically).

Use cases

  • Manual retopology guide: See where to place edge loops before starting retopo
  • Boolean cleanup planning: Understand which regions need the most attention
  • Subdivision surface validation: Verify that your edge flow follows natural curvature
  • Teaching tool: Visualize the relationship between curvature and quad density

How it works

  1. BFF computes a conformal (u,v) parameterization per polygroup island
  2. Regular grid lines at u = k/n and v = k/n for k = 0..n are the isolines
  3. These lines are mapped back to the 3D surface via the inverse parameterization
  4. GPU draws them as a blue overlay on top of the mesh

The lines are not random. They are not heuristic. They are the mathematical consequence of the Cauchy-Riemann equations applied to your specific surface.

Requirements

  • Blender 4.0+
  • scipy (for BFF solver)
  • zforge-core (included)

Tags

blender, retopology, quad-flow, isoline, conformal, edge-loops, visualization

See also

  • [[ZFORGE_ECOSYSTEM_OVERVIEW]] (shared: curvature, mesh, node-ledger, spectral-analysis, subdivision-surface)
  • [[TOOL_APPLICATIONS_SYNTHESIS]] (shared: boundary-condition, node-ledger, spectral-analysis, subdivision-surface, uv-unwrap)
  • [[ZFORGE_HOLY_GRAIL_COMPLETION_HANDOFF]] (shared: boundary-condition, node-ledger, spectral-analysis, uv-unwrap)
  • [[ZFORGE_PRODUCT_REPORT]] (shared: boundary-condition, node-ledger, spectral-analysis, uv-unwrap)
  • [[MATHEMATICAL_COMPILER]] (shared: boundary-condition, node-ledger, spectral-analysis, uv-mapping)
  • [[LANDING_PAGE_COPY]] (shared: node-ledger, spectral-analysis, topology, uv-unwrap)
  • [[COGNITIVE_CAD_MANIFESTO]] (shared: boundary-condition, node-ledger, spectral-analysis, uv-unwrap)
  • [[ZFORGE_SWISS_ARMY_KNIFE_ROADMAP]] (shared: node-ledger, spectral-analysis, topology, uv-unwrap)

<!-- NODE_LEDGER --> node_id: "topoguard_listing" created: "2026-03-28" last_activated: "2026-03-28" activation_count: 0 keyword_trace: {} centroid_keywords: ["topoguard", "topology", "curvature", "mesh", "overlay", "boundary-condition", "node-ledger", "spectral-analysis", "subdivision-surface", "uv-mapping"] related_docs: ["ZFORGE_ECOSYSTEM_OVERVIEW.md", "TOOL_APPLICATIONS_SYNTHESIS.md", "ZFORGE_HOLY_GRAIL_COMPLETION_HANDOFF.md", "ZFORGE_PRODUCT_REPORT.md", "MATHEMATICAL_COMPILER.md", "LANDING_PAGE_COPY.md", "COGNITIVE_CAD_MANIFESTO.md", "ZFORGE_SWISS_ARMY_KNIFE_ROADMAP.md"] <!-- /NODE_LEDGER -->

§ 02 / 02

Get it

Primary
Gumroad
Staged. Awaiting Gumroad UI step + GUMROAD_API_TOKEN push.
▸ DRAFT Gumroad store →
Free + Open
zforge-core
Same math substrate. MIT-licensed Python package.
▸ Live · pip install pypi →
DCC marketplace
Unreal · ArtStation
Planned MotionMacro pack + reference frames.
Coming soon Watch this space