NwcIO 0.12.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package NwcIO --version 0.12.1
                    
NuGet\Install-Package NwcIO -Version 0.12.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NwcIO" Version="0.12.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="NwcIO" Version="0.12.1" />
                    
Directory.Packages.props
<PackageReference Include="NwcIO" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add NwcIO --version 0.12.1
                    
#r "nuget: NwcIO, 0.12.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package NwcIO@0.12.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=NwcIO&version=0.12.1
                    
Install as a Cake Addin
#tool nuget:?package=NwcIO&version=0.12.1
                    
Install as a Cake Tool

<p align="center"> <img src="https://raw.githubusercontent.com/IOExtend/NwcIO/main/docs/images/nwcio-banner.png" alt="NwcIO" width="640"> </p>

NwcIO

Docs NuGet Release License: MIT Platform

NwcIO is a fast, 100% managed .NET library and command line tool that reads Autodesk Navisworks cache and document files (.nwc, .nwd, .nwf) directly from disk without Navisworks or the Navisworks API, and exports IFC, glTF, OBJ, HTML, and JSON.

Built clean-room under the IOExtend organization alongside RvtIO and IfcIO.

What it does

  • Reads scene hierarchy, geometry meshes, transforms, GUID tables, and property categories. Materials are decoded from the file on the strict path (name, colour, alpha) and assigned by heuristics only for files not read through their DbCache directory. Element nodes of model files carry the element's export GUID and IFC GlobalId.
  • Exports to standard Industry Foundation Classes (IFC2X3 & compact IFC4), binary glTF 2.0 (.glb), Wavefront OBJ, and structured JSON.
  • Coordinates multi-model federated assemblies with 3D geometric clash detection, proximity clustering, and clash matrix execution.
  • Manages saved viewpoints, dynamic section planes, redlines, selection sets, and search sets with Navisworks XML and buildingSMART BCF 2.1 exchange.
  • Supports 4D TimeLiner construction simulation with Microsoft Project XML (.xml) and Primavera P6 (.xer) exchange, appearance profiling, spatial grids, 3D measurement, and revision comparison.
  • Generates standalone, zero-dependency interactive 3D WebGL HTML viewers (.html) with 6-sided section box, turntable orbit, and viewpoint walkthrough tours.

Install

Install the command line tool:

dotnet tool install --global NwcIO.Cli

Add the library to a .NET project:

dotnet add package NwcIO

The library targets .NET 8 and .NET 10. It uses managed code without native dependencies or Windows-only APIs and supports Windows, Linux, and macOS.

Command line

Export to IFC, glTF GLB, Wavefront OBJ, or JSON:

# Convert to IFC2X3 (default) or modern compact IFC4
nwcio model.nwc model.ifc --ifc-schema IFC4

# Convert to binary glTF 2.0 (with PBR materials and vertex normals)
nwcio model.nwc model.glb

# Export 3D meshes to Wavefront OBJ
nwcio model.nwc model.obj

# Export scene hierarchy and properties to JSON
nwcio model.nwc model.json

Coordinate models, detect clashes, and export BCF:

# Run clash detection across a folder of federated models and export buildingSMART BCF 2.1
nwcio ./models --clash-bcf clashes.bcfzip --clash-tolerance 0.01

# Group detected clashes into proximity clusters while exporting
nwcio ./models --clash-bcf clashes.bcfzip --clash-group proximity --clash-radius 1.0

# Execute multi-discipline clash matrix across a federated folder
nwcio ./models --clash-matrix matrix.json --clash-matrix-md matrix.md --clash-matrix-bcf matrix.bcfzip

# Export standalone 3D WebGL HTML viewer with sectioning and measure tools
nwcio model.nwc --html-viewer viewer.html --grids grids.xml

TimeLiner, viewpoints, search sets, and revision diff:

# Import a 4D schedule, link it to geometry and simulate a specific date
nwcio model.nwc --timeliner-xml schedule.xml --link-timeliner --timeliner-simulate 2026-06-01 --timeliner-csv sim.csv

# Export saved viewpoints and section planes to BCF 2.1 or Navisworks XML
nwcio model.nwc --viewpoints-bcf viewpoints.bcfzip --viewpoints-xml viewpoints.xml

# Compare two model revisions (added, deleted, modified geometry & properties)
nwcio revision.nwc --diff baseline.nwc --diff-json diff.json --diff-bcf diff.bcfzip

Diagnostics and progress go to standard error. Run nwcio --help for the full list of options.

Library

Open a Navisworks document, inspect elements, and export to GLB or IFC:

using NwcIO;
using NwcIO.Model;
using NwcIO.Model.Sets;

// Open document directly from disk
var doc = NwcDocument.Open("model.nwc");

Console.WriteLine($"Source: {doc.FileInfo?.SourcePath}");
Console.WriteLine($"Meshes: {doc.Meshes.Count}, Transforms: {doc.Transforms.Count}");

// Query nodes with a search condition (category, property, operator, value)
foreach (var node in doc.FindNodes(new NwcSearchCondition("Item", "Type", NwcSearchOperator.Equals, "Wall")))
{
    Console.WriteLine($"Node: {node.Name} (Class: {node.Class})");
}

// Export to binary glTF 2.0 and IFC4
doc.SaveGlb("model.glb");
doc.SaveIfc("model.ifc", new NwcIfcExportOptions { SchemaVersion = NwcIfcSchemaVersion.Ifc4 });

Run 3D geometric clash detection between documents:

using NwcIO;
using NwcIO.Model;
using NwcIO.Model.Clash;

var archDoc = NwcDocument.Open("Architecture.nwc");
var mepDoc = NwcDocument.Open("MEP.nwc");

// Federate the models, then run a hard clash test with broad-phase AABB
// and narrow-phase triangle intersection. Exclude pairs inside a single model.
var assembly = NwcAssembly.Create("Federated Model", archDoc, mepDoc);
var test = new NwcClashTest("Architecture vs MEP", NwcClashTestType.Hard, tolerance: 0.01);
test.Rules.Add(NwcClashRule.SameFile()); // Compare elements from different models only.
NwcClashDetector.Run(assembly, test);

Console.WriteLine($"{test.TotalClashCount} clashes detected");

// Group clashes by spatial 3D proximity and export BCF 2.1
NwcClashGrouper.GroupByProximity(test, clusterDistance: 1.5);
NwcClashBcfExporter.Save("Clashes.bcfzip", test);

See the public API for the supported surface and getting started guide for detailed workflows.

NwcIO.Scene (a separate package released with NwcIO, from IOScene 0.1.0 on) converts Navisworks models into IOScene scene documents for viewers and coordination tools; see the scene adapter page for usage and limits.

Documentation

The documentation site with API references and guides is at https://ioextend.github.io/NwcIO/. Ask DeepWiki offers an automatically generated overview of the repository.

Supported files

Reads binary Navisworks Cache (.nwc), Navisworks Document (.nwd), and Navisworks Federated (.nwf) files. Tested against models saved across Navisworks 2016 through 2026. Scene trees of .nwd files with partition nodes are not decoded yet, and linked Revit models (a tree that places one element under two parents) are not supported: open both with BuildSceneTree = false.

Limitations

  • Version 0.12.1 is a preview. The API can evolve before 1.0.
  • Geometry extraction decodes triangle strips, polylines and stored normals from .nwc/.nwd geometry records; point records and quantised positions are not supported.
  • .nwd scene trees with partition nodes are not decoded yet, and linked Revit models (a tree that places one element under two parents) are not supported: open them with BuildSceneTree = false (CLI: --no-tree), also for .nwf federations that reference such files.
  • The .nwc writer stores vertex positions and rotation/translation; it rejects scaled transforms, line meshes and meshes whose triangles differ from the single strip the reader rebuilds over the positions.
  • The reader bounds crafted input: pointer nesting and tree height at most 256, at most 8,388,608 expanded tree nodes and 134,217,728 expanded property and property-tab references (properties from LcOaPartitionProps count toward the property cap), and at most one render vertex or corner per geometry-record byte. Files beyond these limits fail with InvalidDataException.
  • Writing native .nwd files is not supported (export targets native .nwc, open standards: IFC, GLB, OBJ, JSON, HTML, BCF, and Navisworks XML exchange).

Scope and frozen features

NwcIO reads and writes its own format. These extras are frozen: they receive bug fixes only, with no new features or options.

  • HTML viewer, GLB and OBJ export, and IFC export.
  • Clash detection (triangle-level and bounding-box engines), clash grouping, clash matrix, and the HTML clash report.
  • Measure, grids, revision diff, and BCF.
  • TimeLiner schedule import and export, selection and search sets, appearance profiler, mesh clipper, and Navisworks XML exchange. These stay in NwcIO.

Viewing will move to IOViewer through the NwcIO.Scene adapter over the shared IOScene model. Coordination features such as clash, measure, diff, and BCF will move to a planned IOCoord package, and GLB export to a shared GLB writer in a planned IOScene.Formats package. IOCoord and IOScene.Formats are not published yet. The frozen features stay available and are removed no earlier than NwcIO 1.0, and only after a published replacement exists.

Build from source and tests

Use the .NET SDK selected by global.json (currently 10.0.401, with latestFeature roll-forward within the 10.0.x band).

From the repository root:

dotnet build NwcIO.slnx -c Release
dotnet test

Contributing

See CONTRIBUTING.md. Release changes are recorded in CHANGELOG.md.

Security

Report vulnerabilities through GitHub private vulnerability reporting in the repository's Security tab. Do not open public issues for security vulnerabilities. See SECURITY.md.

License and trademarks

NwcIO is licensed under the MIT License. Copyright holder: mahach666.

NwcIO is not affiliated with, endorsed by or sponsored by Autodesk. Autodesk and Navisworks are trademarks of Autodesk, Inc.

The file format is read by analysing binary streams for interoperability. No Autodesk code or binaries are included.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net10.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on NwcIO:

Package Downloads
NwcIO.Scene

Turns a Navisworks model read by NwcIO into an IOScene scene document in metres: the selection tree, element GUIDs and IFC GlobalIds, property tabs, geometry with instancing, file colours and Revit levels and grids.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.17.0 132 11/20/2026
0.16.0 117 11/19/2026
0.15.1 109 11/19/2026
0.15.0 106 11/19/2026
0.14.0 144 11/18/2026
0.13.0 353 11/17/2026
0.12.1 605 11/15/2026
0.12.0 96 11/14/2026
0.11.0 98 11/13/2026
0.10.0 104 11/11/2026
0.9.0 87 11/10/2026
0.8.0 83 11/10/2026
0.7.0 87 11/10/2026
0.6.0 95 11/10/2026
0.5.0 81 11/10/2026
0.4.0 96 11/10/2026
0.3.0 96 11/10/2026
0.2.0 90 11/10/2026
0.1.1 83 11/10/2026
0.1.0 88 11/10/2026