View on Asset Store (opens in new tab)
Package details
- Latest version
- 1.2
- Last updated
- First released
- Unity version
- 6000.3.8 or later
- Package size
- 1.6 MB
- Files
- 203
- Views in the past week
- 7
Price tracking
- Last checked
- Tracked since
- Lowest recorded
- $10.50 on
Keywords
JSON Data Importer — Configurable Import Pipeline
Import JSON data into ScriptableObject assets with a safe, inspectable pipeline. Previews field-level diff, validates data, captures backup snapshots before apply, and supports CI batch runs.
Affiliate link · Purchases support this site
Price history
Last 6 months
USDAsset preview
1 / 7
JSON Data Importer — Configurable Import Pipeline screenshot 1
About this asset
Game projects accumulate data that lives outside Unity: balance tables, quest configs, localization documents, item databases. Keeping ScriptableObject assets in sync with that data by hand is error-prone and slow. Json Data Importer gives this process a structured, inspectable pipeline with one clear entry point.
For simple cases, setup takes minutes. Annotate your ScriptableObject with and mark the collection or document field with or . The importer discovers the target automatically, selects a compatible parser, and wires up validators and diff. No boilerplate, no manual registry calls.[ImportTargetMetadata][ImportTargetCollection][ImportTargetDocument]
Preview before you apply. Every run starts by building a full preview: source is parsed, entries are validated, and a field-level diff against the current asset is computed — before anything is written. You see exactly which records will be added, updated, removed, or left unchanged.
Apply is safe by design. A backup snapshot of the current target entries is captured before each apply. If something goes wrong, restore is one button press. Fingerprint-based incremental skip means unchanged assets are never touched unnecessarily — important when dozens of configs run in CI.
The pipeline is fully extensible. Every stage has a public interface: source provider, parser, validator, diff engine, fingerprint builder, apply strategy, target adapter, and backup codec. Replace any stage independently, or add a custom source provider for HTTP, Google Sheets, or generated content without touching the rest of the pipeline.
Batch and CI are first-class citizens. A single CLI entry point — — handles single configs, all configs in a folder, or a predefined execution config by id. Reports are written in JSON and plain text. Exit codes map cleanly to CI success/failure conditions.JDI.Run
The tool is designed for teams that import game data regularly and need predictable, reviewable results without writing infrastructure from scratch each time.
From the publisher's Asset Store listing.
Technical details
Technical Details
Auto import path
- Automatic discovery of targets via ScriptableObject[ImportTargetMetadata]
- Auto adapters for list (), document (), and direct-fields target shapes[ImportTargetCollection][ImportTargetDocument]
- Auto JSON parser with , keyed to target type idJsonUtility
- One-click fill in the inspector for profile, parser, validators, diff engine, and apply strategyAuto
Preview and validation
- Full preview pipeline before any asset is mutated: parse → validate → diff
- Field-level diff with added/updated/removed/unchanged counts
- Built-in structure and reference validators; custom per project rulesIImportValidator
- Parser diagnostics surfaced alongside validation messages
Safe apply and backup
- Backup snapshot captured before every apply, stored in assetImportBackupHistory
- Restore latest backup with a single editor action, backed by Undo
- Configurable limit per configmaxBackupHistory
- Apply is blocked before target mutation when backup capture fails
Incremental skip
- Canonical SHA-256 fingerprints for source and target
- Apply is skipped automatically when source, target, profile, and apply strategy all match the last successful state
- lastApplied* state stored per config; cleared automatically when fingerprints cannot be confirmed
Execution policy
- ImportExecutionProfile asset controls backup, validation fail behavior, fingerprinting, and incremental skip
- Three-level priority: job definition override → execution profile → default true
- Preview, , and modes available from inspector and CLIValidateApply
Extension points
- IImportSourceProvider — custom data sources (HTTP, Google Sheets, generated content)
- IImportParser / IImportParser<T> — custom source formats (CSV, YAML, complex JSON)
- IImportTargetAdapter — custom target read/write for non-standard asset shapes
- IImportProfile — bundles target id, entry type, adapter, codec, and default apply strategy
- IImportValidator — project-specific validation rules
- IImportDiffEngine — custom field comparison and diff display
- IImportFingerprintBuilder — custom canonical fingerprint for incremental skip
- IImportApplyStrategy — replace, merge, patch, append, or fully custom merge logic
- IImportBackupCodec — custom backup serialization format
- IImportReferenceLookupProvider — cross-target reference validation
Batch and CI
- JDI.Run CLI entry point for Unity batch mode
- Run by execution config id, asset path, single config, or all configs in project
- Folder filter for scoped runs
- JSON and plain-text reports with per-job diagnostics
- Dependency ordering across configs in a batch run
- Exit codes: success, validation failure, runtime/config failure 0 2 3
Compatibility
| Unity version | Built-in | URP | HDRP | Custom |
|---|---|---|---|---|
| 6000.3.8f1 | Compatible | Compatible | Compatible | Compatible |
As listed on the Asset Store.