Logic Driver Pro

Logic Driver Pro di Recursoft è il plugin di state machine che molti progetti Unreal usano per AI, quest, dialoghi e flusso di gioco. Con l’estensione Logic Driver, Ultimate Engine CoPilot costruisce queste state machine al posto tuo: crea l’asset, aggiunge stati, transizioni e conduit, scrive le condizioni delle transizioni, dispone il grafo, lo compila e lo verifica in PIE.

Funziona tramite Logic Driver Assist, il livello di authoring di Recursoft per Logic Driver, quindi ogni modifica è la stessa che faresti a mano nell’editor dei grafi di Logic Driver.

---

Cosa ti serve

Nella cartella Plugins del tuo progetto:

• Logic Driver Pro 2.11 o successivo, di Recursoft.
• Logic Driver Assist (il plugin SMAssist), di Recursoft.

In più, Ultimate Engine CoPilot con l’estensione Logic Driver attiva.

Senza Logic Driver Assist l’estensione non fa nulla di dannoso. Aggiunge uno strumento di stato e nient’altro cambia.

---

Configurazione

1. Installa Logic Driver Pro 2.11+ nel tuo progetto.
2. Metti Logic Driver Assist nella cartella Plugins dello stesso progetto.
3. Nel CoPilot, apri Impostazioni > Estensioni e attiva Logic Driver. Di base è disattivata.
4. Riavvia l’editor. All’avvio il CoPilot trova le operazioni di Logic Driver Assist e aggiunge ciascuna come strumento.
5. Chiedi all’AI di controllare lo stato di Logic Driver. Ti dice se Logic Driver Assist è stato trovato e quante operazioni sono state aggiunte, e se manca qualcosa, ti dice cosa.

---

Cosa puoi chiedere

• “Crea una state machine per l’AI nemica con Idle, Patrol, Chase e Attack. Passa a Chase quando il giocatore è entro 1.500 unità.”
• “Aggiungi uno stato Stunned in cui può entrare qualsiasi stato, e torna a Idle dopo 2 secondi.”
• “Dai a ogni stato una velocità e un colore, e mostrali sui nodi.”
• “Disponi questo grafo in modo che niente si incroci, poi mostrami uno screenshot.”
• “Metti l’actor nel livello, avvia PIE e dimmi in quale stato si trova.”

Dietro queste richieste, l’AI può:

• Creare Blueprint di state machine e aggiungere stati, transizioni, conduit, link state, Any State e state machine annidate.
• Scrivere le condizioni delle transizioni inline, oppure assegnare una classe di transizione. Può anche far scattare una transizione su un evento invece che a ogni tick.
• Dare agli stati una classe di nodo con variabili proprie, e impostare i valori di ogni stato, mostrati sul nodo.
• Aggiungere il componente state machine a un actor e impostare quando si avvia.
• Disporre il grafo, trovare i nodi sovrapposti e fare uno screenshot del grafo.
• Compilare, poi leggere lo stato attivo di un’istanza PIE in esecuzione per dimostrare che il flusso funziona.

---

Grafi leggibili da una persona

Una state machine esiste per essere letta, quindi l’AI tratta il layout come parte della costruzione:

• Ogni stato è collegato. Esattamente uno stato avvia la macchina, e nessun nodo resta scollegato.
• Una cartella tutta sua. Le nuove state machine vanno in una cartella pulita. Quelle che hai già restano intatte, a meno che tu non lo chieda.
• Layout una volta sola, alla fine. L’AI dispone i nuovi grafi dopo aver aggiunto tutto, così i nodi che crescono con le loro proprietà hanno ancora spazio. I collegamenti che attraverserebbero uno stato vengono reinstradati.
• Verificato, non dato per scontato. Cerca le sovrapposizioni e fa uno screenshot del grafo, e usa link state e state machine annidate invece di lunghi collegamenti che riattraversano il grafo.
• Dimostrato in PIE. Una compilazione pulita non prova che il flusso sia corretto, quindi esegue la macchina e legge lo stato attivo.

---

Permessi

Leggere è libero: ispezionare un asset, un grafo o uno stato in esecuzione avviene senza chiedere. Ogni modifica chiede prima, come nel resto del CoPilot. Le poche modifiche che non si possono annullare, come rimuovere stati o sostituire una classe, sono contrassegnate come distruttive.

---

Come funziona il ponte

• Trovato, non scritto nel codice. Il CoPilot legge le operazioni di Logic Driver Assist all’avvio dell’editor e aggiunge tutto ciò che ha la versione installata. Quando Recursoft aggiunge o cambia un’operazione, gli strumenti si adeguano senza un aggiornamento del CoPilot.
• Le loro descrizioni, i loro parametri. Ogni strumento porta la descrizione e l’elenco dei parametri di Logic Driver Assist, così l’AI vede i veri nomi e tipi degli argomenti. Una chiamata con un argomento sbagliato riceve in risposta quelli giusti invece di essere inoltrata.
• Ovunque allo stesso tempo. Gli strumenti funzionano nella chat del CoPilot, nei client MCP esterni come Claude Code e Cursor, e negli agenti di programmazione. Vedi Integrazione MCP.
• Nomi. Logic Driver Assist dà alle operazioni nomi con un punto, come ld.add_state. Nel CoPilot diventano ld_add_state, ld_add_transition, ld_compile e così via. La documentazione di Recursoft usa i nomi con il punto.
• Nessun legame tra i plugin. Il ponte comunica con Logic Driver Assist tramite i suoi comandi console, quindi nessuno dei due plugin dipende dall’altro per compilare, e il CoPilot funziona allo stesso modo con o senza Logic Driver installato.

---

Sperimentale

Recursoft contrassegna Logic Driver Assist come sperimentale, e le sue operazioni possono ancora cambiare. Poiché il CoPilot le legge all’avvio invece di scriverle nel codice, l’estensione si tiene al passo da sola.

Vedi Estensioni per come funzionano le estensioni, e la documentazione di Logic Driver per Logic Driver stesso.