Documentazione di Asset Nexus

Panoramica

Asset Nexus è un potente plugin per Unreal Engine 5.6 sviluppato da DotLabs Studios che rivoluziona completamente la gestione e la condivisione degli asset tra progetti diversi.

Il plugin ti permette di:

• Creare e organizzare collezioni di asset in modo strutturato
• Migrare asset con tutte le dipendenze utilizzando il sistema nativo di migrazione di Unreal Engine
• Sincronizzare automaticamente le tue collezioni tramite servizi cloud popolari:
  • Google Drive
  • OneDrive
  • Nextcloud

Asset Nexus unisce la potenza del motore Unreal con un layer di organizzazione e collaborazione cloud, rendendo semplice e sicuro il passaggio di asset tra progetti, team e versioni diverse dell’editor.

Caratteristiche Principali

Funzionalità Core

• Migrazione Asset Intelligente
  Sfrutta il sistema nativo di migrazione di Unreal Engine per trasferire asset includendo automaticamente tutte le dipendenze necessarie, senza lasciare nulla indietro.
• Gestione Collezioni
  Crea e organizza collezioni di asset strutturate, arricchite con metadati completi (nome, autore, descrizione, data creazione/modifica, ecc.).
• Sincronizzazione Cloud Nativa
  Supporto integrato e diretto per:
  • Google Drive
  • OneDrive
  • Nextcloud
    Le collezioni vengono sincronizzate automaticamente nella cartella scelta, pronte per il lavoro multi-dispositivo o di team.
• Sistema di Tag Flessibile
  Assegna tag personalizzati alle collezioni per categorizzarle in modo rapido e coerente (es. “Environment”, “Character”, “Modular”, “Sci-Fi”).
• Anteprima Thumbnail Automatica
  Genera automaticamente miniature visive per ogni collezione:
  • Cattura dal viewport 3D
  • Oppure caricamento manuale di un’immagine personalizzata
    Facilita il riconoscimento rapido nella libreria.
• Filtri Avanzati
  Trova esattamente ciò che cerchi grazie a filtri potenti:
  • Per sviluppatore/autore
  • Per tag
  • Per contenuto/nome/descrizione
    Ricerca full-text inclusa.
• Interfaccia Intuitiva
  UI completamente integrata nell’editor di Unreal Engine, accessibile dalla toolbar o dal menu Window → Asset Nexus.
  Design pulito e familiare, zero curva di apprendimento eccessiva.

Caratteristiche Tecniche

• Compatibilità → Unreal Engine 5.6 e versioni successive
• Tipo → Editor Plugin
• Categoria → Asset Management
• Architettura → Modulo C++ con interfaccia utente realizzata in Slate

Queste funzionalità rendono Asset Nexus uno strumento essenziale per chi lavora con asset condivisi, versioni multiple di Unreal Engine o team distribuiti.

Installazione

Requisiti di Sistema

• Unreal Engine 5.6 o superiore
• Windows 10/11 (supporto per altre piattaforme in sviluppo)
• Spazio su disco: minimo 100MB per il plugin + spazio per la libreria asset

Installazione del Plugin

1. Download e Installazione:
   • Scarica il plugin da Fab Marketplace
   • Estrai il contenuto nella cartella Plugins del tuo progetto
   • Riavvia Unreal Engine
2. Attivazione:
   • Apri il tuo progetto in Unreal Engine
   • Vai su Edit > Plugins
   • Cerca “Asset Nexus” nella categoria “Asset Management”
   • Attiva il plugin e riavvia l’editor
3. Verifica Installazione:
   • Cerca l’icona di Asset Nexus nella toolbar principale
   • Il plugin dovrebbe apparire nel menu Window > Asset Nexus

Configurazione Iniziale

Impostazioni Base

1. Apertura Pannello Impostazioni:
   • Clicca sull’icona Asset Nexus nella toolbar
   • Seleziona la tab “Settings”
2. Configurazione Percorsi:
   • Asset Nexus Library Path: Imposta il percorso della libreria asset
   • Default Developer Name: Imposta il tuo nome sviluppatore predefinito

Configurazione File Mirroring

Asset Nexus supporta la sincronizzazione automatica tramite servizi cloud.
Configura uno dei seguenti servizi:

Setup Google Drive (File Mirroring)

Prerequisiti

• Account Google Drive attivo
• Google Drive Desktop installato e configurato

Configurazione

1. Installazione Google Drive Desktop
   • Scarica Google Drive Desktop da: https://www.google.com/drive/download/
   • Installa e accedi con il tuo account Google
   • Configura la sincronizzazione per la cartella desiderata
2. Configurazione Asset Nexus
   • Apri Asset Nexus Settings
   • Imposta “Asset Nexus Library Path” su una cartella dentro Google Drive:
     C:\Users\[Username]\Google Drive\AssetNexus
   • Salva le impostazioni
3. Verifica Sincronizzazione
   • Crea una collezione di test
   • Verifica che appaia nella cartella Google Drive
   • Controlla la sincronizzazione su altri dispositivi

Vantaggi Google Drive

• ✅ Sincronizzazione automatica in tempo reale
• ✅ Condivisione facile con team
• ✅ 15GB gratuiti (espandibile)
• ✅ Accesso da qualsiasi dispositivo

Setup OneDrive (File Mirroring)

Prerequisiti

• Account Microsoft/OneDrive attivo
• OneDrive Desktop sincronizzato

Configurazione

1. Configurazione OneDrive
   • OneDrive è preinstallato su Windows 10/11
   • Accedi con il tuo account Microsoft
   • Configura le cartelle da sincronizzare
2. Configurazione Asset Nexus
   • Apri Asset Nexus Settings
   • Imposta “Asset Nexus Library Path” su una cartella OneDrive:
     C:\Users\[Username]\OneDrive\AssetNexus
   • Salva le impostazioni
3. Ottimizzazione Prestazioni
   • Abilita “Files On-Demand” per risparmiare spazio
   • Configura la sincronizzazione selettiva per cartelle grandi

Vantaggi OneDrive

• ✅ Integrazione nativa Windows
• ✅ Files On-Demand per gestione spazio
• ✅ Sincronizzazione veloce
• ✅ 5GB gratuiti (espandibile fino a 5TB)
• ✅ Condivisione e collaborazione integrate

Setup Nextcloud (File Mirroring)

Prerequisiti

• Server Nextcloud configurato (self-hosted o provider)
• Nextcloud Desktop Client

Configurazione

1. Installazione Nextcloud Desktop
   • Scarica da: https://nextcloud.com/install/#install-clients
   • Installa il client desktop
   • Configura la connessione al tuo server Nextcloud
2. Configurazione Sincronizzazione
   • Crea una cartella dedicata “AssetNexus” su Nextcloud
   • Configura la sincronizzazione locale:
     C:\Users\[Username]\Nextcloud\AssetNexus
3. Configurazione Asset Nexus
   • Apri Asset Nexus Settings
   • Imposta “Asset Nexus Library Path” sul percorso Nextcloud:
     C:\Users\[Username]\Nextcloud\AssetNexus
   • Salva le impostazioni
4. Configurazioni Avanzate
   • Abilita la sincronizzazione in tempo reale
   • Configura le esclusioni per file temporanei
   • Imposta la bandwidth limit se necessario

Vantaggi Nextcloud

• ✅ Controllo completo dei dati (self-hosted)
• ✅ Privacy e sicurezza massime
• ✅ Nessun limite di storage (dipende dal server)
• ✅ Sincronizzazione end-to-end encrypted
• ✅ Condivisione granulare e controllo accessi
• ✅ Integrazione con workflow aziendali

Guida all'Utilizzo

Creazione di una Collezione Asset

1. Selezione Asset:
   • Nel Content Browser, seleziona gli asset da migrare
   • Click destro e seleziona “Send to Asset Nexus”
   • Oppure apri Asset Nexus e usa la tab “Migrator”
2. Configurazione Metadati:
   • Collection Name: Nome univoco per la collezione
   • Author: Nome dell’autore (precompilato dalle impostazioni)
   • Description: Descrizione dettagliata della collezione
   • Tags: Tag per categorizzare la collezione
3. Generazione Thumbnail:
   • Capture from Viewport: Cattura screenshot dal viewport 3D
   • Load from File: Carica un’immagine personalizzata
   • Il thumbnail aiuta nell’identificazione visiva
4. Migrazione:
   • Clicca “Migrate” per completare il processo
   • Il plugin copierà tutti gli asset e dipendenze
   • Verrà creato un file metadata.json con tutte le informazioni

Importazione di Collezioni

1. Navigazione Libreria:
   • Apri la tab “Browser” in Asset Nexus
   • Naviga tra le collezioni disponibili
   • Usa i filtri per trovare collezioni specifiche
2. Filtri Disponibili:
   • Search Box: Ricerca per nome o descrizione
   • Tag Filters: Filtra per tag specifici
   • Developer Filter*: Filtra per sviluppatore
   • Thumbnail Size: Regola la dimensione delle anteprime
3. Importazione:
   • Seleziona la collezione desiderata
   • Clicca “Import Collection”
   • Gli asset verranno importati nel progetto corrente

Gestione Tag

1. Locali:
   • Salvati nel file di configurazione locale
   • Specifici per ogni installazione
2. Tag Globali:
   • Condivisi tramite la libreria cloud
   • Sincronizzati tra tutti i membri del team
3. Best Practices:
   • Usa tag descrittivi e consistenti
   • Crea una convenzione di naming per il team
   • Esempi: “Environment”, “Character”, “Weapon”, “UI”

Struttura File e Cartelle

Organizzazione della libreria

AssetNexus/
├── CollectionName1/
│   ├── metadata.json
│   ├── thumbnail.png
│   └── Content/
│       ├── Assets/
│       └── Dependencies/
├── CollectionName2/
│   ├── metadata.json
│   ├── thumbnail.png
│   └── Content/
└── GlobalTags.json

File di Configurazione

AssetNexusLocalSettings.json (locale)

{
    "AssetLibraryRoot": "C:/Users/Username/GoogleDrive/AssetNexus",
    "DefaultDeveloperName": "YourName",
    "ClearCollectionListOnSuccessfulMigration": true,
    "SavedTags": ["Environment", "Character", "Weapon"]
}

GlobalSettings.json (condiviso)

{
    "LibraryPath": "C:/SharedLibrary/AssetNexus"
}

metadata.json (per collezione)

{
    "Author": "DeveloperName",
    "CollectionName": "MyAssetPack",
    "Description": "Collection description",
    "Tags": ["Environment", "Medieval"],
    "CreationDate": "2024-01-15T10:30:00Z",
    "LastModified": "2024-01-15T10:30:00Z",
    "ObjectsInCollection": ["/Game/Assets/Mesh1", "/Game/Assets/Material1"]
}

Risoluzione Problemi

Problemi Comuni

1. Plugin non si carica:
   • Verifica compatibilità con UE 5.6+
   • Controlla che il plugin sia nella cartella corretta
   • Ricompila il progetto se necessario
2. Percorso libreria non trovato:
   • Verifica che il percorso esista e sia accessibile
   • Controlla i permessi della cartella
   • Assicurati che il servizio cloud sia sincronizzato
3. Migrazione fallisce:
   • Controlla che gli asset siano salvati
   • Verifica spazio su disco disponibile
   • Controlla i log di Unreal Engine per errori specifici
4. Sincronizzazione cloud lenta:
   • Verifica la connessione internet
   • Controlla le impostazioni di bandwidth del client cloud
   • Considera l’uso di sincronizzazione selettiva

Log e Debug

Asset Nexus utilizza il sistema di logging di Unreal Engine:

• Categoria: LogAssetNexus
• Livelli: Log, Warning, Error
• Visualizza in: Output Log window

Asset Nexus

La pagina di Asset Nexus: cosa fa, gli screenshot e dove trovarlo.