Asset Inventory Pipeline

On This Page

• Overview
• Prerequisites
• Step 1: Organize Fab Downloads
• Step 2: Scan Projects into Neo4j
• Step 3: Search the Inventory
• Step 4: Showcase Assets
• Step 5: Migrate Assets
• Neo4j Schema Reference
• Troubleshooting

Overview

The Asset Inventory Pipeline connects your Fab downloads to a Neo4j knowledge graph, enabling natural language asset discovery through Claude Code. Instead of manually browsing Content Browser folders across dozens of projects, ask Claude to "find all vegetation meshes" or "show me what's in my ArchViz collection".

Fab.com ──download──▶ UE Category Projects ──scan──▶ Neo4j (FabAsset nodes)
                                                          │
                    UE Editor ◀──spawn showcase──◀ Claude Code / MCP Tools
                         │                                │
                    editor.asset.migrate ◀──search──◀ search_inventory_assets

Prerequisites

Step 1: Organize Fab Downloads

Create one UE project per asset category. This keeps projects manageable and categories clean.

D:/FabCatalog/
├── ArchVizInteriors/         # Architecture & interior packs
├── CityParkEnvironment/      # Outdoor environment pack
├── QuixelTrees/              # Megascans vegetation
├── NatureVegetation/         # Other vegetation
└── UrbanModern/              # Urban/modern assets

Download asset packs from Fab.com, then use the Epic Games Launcher to add them to the appropriate category project.

Step 2: Scan Projects into Neo4j

UE Project Scan (full metadata)

With the editor running and the target project open:

python scan_ue_project.py --project-name "CityParkEnvironment" --show-progress

StaticMesh assets are automatically enriched with triangle count, vertex count, LOD count, and Nanite status.

USD Scan (no editor needed)

For USD/USDZ files from Fab (common for Megascans):

python scan_usd_assets.py --source-dir "D:/FabCatalog/QuixelTrees/Content" \
    --project-name "QuixelTrees" --show-progress

Step 3: Search the Inventory

Via Claude Code

With the AgentUX MCP server running, use natural language prompts:

• "Find all vegetation StaticMeshes across my projects"
• "What's in the CityParkEnvironment project?"
• "Show me asset inventory stats"
• "List all categories with counts"

Claude uses five MCP tools behind the scenes:

Via Direct Cypher

For advanced queries, use Neo4j Browser:

// Find vegetation meshes with high triangle counts
MATCH (a:FabAsset)-[:IN_CATEGORY]->(:AssetCategory {name: 'vegetation'})
WHERE a.className ENDS WITH 'StaticMesh' AND a.triangles > 10000
RETURN a.name, a.unrealPath, a.triangles
ORDER BY a.triangles DESC LIMIT 20

Step 4: Showcase Assets

Spawn matching assets in the editor as a walkable grid for visual browsing:

python showcase_assets.py --project-name "CityParkEnvironment" --show-progress

Assets are grouped by name affinity (SM_Wall_01, SM_Wall_02 appear together), sorted by size within each group (smallest in front, largest in back), and separated by group gaps for easy visual scanning.

Step 5: Migrate Assets Between Projects

Once you've found assets, migrate them into your working project via AgentUX JSON-RPC:

// List dependencies
{"method": "editor.asset.listDependencies", "params": {
  "asset_path": "/Game/Meshes/SM_Bench01", "include_soft": true
}}

// Migrate with dependencies
{"method": "editor.asset.migrate", "params": {
  "packages": ["/Game/Meshes/SM_Bench01"],
  "destination": "D:/UnrealProjects/MyGame/Content",
  "include_dependencies": true
}}

Neo4j Schema Reference

Node Labels

FabAsset Properties

Troubleshooting

Neo4j connection refused

Start Neo4j. On Windows: neo4j console or start the Neo4j Desktop app.

Editor not reachable (port 9877)

Open UE Editor with your project, enable the AgentUX plugin (Edit > Plugins > search "AgentUX"), and restart the editor. Verify with netstat -an | grep 9877.

Auth token required

Scripts auto-resolve tokens from the credential file at <Project>/Saved/AgentUX/.creds/mcp_auth or the OS keyring. Set the token in the AgentUX Settings panel if missing.

Empty scan results

The scanner queries the live Asset Registry. Ensure the project is actually open in the editor and assets are loaded.

Showcase spawns nothing

Verify the project has StaticMesh entries in Neo4j: python showcase_assets.py --project-name "MyProject" --dry-run

See Docs/FAB_INVENTORY_GUIDE.md in the plugin distribution for the complete reference including additional Cypher query examples.