Asset Nexus Documentation

Una libreria completa e organizzata di asset per Unreal Engine, con sistema di catalogazione avanzato, preview in tempo reale e integrazione diretta con l’editor. Perfetto per accelerare il processo di sviluppo e prototipazione.

Asset Nexus Documentation

Panoramica

Asset Nexus è un potente plugin per Unreal Engine 5.6 sviluppato da DotLabs Studios che rivoluziona la gestione e condivisione degli asset tra progetti. Il plugin permette di creare, organizzare e migrare collezioni di asset utilizzando il sistema nativo di migrazione di Unreal Engine, con supporto per sincronizzazione cloud tramite Google Drive, OneDrive e Nextcloud.

Caratteristiche Principali

Funzionalità Core

Migrazione Asset Intelligente: Utilizza il sistema nativo di Unreal Engine per migrare asset con tutte le dipendenze

Gestione Collezioni: Crea e organizza collezioni di asset con metadati ricchi

Sincronizzazione Cloud: Supporto nativo per Google Drive, OneDrive e Nextcloud

Sistema di Tag: Organizza le collezioni con un sistema di tag flessibile

Anteprima Thumbnail: Genera automaticamente thumbnail per le collezioni

Filtri Avanzati: Filtra collezioni per sviluppatore, tag e contenuto

Interfaccia Intuitiva: UI integrata nell’editor di Unreal Engine

Caratteristiche Tecniche

Compatibilità: Unreal Engine 5.6+

Tipo: Editor Plugin

Categoria: Asset Management

Architettura: Modulo C++ con interfaccia Slate

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 Libreria

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

File di Configurazione

1. AssetNexusLocalSettings.json (Locale):

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

2. GlobalSettings.json (Condiviso):

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

3. 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