Questo e un riepilogo ad alto livello delle capacita principali del plugin. Per un elenco piu dettagliato delle funzionalita attualmente disponibili puoi consultare l’elenco esteso delle funzionalita.

Riepilogo delle Funzionalita (A Colpo d’Occhio)

Questa e una panoramica ad alto livello delle funzionalita principali.

• Architettura e Analisi Universale degli Asset: Genera, modifica, refactoring e ottieni spiegazioni dettagliate per Blueprint, Material, Behavior Tree, Animation Blueprint e Widget Blueprint. Esporta qualsiasi riepilogo su disco per la documentazione.
• Gestione Progetti e Asset: Crea nuovi asset al volo, inclusi Struct, Enum, Blueprint e cartelle, direttamente da un prompt.
• Regia della Scena in Tempo Reale: Spawna, seleziona e manipola actor direttamente nel viewport del livello con comandi conversazionali. (Sperimentale)
• Design UI Conversazionale: Progetta e prototipa interi layout UMG, crea singoli widget e modifica le loro proprieta usando il linguaggio naturale. (Sperimentale)
• Intelligenza a Livello di Progetto: Scansiona l’intero progetto (Blueprint, Material, ecc.) per trovare hotspot di prestazioni e fai domande contestuali sulla tua codebase.
• Analisi C++ Esterna: Leggi e scrivi su file sorgente C++ esterni (.cpp/.h) per analizzare o modificare codebase esterne.

Una volta acquisito il plugin devi semplicemente aprire l’Epic Games Launcher, accedere alla tua Libreria Unreal Engine, cercare questo plugin e installarlo nell’engine.

Apri Unreal Engine e accedi alla scheda Plugins.

Abilita il BP Generator e assicurati che questi altri plugin siano abilitati e riavvia l’editor.

Riavvia l’Editor.

Ecco fatto, puoi usare il plugin subito ma continua a leggere i seguenti dettagli:

Il plugin di default ha circa 100k token di utilizzo gratuito attraverso una chiave API che ho aggiunto. Una volta che quei circa 100k token finiscono dovrai portare la tua chiave API. Puoi usare praticamente qualsiasi provider e puoi anche connettere il plugin a un LLM locale se la tua macchina e abbastanza potente.

Gemini offre una chiave API gratuita. Piu dettagli sulle Chiavi API nella sezione CHIAVI API.

La versione 0.3.5 rilasciata il 26 Gennaio integra completamente il plugin all’interno dell’Unreal Editor senza la necessita di usare app e connessioni di terze parti come Claude Desktop, Cursor o connettere il plugin con l’estensione browser a DeepSeek.

Il plugin puo ancora essere usato come al solito attraverso Claude Desktop e altre app desktop come Cursor, Github Copilot, Google Antigravity ecc. E LLM Locali (con la versione 0.3.5).

CONFIGURAZIONE CHIAVE API GOOGLE GEMINI (gratuita e consigliata)

Video Panoramica

Vai al sito web Google Studio cosi possiamo creare una nuova chiave API.

Clicca sul pulsante Create API key.

Seconda opzione se non hai nessun progetto creato in google cloud.

Copia la chiave generata e riapri il tuo progetto Unreal Engine.

Aggiungi la chiave e Salva.

CONFIGURAZIONE CHIAVE API OPEN AI (chatgpt)

Sebbene raccomandi Gemini, OpenAI e una scelta valida.

Vai su https://platform.openai.com/usage.

Dopo aver effettuato l’accesso, clicca sul testo Edit Budget nella scheda Usage.

Dalla nuova finestra che si e aperta, cerca la sezione Billing.

Seleziona Add to credit balance e puoi optare per il credito minimo di 5$. Una volta aggiunto il saldo credito puoi accedere alla sezione chiavi API e creare una nuova chiave.

Copia la chiave generata e vai al tuo progetto Unreal Engine.

La chiave API Claude, DeepSeek funziona allo stesso modo di OpenAi - devi ricaricare alcuni crediti sul loro sito web affinche la chiave API funzioni o puoi avere un abbonamento valido e dovresti essere in grado di ottenere una chiave.

Questa opzione e modulare e funzionera con praticamente qualsiasi provider di chiavi API. L’ho testata con Z.ai e Venice.ai.

Per l’opzione provider personalizzato devi compilare l’endpoint API, il nome del modello e anche la Chiave API. Troverai questi dettagli sul sito web del provider.

Ultimate Blueprint Generator supporta server locali compatibili con OpenAI come Ollama e LM Studio. Questo consente l’uso offline, maggiore privacy e nessun costo API.

IMPORTANTE: L’URL dell’Endpoint

Il tuo endpoint DEVE terminare con /v1/chat/completions affinche il plugin funzioni correttamente.

NON usare percorsi come /chat, /generate, o solo l’URL base. Questi non funzioneranno.

Configurazione Ollama

Passo 1: Installare ed Eseguire Ollama

1. Scarica da ollama.ai e installa
2. Scarica un modello: ollama pull llama3.2
3. Esegui il modello: ollama run llama3.2
4. Ollama avvia automaticamente il suo server API in background

Passo 2: Configura nel Plugin

Nelle impostazioni API del plugin:

• Provider: Seleziona Custom API Provider
• URL Endpoint API: http://localhost:11434/v1/chat/completions
• Nome Modello: Nella vista principale del Blueprint Generator, inserisci il tuo modello (es. llama3.2)

Configurazione LM Studio

Passo 1: Avvia il Server

1. Apri LM Studio e vai alla scheda Local Server (icona </>)
2. Seleziona un modello dal menu a tendina per caricarlo
3. Clicca il pulsante Start Server

Passo 2: Configura nel Plugin

Nelle impostazioni API del plugin:

• Provider: Seleziona Custom API Provider
• URL Endpoint API: http://localhost:1234/v1/chat/completions
• Nome Modello: Nella vista principale, inserisci il nome esatto del modello mostrato nel menu a tendina di LM Studio

Risoluzione Problemi

Problemi di connessione?

• Assicurati che il tuo server locale sia effettivamente in esecuzione prima di inviare richieste
• Verifica che l’URL termini con /v1/chat/completions (NON /chat o /generate)
• Controlla che la porta corrisponda (Ollama: 11434, LM Studio: 1234 di default)
• Per macchine in rete, sostituisci localhost con l’IP (es. http://192.168.1.50:11434/v1/chat/completions)
• Controlla che il tuo firewall non stia bloccando la connessione

Perche /v1/chat/completions?

Il plugin usa il formato API OpenAI, che e lo standard per i server LLM locali. L’endpoint /v1/chat/completions fornisce risposte JSON strutturate che il plugin puo analizzare correttamente. Altri endpoint come /chat o /generate usano formati diversi e non funzioneranno.

Modelli Locali Testati

• Ollama minimax m2

Scarica e installa dal loro sito web: https://claude.ai/download

Una volta installato, eseguilo e cerca Impostazioni:

Nelle impostazioni vai su Estensioni -> Impostazioni Avanzate

Installa Estensione:

E vai dove la nuova versione del plugin e installata sul tuo computer. (esempio: C:/Program Files/Epic Games/UE_5.7/Engine/Plugins/Marketplace/Ultimate3867945fbc2aV39/Content/Python/Extensions). E aggiungili uno per uno:

Una volta installati entrambi dovresti vederli in esecuzione nella scheda Developer.

Prepara Claude dicendo “how to use the connected tools?”

Questo e il file di configurazione MCP predefinito ma devi cambiare il percorso per puntare dove Epic ha installato il plugin:

{
  "mcpServers": {
    "unreal-handshake": {
      "command": "python",
      "args": [
        "C:/Program Files/Epic Games/UE_5.7/Engine/Plugins/Marketplace/Ultimate3867945fbc2aV39/Content/Python/mcp_main_server.py",
        "--server-name",
        "unreal-handshake"
      ],
      "env": {
        "UNREAL_HOST": "localhost",
        "UNREAL_PORT": "9877"
      }
    },
    "filesystem-access": {
      "command": "python",
      "args": [
        "C:/Program Files/Epic Games/UE_5.7/Engine/Plugins/Marketplace/Ultimate3867945fbc2aV39/Content/Python/mcp_main_server.py",
        "--server-name",
        "filesystem-access"
      ]
    }
  }
}

!! Il percorso che copierai ha barre \ invece di barre /. Assicurati di sostituire \ con / !!

Se incontri difficolta assicurati di consultare un’AI e sara in grado di guidarti ulteriormente nella configurazione della tua app preferita.

Puoi personalizzare il comportamento dell’AI aggiungendo istruzioni personalizzate che verranno inviate con ogni richiesta.

Accesso alle Istruzioni Personalizzate

Clicca sul pulsante “Instructions” all’interno dell’interfaccia del Plugin nell’Unreal Editor.

Aggiungere le Tue Istruzioni

Nella nuova scheda aperta, potrai aggiungere le tue istruzioni personalizzate. Queste istruzioni vengono inviate con ogni richiesta all’AI, permettendoti di modificare il comportamento dell’AI per soddisfare le tue esigenze specifiche.

Molte altre opzioni di personalizzazione verranno aggiunte nei futuri aggiornamenti.

Se stai usando la chiave API gratuita di Gemini, potresti incontrare alcuni codici di errore a causa del rate limiting.

Codici di Errore Comuni

Puoi controllare la documentazione ufficiale dei codici di errore qui: Risoluzione Problemi API Gemini

Gestire i Limiti di Frequenza (Errore 429)

Se incontri un errore 429 (Rate Limit):

• Crea piu chiavi API gratuite usando diversi account Google
• In un futuro aggiornamento, sara aggiunto un modo semplice per scambiare tra le chiavi API
• Combina il livello gratuito di Gemini con il livello gratuito di Claude Desktop per minimizzare le limitazioni
• Considera di usare un LLM Locale per l’uso offline senza costi API

Per maggiori dettagli o aiuto, unisciti al Server Discord.