Neocortex Logo

NPC mercanti IA: venditori che contrattano con te

Costruisci NPC mercanti IA con Neocortex: venditori che contrattano, notano cosa porta il giocatore ed eseguono azioni come sconti, rifiuti e vetrine di merce.

Neocortex TeamThe team behind Neocortex

· 6 min di lettura

Costruisci NPC mercanti IA con Neocortex: venditori che contrattano, notano cosa porta il giocatore ed eseguono azioni come sconti, rifiuti e vetrine di merce.

La maggior parte dei negozi nei giochi è un menu con una faccia sopra: stessi prezzi, stesso saluto, che il giocatore abbia salvato il quartiere o derubato la bancarella accanto. Con Neocortex, un NPC mercante IA contratta con la sua voce, nota cosa porta il giocatore e com'è andata l'ultima visita, e restituisce azioni che il tuo gioco esegue, come uno sconto, un rifiuto o una vetrina della merce migliore.

Come appare

Brassmoor è una città di canali in un gioco fantasy originale in stile gaslamp, fatto di nebbia, chiatte e ricevute del banco dei pegni. Ysolde Varn gestisce il Lamplighter's Exchange, un banco dei pegni incastrato sotto un ponte. È sveglia, paziente e impossibile da mettere fretta, e ha un debole per chiunque riesca a farla ridere.

Il giocatore entra con una bussola d'argento che ha sottratto un'ora fa dall'ufficio del capitano del porto. Il gioco invia l'inventario del giocatore come metadati, e la bussola ha una proprietà che la segna come rubata. Riprende anche la sessione del giocatore con Ysolde, che conserva l'ultima visita, quando il giocatore aveva provato a venderle un anello di ottone dipinto d'oro.

Giocatore: Ti do quaranta per la lanterna da tempesta. Ysolde: Quaranta, da chi mi ha venduto ottone dipinto. Sessanta, e mi mostri cosa nascondi nel cappotto. Giocatore: È solo una bussola. Ysolde: È la bussola del capitano del porto. La prendo per venti e dimentico di averla mai vista.

Mentre parla, la risposta porta un'azione SHOW_WARES puntata sullo scaffale delle lanterne, così il gioco sposta la telecamera sulla sua merce migliore. Quando il giocatore la fa ridere con una scusa pessima, la risposta successiva torna con OFFER_DISCOUNT sulla lanterna. Se invece il giocatore la minaccia, lei risponde con freddezza, restituisce REFUSE_SALE e la finestra del negozio si chiude.

Nessuno ha scritto quella trattativa riga per riga. L'autore ha dato a Ysolde una personalità, un listino, una forte avversione per i bugiardi e tre azioni, e il comportamento del giocatore ha fatto il resto.

Come Neocortex fa funzionare tutto

  • Progettazione visuale del personaggio. La personalità, il passato, lo stile di contrattazione e la voce di Ysolde vivono nell'editor visuale a nodi di Neocortex, e puoi discutere i prezzi con lei nella dashboard nel browser prima di scrivere una sola riga di codice di gioco.
  • Azioni. Definisci SHOW_WARES, OFFER_DISCOUNT e REFUSE_SALE come nodi Action sul personaggio. Ogni risposta elenca quali eseguire e su quale bersaglio, come l'ID dell'oggetto lanterna, e il codice del negozio le esegue.
  • Metadati. L'inventario del giocatore arriva come entità con un ID, un nome, una posizione e proprietà come valore, condizione o refurtiva, così lei può nominare la bussola e decidere quanto vale per lei.
  • Memoria di sessione. Conserva il sessionId restituito per ogni giocatore e invialo alla visita successiva. Riprendi la sessione del giocatore e Ysolde riprende il filo, anello dipinto compreso.
  • Eventi. Dille cosa è appena successo nel tuo mondo: "il giocatore è stato colto a rubare in Fen Street", "la guardia cittadina ha raddoppiato le ronde". Il suo tono e le sue offerte ne tengono conto.
  • Base di conoscenza. Carica il suo listino e la storia degli oggetti come documento PDF o TXT (5 caricamenti su Starter, 20 su Pro, 100 su Team), così i prezzi di partenza arrivano dalla tua economia e non dal nulla.
  • Emozioni e voce. Ogni battuta arriva con un tag di emozione che il tuo sistema di animazione può usare, e con parlato in streaming nella sua voce. Le voci personalizzate, clonate da un breve campione o progettate da una descrizione testuale, sono disponibili su Pro (5) e Team (20).

Idee da costruire

Il ricettatore del mercato nero. In un gioco a colpi, il ricettatore compra solo ciò che scotta. Segna la merce rubata nei metadati e invia il livello di allerta della città come eventi. Durante un coprifuoco paga la metà e vuole che il giocatore se ne vada in fretta, e un informatore noto riceve REFUSE_SALE prima ancora di raggiungere il banco.

Mercanti rivali dall'altra parte della strada. Due bancarellai condividono una chat di gruppo (piani Pro e Team) e si fanno concorrenza ad alta voce. Chiedi un prezzo a uno e l'altro urla un prezzo più basso dall'altro lato del vicolo. Compra dal rivale, e lo scambio successivo ruota tutto intorno a quel tradimento.

Un commerciante di sopravvivenza che prezza per scarsità. Al cancello di un bunker in un gioco di sopravvivenza post-collasso, la commerciante legge le notizie prima di leggere il giocatore. Invia eventi come "il depuratore d'acqua si è rotto" o "un carico di rifornimenti è caduto a est", e le sue offerte su filtri e carburante si spostano di conseguenza, mentre il codice della tua economia tiene i numeri finali entro i limiti.

Un mercante itinerante con le sue opinioni. Il suo carro compare in una città diversa ogni settimana. Si rifiuta di trattare con chiunque indossi i colori della gilda che l'ha derubato, cosa che riconosce dagli oggetti equipaggiati del giocatore, a meno che il giocatore non riesca a farlo ragionare.

Come costruirlo

Gli NPC mercanti IA funzionano con l'SDK Unity, il plugin per Unreal Engine, l'addon per Godot e qualsiasi motore o gioco web che può chiamare la Web API. Il ciclo è lo stesso ovunque: invia la battuta del giocatore con il suo inventario e gli eventi recenti, poi esegui le azioni che tornano indietro.

  1. Progetta il mercante nell'editor visuale: personalità, come contratta, cosa non sopporta, una voce e le azioni che può restituire.
  2. Carica il listino nella sua base di conoscenza, così sa quanto valgono le cose nella tua economia.
  3. Contratta nella dashboard finché il personaggio non suona giusto, prima di toccare il codice di gioco.
  4. Invia l'inventario del giocatore come metadati e i cambiamenti recenti del mondo come eventi con ogni messaggio.
  5. Salva il sessionId per ogni coppia giocatore-mercante, e invialo alla visita successiva per riprendere la sessione del giocatore.
  6. Associa ogni azione al tuo negozio: apri la merce, applica uno sconto, chiudi la finestra.

Un turno di contrattazione da qualsiasi motore:

const res = await fetch("https://api.neocortex.link/v3/chat", {
  method: "POST",
  headers: {
    "x-api-key": apiKey, // load from your own config, never hard-code it
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    characterIds: [ysolde],
    message: playerLine,
    sessionId: savedSessionId, // resume this player's session with her
    playerId,
    metadata: inventoryAsEntities(player), // your helper: id, name, position, properties
    events: [{ priority: 1, content: "Lamp oil is scarce after the refinery fire" }],
  }),
});
const { sessionId, messages } = await res.json();
for (const action of messages[0].actions) runShopAction(action); // your helper

Tieni il denaro nel tuo codice. Lascia che il personaggio decida che uno sconto è meritato, e lascia che la tua economia decida quanto è grande, con un minimo, così un chiacchierone non può uscire con tutto il negozio per una moneta di rame.

I mercanti sono uno dei nostri casi d'uso di NPC IA, IA ambientale e comandi vocali. Abbinali agli NPC che danno missioni con IA per una città che commercia e parla, oppure a NPC che reagiscono agli eventi del mondo perché i prezzi seguano la storia. Le pagine NPC intelligenti, il sistema di azioni e la documentazione sugli interactables coprono i dettagli. Inizia con un solo mercante e un solo oggetto per cui valga la pena contrattare.

Verificato nell'ottobre 2026.

Domande frequenti

Un NPC mercante IA può contrattare con il giocatore?

Sì. Un personaggio Neocortex risponde alle offerte del giocatore con le sue parole e la sua personalità, e ogni risposta può restituire azioni come OFFER_DISCOUNT o REFUSE_SALE che il codice del tuo negozio esegue, mentre la tua economia mantiene il controllo del prezzo finale.

Come fa un mercante IA a sapere cosa porta il giocatore?

Il tuo gioco invia gli oggetti del giocatore come metadati con ogni messaggio: un ID, un nome, una posizione e proprietà come valore o refurtiva. Il personaggio Neocortex può poi nominare un oggetto, valutarlo e agire di conseguenza.

Un mercante IA può ricordare l'ultima visita del giocatore?

All'interno di una sessione, sì. Neocortex restituisce un sessionId con ogni risposta. Conservalo per ogni giocatore e invialo alla visita successiva per riprendere la sessione del giocatore, così il mercante riparte da dove era finita l'ultima conversazione.

Gli NPC mercanti IA funzionano con Unity e Unreal?

Sì. Neocortex ha un SDK Unity, un plugin per Unreal Engine con Blueprint e un addon per Godot, e qualsiasi motore o gioco web può chiamare direttamente la Web API di Neocortex.

Articoli simili

Continua a leggere