Getting Started with DataLoom Pro

This guide outlines the core pipeline concepts of DataLoom Pro, focusing on advanced features like background file sync, nested bindings, and two-pass cross-linking.

Pro Core Pillars

DataLoom Pro expands on the basic blueprint mapping with three advanced automation layers:

1. Live File Sync (Auto-Watch)

  • DataLoom Pro runs a background directory watcher service (FileWatchService).
  • When you edit and save your sheets externally (e.g. inside Microsoft Excel), the watcher debounces the event and schedules an main-thread asset re-import automatically.
  • Designers work entirely in Excel, and engineers immediately see updated ScriptableObjects without manually importing files.

2. Two-Pass Circular Reference Resolver

  • When one ScriptableObject references another (e.g. a CharacterData object holds a reference to a WeaponData object), a basic importer fails because the weapon asset might not exist yet during parsing.
  • DataLoom Pro executes a two-pass indexing pass:
    • Pass 1: Instantiates all ScriptableObjects and populates standard variables (strings, ints, vectors).
    • Pass 2: Resolves SO-to-SO linking columns, finding target assets using database queries and binding references dynamically.

3. Nested Type Binder

  • Support for custom structures and collections. You can bind columns containing nested JSON configurations (like subclass metrics) directly into C# classes.

Next Steps

Review the Installation Guide to add the package to your project.

This site uses Just the Docs, a documentation theme for Jekyll.