Mod IA per Portal 2: IA parlante nelle camere di test
Crea una mod IA per Portal 2: un'IA sarcastica nelle camere di test che reagisce ai tuoi tentativi, camere controllate con la voce e un quiz scientifico, collegata tramite VScript.
Neocortex TeamThe team behind Neocortex
· 6 min di lettura

Gli script delle mappe di Portal 2 non possono accedere a internet. È il problema che ogni mod IA per Portal 2 deve risolvere, e la risposta è una piccola app di supporto che gira accanto al gioco. Una volta installata, la tua camera di test può avere una sua IA parlante, il che si addice a un gioco in cui sei giudicato da una voce nei muri: una camera che nota che fallisci lo stesso salto cinque volte e ha qualcosa da dire in proposito, una camera che controlli parlando, e un quiz che apre l'uscita solo per le risposte giuste. Neocortex fornisce il personaggio IA, i Conversation Flows, i quiz e i comandi vocali eseguiti sul dispositivo.
Screenshot: Portal 2 © Valve
Perché una mod IA per Portal 2 ha bisogno di un'app di supporto?
Le mappe di Portal 2 si costruiscono in Hammer con i Portal 2 Authoring Tools e si condividono sullo Steam Workshop. La logica della mappa è I/O di entità più VScript, che in Portal 2 è Squirrel. VScript può leggere e spostare entità, seguire il giocatore e stampare nella console, ma non ha accesso alla rete né a HTTP.
Quindi la mappa fa ciò che può fare, cioè riferire e reagire, e un'app di supporto locale si occupa di parlare con Neocortex. L'app di supporto può essere scritta in qualsiasi linguaggio con un client HTTP.
Come escono gli eventi dal gioco e tornano dentro?
| Direzione | Come |
|---|---|
| Fuori dal gioco | Il tuo VScript stampa righe con tag (un evento, uno stato della camera) nella console. Avviando Portal 2 con -condebug la console viene scritta in un file console.log che l'app di supporto può osservare. Vedi le opzioni della riga di comando di Valve. |
| Dentro il gioco | L'opzione di avvio -netconport apre una porta della console che permette all'app di supporto di inviare comandi, per esempio una chiamata script al VScript della tua mappa. Tieni quella porta sulla tua macchina. |
| Sottotitoli | La mappa mostra il testo della risposta con un'entità game_text. |
| Voce | L'app di supporto riproduce la voce del personaggio tramite l'uscita audio del PC. |
Dal lato Neocortex, l'app di supporto legge lo stato del gioco dal log della console e lo invia insieme al messaggio del giocatore a un personaggio tramite /v3/chat. La mappa mostra la risposta come sottotitoli, l'app di supporto riproduce la voce da /v3/audio/generate o /v3/audio/stream, e le azioni che il personaggio restituisce tornano alla mappa come comandi della console. I Conversation Flows restituiscono parole chiave di checkpoint (flowState) a cui la mappa reagisce, per esempio aprendo il test successivo, e il motore di quiz gestisce giochi di domande e risposte tramite /v3/quiz.
Cosa può fare un'IA di una camera di test?
Crea un supervisore originale invece di prendere quello del gioco: PROCTOR-7, un'intelligenza della struttura retrocessa a gestire una sola camera e per niente contenta. Dagli un nodo Personality, un'impostazione Emotion e una Knowledge base sulla soluzione della camera, sulla sua storia e sulle sue piccole lamentele.
La tua mappa segnala ciò che succede: "il giocatore è caduto nel liquido", "terzo lancio fallito al pannello B", "cubo posizionato sul pulsante sbagliato", "il giocatore è fermo da 40 secondi". L'app di supporto li invia come eventi con ogni messaggio, e PROCTOR-7 commenta a voce, con un tag di emozione su ogni battuta: CURIOUS quando provi qualcosa di nuovo, ANGRY quando rompi la soluzione prevista.
Può anche restituire azioni, come un riluttante { "name": "SPAWN_CUBE", "targetId": "dropper_01" } dopo abbastanza fallimenti, che la mappa esegue come suggerimento.
Un Conversation Flow può trasformare l'intera camera in una storia: introduzione, primo test, un "malfunzionamento" che il giocatore deve far calmare a PROCTOR-7 parlandogli, e un test finale. Ogni parola chiave di checkpoint restituita dall'API apre la parte successiva della mappa.
Screenshot: Portal 2 © Valve
Il giocatore può risolvere una camera parlando?
Sì. Costruisci una camera che il giocatore risolve parlandole. Nella dashboard di Neocortex progetti un set di comandi come attori, azioni e oggetti: attore "chamber", azioni "raise", "lower", "drop" e "extend", oggetti "platform", "cube" e "bridge".
I giocatori parlano in modo naturale, e l'app di supporto riceve subito i comandi riconosciuti, anche più azioni e quantità in una sola frase: "drop two cubes and raise the platform". Funziona con push-to-talk o ascolto sempre attivo, in più lingue, e Neocortex Voice Commands gira sulla macchina del giocatore senza andata e ritorno nel cloud, il che conta quando il tempismo di un lancio dipende da questo.
Voice Commands è un SDK con licenza: contattaci per una licenza Voice Commands.
La stessa camera può mettere alla prova la conoscenza invece dei riflessi. Un personaggio annunciatore pone domande di fisica costruite nella dashboard di Neocortex: quantità di moto, gravità, perché un portale conserva la tua velocità. Il motore di quiz (piano Team) gestisce le domande e il punteggio; ogni risposta giusta accende un segmento in più del ponte di luce, e una sbagliata fa cadere un cubo nel liquido.
Funziona in Portal 2: Community Edition?
Portal 2: Community Edition è una versione di Portal 2 mantenuta dalla community, basata su Strata Source, un fork ufficialmente licenziato del ramo del motore di CS:GO. È entrata in open beta su Steam il 17 aprile 2026, è gratuita per chi possiede Portal 2 e aggiunge un port nativo a 64 bit, lo scripting AngelScript, l'interfaccia Panorama, un sistema di addon e un proprio Workshop.
È ancora una beta, quindi controlla la documentazione per capire cosa può fare il suo scripting. Il modello dell'app di supporto funziona comunque.
Si può pubblicare sul Workshop?
I termini del Workshop di Valve si applicano alla mappa, e l'app di supporto è un download separato che i giocatori scelgono di eseguire. Limita le funzioni IA e vocali alle camere in giocatore singolo, non usarle mai per ottenere un vantaggio in cooperativa con giocatori che non hanno scelto di partecipare, e fai in modo che ogni giocatore usi la propria chiave API Neocortex.
Crea la tua prima camera parlante
- Costruisci una camera di test in Hammer con un file VScript che stampa eventi con tag nella console.
- Progetta il tuo personaggio nella dashboard di Neocortex: Personality e Knowledge di PROCTOR-7, un Conversation Flow per la camera, un quiz e un set di comandi.
- Scrivi l'app di supporto: osserva
console.log, chiama/v3/chat, riproduci la voce e invia comandi indietro tramite la porta della console. - Conserva la chiave API nel file di configurazione dell'app di supporto, compilato dal giocatore, mai scritta nel codice di una build che condividi.
- Prova in giocatore singolo con le opzioni di avvio impostate, poi pubblica la mappa sul Workshop e l'app di supporto a parte.
Per la parte vocale, leggi comandi vocali sul dispositivo per le mod dei giochi. Per le mod a livello di motore su Source, vedi la nostra guida alla mod IA NPC per Half-Life 2, e per un gioco Source i cui script possono chiamare direttamente l'API, la nostra guida alla mod IA per Titanfall 2. E se in seguito vorrai PROCTOR-7 in un gioco autonomo, lo stesso personaggio Neocortex funziona tramite la nostra integrazione Unity.
Versioni degli strumenti e link verificati nell'ottobre 2026. Gli strumenti di modding cambiano spesso; controlla la pagina di ogni progetto per l'ultima versione.
Domande frequenti
Si può aggiungere un personaggio IA a Portal 2?
Sì, con una piccola app di supporto. Gli script delle mappe di Portal 2 non possono accedere a internet, quindi la mappa stampa eventi nella console e un'app di supporto locale li passa a un personaggio IA. Neocortex fornisce il personaggio, la sua voce e le sue risposte, e l'app di supporto le rimanda dentro il gioco.
VScript di Portal 2 può fare richieste HTTP?
No. VScript in Portal 2 è Squirrel che gira all'interno della mappa, senza accesso alla rete. Lo schema usuale è scrivere eventi nella console, leggerli da un'app di supporto e lasciare che quell'app chiami API web come quella di Neocortex.
Posso controllare una camera di test di Portal 2 con la voce?
Sì. Un'app di supporto può ascoltare il microfono e inviare comandi riconosciuti nel gioco, come alzare una piattaforma o far cadere un cubo. Neocortex Voice Commands fa il riconoscimento sul PC del giocatore, quindi funziona offline e risponde all'istante.
Cos'è Portal 2: Community Edition?
Portal 2: Community Edition è una versione di Portal 2 mantenuta dalla community, basata sul motore Strata Source, in open beta su Steam dall'aprile 2026 e gratuita per chi possiede Portal 2. Aggiunge AngelScript, l'interfaccia Panorama e un sistema di addon, e anche il modello dell'app di supporto per Neocortex funziona lì.
Posso pubblicare una camera di test IA sullo Steam Workshop?
Puoi pubblicare la mappa sul Workshop come al solito, ma l'app di supporto va condivisa separatamente, per esempio su GitHub. Ogni giocatore la esegue con la propria chiave API Neocortex, che puoi ottenere nell'editor nel browser.






