Logic Driver Pro

O Logic Driver Pro, da Recursoft, é o plugin de máquinas de estados que muitos projetos Unreal usam para IA, missões, diálogos e fluxo de gameplay. Com a extensão Logic Driver, o Ultimate Engine CoPilot constrói essas máquinas de estados para você: cria o asset, adiciona estados, transições e conduits, escreve as condições das transições, organiza o layout do grafo, compila e verifica no PIE.

Tudo passa pelo Logic Driver Assist, a camada de criação da própria Recursoft para o Logic Driver, então cada edição é a mesma que você faria à mão no editor de grafos do Logic Driver.

---

Do que você precisa

Na pasta Plugins do seu projeto:

• Logic Driver Pro 2.11 ou mais recente, da Recursoft.
• Logic Driver Assist (o plugin SMAssist), da Recursoft.

Além do Ultimate Engine CoPilot com a extensão Logic Driver ligada.

Sem o Logic Driver Assist, a extensão não faz nada prejudicial. Ela adiciona uma ferramenta de status e nada mais muda.

---

Configuração

1. Instale o Logic Driver Pro 2.11+ no seu projeto.
2. Coloque o Logic Driver Assist na pasta Plugins do mesmo projeto.
3. No CoPilot, abra Configurações > Extensões e ligue Logic Driver. Ela vem desligada por padrão.
4. Reinicie o editor. Na inicialização, o CoPilot encontra as operações do Logic Driver Assist e adiciona cada uma como ferramenta.
5. Peça à IA para verificar o status do Logic Driver. Ela informa se o Logic Driver Assist foi encontrado e quantas operações foram adicionadas, e, se faltar algo, diz o quê.

---

O que você pode pedir

• “Crie uma máquina de estados de IA inimiga com Idle, Patrol, Chase e Attack. Entre em Chase quando o jogador estiver a menos de 1.500 unidades.”
• “Adicione um estado Stunned em que qualquer estado possa entrar, e volte para Idle depois de 2 segundos.”
• “Dê a cada estado uma velocidade e uma cor, e mostre isso nos nós.”
• “Organize o layout deste grafo para que nada se cruze e depois me mostre uma captura de tela.”
• “Coloque o actor no nível, inicie o PIE e me diga em qual estado ele está.”

Por trás desses pedidos, a IA consegue:

• Criar Blueprints de máquina de estados e adicionar estados, transições, conduits, link states, Any States e máquinas de estados aninhadas.
• Escrever as condições das transições inline ou atribuir uma classe de transição. Ela também pode fazer uma transição disparar em um evento em vez de a cada tick.
• Dar aos estados uma classe de nó com variáveis próprias e definir os valores de cada estado, exibidos no nó.
• Adicionar o componente de máquina de estados a um actor e definir quando ele começa.
• Organizar o layout do grafo, encontrar nós sobrepostos e fazer uma captura de tela do grafo.
• Compilar e depois ler o estado ativo de uma instância de PIE em execução para provar que o fluxo funciona.

---

Grafos que uma pessoa consegue ler

Uma máquina de estados existe para ser lida, então a IA trata o layout como parte da construção:

• Todo estado está conectado. Exatamente um estado inicia a máquina, e nenhum nó fica solto.
• Uma pasta própria. Máquinas de estados novas vão para uma pasta limpa. As que você já tem ficam intactas, a menos que você peça.
• Layout uma vez, no final. A IA organiza o layout dos grafos novos depois de adicionar tudo, para que os nós que crescem com suas propriedades ainda tenham espaço. Conexões que cruzariam um estado são redirecionadas.
• Verificado, não presumido. Ela procura sobreposições e faz uma captura de tela do grafo, e usa link states e máquinas de estados aninhadas em vez de conexões longas que atravessam o grafo de volta.
• Comprovado no PIE. Uma compilação limpa não prova que o fluxo está certo, então ela executa a máquina e lê o estado ativo.

---

Permissões

Ler é livre: inspecionar um asset, um grafo ou um estado em execução acontece sem perguntar. Toda alteração pergunta antes, como no resto do CoPilot. As poucas alterações que não podem ser desfeitas, como remover estados ou substituir uma classe, são marcadas como destrutivas.

---

Como a ponte funciona

• Descoberto, não fixo no código. O CoPilot lê as operações do Logic Driver Assist quando o editor inicia e adiciona o que a versão instalada tiver. Quando a Recursoft adiciona ou altera uma operação, as ferramentas acompanham sem uma atualização do CoPilot.
• As descrições e os parâmetros deles. Cada ferramenta traz a descrição e a lista de parâmetros do próprio Logic Driver Assist, então a IA vê os nomes e tipos reais dos argumentos. Uma chamada com um argumento errado é respondida com os certos em vez de ser repassada.
• Em todo lugar ao mesmo tempo. As ferramentas funcionam no chat do CoPilot, em clientes MCP externos como Claude Code e Cursor, e em agentes de programação. Veja Integração MCP.
• Nomes. O Logic Driver Assist nomeia as operações com um ponto, como ld.add_state. No CoPilot elas viram ld_add_state, ld_add_transition, ld_compile e assim por diante. A documentação da Recursoft usa os nomes com ponto.
• Nenhum vínculo entre os plugins. A ponte se comunica com o Logic Driver Assist pelos comandos de console dele, então nenhum dos plugins depende do outro para compilar, e o CoPilot funciona igual com ou sem o Logic Driver instalado.

---

Experimental

O Logic Driver Assist é marcado como experimental pela Recursoft, e as operações dele ainda podem mudar. Como o CoPilot as lê na inicialização em vez de fixá-las no código, a extensão se mantém atualizada sozinha.

Veja Extensões para entender como as extensões funcionam, e a documentação do Logic Driver para o Logic Driver em si.