Neocortex Logo

Mod IA per NPC di Half-Life 2: squadre e compagni comandati a voce

Pianifica una mod IA per NPC di Half-Life 2 su Source SDK 2013: una squadra di ribelli che comandi a voce, un compagno che risponde, momenti narrativi nel rifugio e un terminale con quiz.

Neocortex TeamThe team behind Neocortex

· 6 min di lettura

Pianifica una mod IA per NPC di Half-Life 2 su Source SDK 2013: una squadra di ribelli che comandi a voce, un compagno che risponde, momenti narrativi nel rifugio e un terminale con quiz.

Half-Life 2 ha un'IA di squadra che ascolta la pressione dei tasti, e un mondo pieno di persone che dicono solo ciò che lo script permette. I ribelli ti seguono, ma non puoi dir loro nulla; i cittadini parlano, ma mai di ciò che è appena successo. Una mod IA per NPC di Half-Life 2 risolve entrambi i problemi: ribelli che reagiscono ai tuoi ordini ad alta voce, un compagno che parla del combattimento che hai appena superato, e scene narrative che si piegano alle scelte del giocatore. Neocortex aggiunge i personaggi IA, i Conversation Flow, i quiz e i comandi vocali sul dispositivo, e Source SDK 2013 ti fornisce il codice per collegarli.

Screenshot in gioco di Half-Life 2 Screenshot: Half-Life 2 © Valve

Ordini vocali per una squadra di ribelli

Half-Life 2 ti permette già di mandare la squadra in un punto e richiamarla. I comandi vocali sostituiscono la pressione del tasto con il parlato: "avanti", "tieni questa posizione", "copriti dietro la macchina", "raggruppatevi su di me".

Nella dashboard di Neocortex progetti il set di comandi come attori, azioni e oggetti: attore "squadra", azioni "muoviti", "tieni" e "copri", oggetti come "me", "macchina" e "porta". I giocatori parlano in modo naturale, e la mod riceve subito i comandi abbinati, anche più azioni e quantità in una sola frase: "due di voi guardano la porta, gli altri seguono me". Il tuo codice li associa al codice di squadra già esistente.

Funziona con push-to-talk o con ascolto continuo, in più lingue, e gira sulla macchina del giocatore, quindi gli ordini arrivano anche nel mezzo di un conflitto a fuoco senza andata e ritorno nel cloud.

Voice Commands è un SDK in licenza: contattaci per una licenza Voice Commands.

Esempio pratico: Mara Venn e il rifugio

Il compagno. Crea un compagno originale, per esempio Mara Venn, un'ex medica da campo che si è unita alla resistenza dopo la chiusura della sua clinica. La tua mod invia la domanda del giocatore insieme a ciò che il gioco sa: oggetti vicini (la barricata, la cassa delle munizioni, la radio) ed eventi recenti ("due membri della squadra a terra", "il giocatore ha preso il tunnel a sinistra", "salute sotto il 30"). Mara risponde a voce con un tag emotivo su ogni battuta, e può restituire azioni come consegnare un kit medico o aprire il cancello che il giocatore ha chiesto.

La squadra ribatte. La chat di gruppo (piani Pro e Team) permette a fino a sei personaggi di condividere una conversazione, così l'intera squadra può discutere sulla mossa successiva.

La cantina. Mara guida il giocatore in un rifugio nella cantina, dove deve guadagnarsi la fiducia di un capo cellula diffidente prima che lui riveli la rotta per uscire dalla città. Un Conversation Flow definisce i momenti: presentazioni, dimostrare da che parte stai, l'accordo, la rotta. Il personaggio guida la conversazione attraverso di essi, qualunque sia il modo in cui il giocatore si esprime, e l'API restituisce parole chiave di checkpoint come TRUST_EARNED o ROUTE_SHARED. La tua mod reagisce aprendo la porta nascosta o facendo comparire la guida che ti porta fuori.

Il terminale. In un angolo, un terminale addestra le nuove reclute: quali unità nemiche evitare, come segnalare alla squadra, quali rifornimenti portare. Il motore dei quiz Neocortex (piano Team) gestisce domande e punteggi, e una serie di risposte corrette può ricompensare il giocatore con munizioni o una scorciatoia.

Screenshot in gioco di Half-Life 2 Screenshot: Half-Life 2 © Valve

I rami di Source SDK 2013 per una mod IA per NPC di Half-Life 2

Half-Life 2 gira su Source. Una mod è una cartella con il proprio gameinfo.txt, i contenuti e due librerie C++ compilate dal codice di Valve: una DLL del server per l'IA degli NPC, le squadre e la logica di gioco, e una DLL del client per l'HUD, i pannelli VGUI e gli effetti locali. Scegli prima la base:

BaseCosa contieneStato
Source SDK 2013 ramo singleplayerIl codice della campagna singleplayer di Half-Life 2Nessun aggiornamento del codice dal 2015; gira sul Source SDK Base 2013 Singleplayer a 32 bit
Source SDK 2013 ramo masterIl codice multiplayerAggiornato a febbraio 2025 con il codice di gioco di Team Fortress 2 e build a 64 bit; Valve continua a committarvi
MapbaseUna base mantenuta dalla community per mod singleplayerLa versione 8.0 è uscita a luglio 2025, con nuove entità, correzioni e un'implementazione VScript per gli script delle mappe

Per una mod narrativa come il rifugio descritto sopra, parti dal ramo singleplayer o da Mapbase.

Chiamare Neocortex da una DLL di Source

Le intestazioni dell'SDK includono l'interfaccia HTTP di Steamworks, e molti modder aggiungono invece libcurl. In entrambi i casi, esegui le richieste su un thread di lavoro e restituisci i risultati al ciclo di gioco. Una chiamata di chat dalla DLL del client o del server, usando libcurl:

// bodyJson: {"characterIds":["CHARACTER_ID"],"message":"Where now?","playerId":"player-1",
//            "sessionId":"","events":[{"priority":1,"content":"Two squad members down"}]}
std::string AskCompanion(const std::string& apiKey, const std::string& bodyJson)
{
    std::string response;
    CURL* curl = curl_easy_init();
    curl_slist* headers = curl_slist_append(nullptr, "Content-Type: application/json");
    headers = curl_slist_append(headers, ("x-api-key: " + apiKey).c_str());
    curl_easy_setopt(curl, CURLOPT_URL, "https://api.neocortex.link/v3/chat");
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, bodyJson.c_str());
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, AppendToString); // appends bytes to response
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
    curl_easy_perform(curl);
    curl_slist_free_all(headers);
    curl_easy_cleanup(curl);
    return response; // sessionId, lines with emotions, actions and flowState
}

La mod legge lo stato del gioco e lo invia insieme al messaggio del giocatore a un personaggio Neocortex tramite /v3/chat, mostra la risposta come sottotitoli, riproduce la voce da /v3/audio/generate o /v3/audio/stream, ed esegue le azioni che il personaggio restituisce. I Conversation Flow restituiscono parole chiave di checkpoint (flowState) nella stessa risposta, il motore dei quiz gira tramite /v3/quiz, e i comandi vocali sul dispositivo trasformano le frasi pronunciate in azioni di gioco senza andata e ritorno nel cloud, con Neocortex Voice Commands che gira sulla macchina del giocatore.

Per l'interfaccia, i pannelli VGUI nella DLL del client possono mostrare sottotitoli e una schermata di quiz. I sottotitoli e i soundscript di Source sono pensati per battute preparate in anticipo, quindi le risposte IA dal vivo di solito hanno un proprio pannello di sottotitoli, con l'audio generato salvato in un file e riprodotto dal motore.

Prima di pubblicare: la licenza dell'SDK Source 1

La licenza dell'SDK Source 1 permette di distribuire le mod solo gratuitamente; le mod gratuite possono essere pubblicate su Steam. Mantieni le mod IA per NPC single-player, non usarle mai su server multiplayer contro le loro regole, e fai in modo che ogni giocatore usi la propria chiave API Neocortex.

Dalla mappa vuota alla squadra che parla

  1. Installa Source SDK 2013. Scegli il ramo singleplayer o Mapbase per una mod narrativa, compilalo e avvia una mappa di test vuota.
  2. Progetta i tuoi personaggi nella dashboard di Neocortex: un compagno, un capo cellula con un Conversation Flow, un quiz per il terminale e un set di comandi per la squadra.
  3. Chiama l'API dalla DLL del gioco su un thread di lavoro e riutilizza il sessionId di ogni risposta.
  4. Conserva la chiave API in un file di configurazione che il giocatore compila, mai scritta nel codice di una mod che condividi.
  5. Collega sottotitoli, voce e azioni, poi mappa i comandi vocali sul codice di squadra esistente.
  6. Prova in single-player su una mappa prima di estendere a una campagna completa.

Per vedere come funzionano i comandi vocali in una mod, leggi comandi vocali sul dispositivo per mod di gioco. Per GoldSrc, vedi la nostra guida alla mod IA per NPC di Half-Life, e per i server sandbox di Source, il post sull'addon IA e quiz per NPC di Garry's Mod. Mara e la sua squadra si possono provare oggi nell'editor browser di Neocortex, molto prima che la prima mappa venga compilata.

Versioni degli strumenti e link verificati a ottobre 2026. Gli strumenti di modding cambiano spesso; controlla la pagina di ogni progetto per la release più recente.

Domande frequenti

Si possono aggiungere NPC IA a Half-Life 2?

Sì. Le mod di Half-Life 2 si costruiscono con Source SDK 2013, che ti dà il codice C++ completo del gioco, quindi una mod può chiamare un'API web e agire sulla risposta. Neocortex fornisce il personaggio IA, la sua voce e le azioni che restituisce, e la tua mod le esegue.

Devo usare il ramo singleplayer o multiplayer di Source SDK 2013?

Le mod narrative di solito partono dal ramo singleplayer o da una base della community costruita su di esso, come Mapbase. Il ramo multiplayer ha ricevuto un grande aggiornamento con il supporto a 64 bit nel 2025 ed è ancora mantenuto, ma il suo codice è pensato per giochi multiplayer. Neocortex funziona con entrambi, perché è una semplice API web.

Posso comandare i ribelli di Half-Life 2 a voce?

Sì, con una mod. Half-Life 2 ha già il codice per i comandi di squadra, e una mod può attivarlo dal parlato. Neocortex Voice Commands riconosce frasi naturali sul PC del giocatore, quindi "avanti", "tieni questa posizione" e "raggruppatevi" raggiungono il tuo codice all'istante e senza connessione.

Posso vendere una mod di Half-Life 2 con personaggi IA?

No. La licenza dell'SDK Source 1 permette di distribuire le mod solo gratuitamente, anche se le mod gratuite possono essere pubblicate su Steam. Puoi costruire e provare la parte Neocortex di una mod gratuita nell'editor browser.

Articoli simili

Continua a leggere