Neocortex Logo

GTA 5 AI NPC 모드: 말하는 행인과 음성 명령

Neocortex로 GTA 5 AI NPC 모드 만들기: 말을 거는 행인, 운전을 평가하는 동승자, 음성 명령, 스토리 모드의 라디오 퀴즈.

Neocortex TeamThe team behind Neocortex

· 2026년 10월 23일 업데이트 · 6분 분량

Neocortex로 GTA 5 AI NPC 모드 만들기: 말을 거는 행인, 운전을 평가하는 동승자, 음성 명령, 스토리 모드의 라디오 퀴즈.

새벽 3시, 수배 별 두 개가 붙은 채 권총을 든 상태로 24시간 편의점에 들어가면, 점원은 누구에게나 하는 같은 말을 합니다. GTA 5 AI NPC 모드는 바로 그 순간을 고칩니다. 점원, 낯선 사람, 동승자가 여러분이 실제로 하는 말에 답하고, 방금 한 일에 반응합니다. Neocortex는 Script Hook V 모드에 음성, 행동, 감정을 가진 AI 캐릭터를 제공하고, 기기 안에서 실행되는 음성 명령도 제공합니다. 그래서 직접 언어 모델을 돌리지 않고도 스토리 모드에서 만들 수 있습니다.

Grand Theft Auto V Enhanced 게임 내 스크린샷 스크린샷: Grand Theft Auto V Enhanced © Rockstar Games

한눈에 보는 GTA 5 AI NPC 모드 구성

GTA 5 싱글플레이어 모드는 Script Hook V가 불러오는 네이티브 플러그인으로 실행됩니다. Script Hook V는 .asi 플러그인을 불러오고, 그 플러그인에 게임의 네이티브 함수 접근을 허용합니다. 2026년 7월 릴리스는 GTA V Legacy와 GTA V Enhanced 패치를 모두 지원한다고 밝힙니다. 대부분의 스크립트 모드는 .NET 계층 위의 C#으로 작성됩니다.

도구제공하는 것에디션
ScriptHookVDotNet 3 (SHVDN)표준 .NET 스크립트 호스트. 현재 게임 패치에는 마지막 안정 릴리스가 아니라 나이틀리 빌드가 필요합니다.Legacy
ScriptHookVDotNetEnhanced확장된 SHVDN이라, Legacy용으로 만든 스크립트를 수정 없이 Enhanced에서 실행할 수 있습니다Legacy와 Enhanced
LemonUISHVDN 3 스크립트용 NativeUI 스타일 메뉴. 설정 화면이나 "말 걸기" 프롬프트에 유용합니다둘 다

스크립트가 대상으로 삼는 빌드는 각 프로젝트의 노트에서 확인하세요.

스크립트는 scripts 폴더에 있는 컴파일된 C# 클래스이며, 매 프레임 실행되는 Tick 핸들러를 가집니다. 여기서 SHVDN의 API로 플레이어, 주변 보행자, 차량, 수배 레벨을 읽을 수 있습니다. .NET Framework가 할 수 있는 모든 일도 가능합니다. 웹 요청에는 HttpClient, 음성 재생에는 NAudio 같은 오디오 라이브러리, .ini 파일에는 SHVDN의 ScriptSettings를 씁니다. 자막은 GTA.UI.Screen.ShowSubtitle로 화면에 띄우고, 메뉴는 LemonUI가 처리합니다.

게임 이벤트에서 음성 응답까지

이 글의 모든 기능은 같은 루프로 실행됩니다. 스크립트가 게임 상태를 읽고, 플레이어의 말과 함께 Neocortex 캐릭터(/v3/chat)로 보내고, 응답을 자막으로 보여 주고, /v3/audio/generate 또는 /v3/audio/stream에서 목소리를 재생하며, 캐릭터가 돌려준 행동을 실행합니다. 웹 요청은 게임 스레드 밖에서 실행하고 결과를 Tick으로 돌려주어 게임이 멈추지 않게 하세요.

SHVDN 스크립트에서 채팅 호출을 최소한으로 만들면 다음과 같습니다.

static readonly HttpClient Http = new HttpClient();

static async Task<string> AskCharacter(string apiKey, string characterId, string sessionId, string line, string gameEvent)
{
    var body = JsonConvert.SerializeObject(new {
        characterIds = new[] { characterId },
        message = line,
        playerId = "player-1",
        sessionId = sessionId,
        events = new[] { new { priority = 1, content = gameEvent } }
    });
    var req = new HttpRequestMessage(HttpMethod.Post, "https://api.neocortex.link/v3/chat");
    req.Headers.Add("x-api-key", apiKey); // read from the mod's .ini, never hard-coded
    req.Content = new StringContent(body, Encoding.UTF8, "application/json");
    var res = await Http.SendAsync(req);
    return await res.Content.ReadAsStringAsync(); // sessionId, messages[].lines, actions
}

돌아온 sessionId를 보관했다가 다음 메시지에 함께 보내면, 캐릭터가 대화를 기억합니다.

이 루프 위에 세 가지 요소가 더 올라갑니다.

  • Conversation Flow는 여러분이 설계한 단계를 따라 더 긴 만남을 이끌고, 스크립트가 반응할 체크포인트 키워드(flowState)를 돌려줍니다. 예를 들어 낯선 사람이 플레이어를 신뢰하게 되면 웨이포인트를 건네는 식입니다.
  • 퀴즈 엔진은 /v3/quiz를 통해 문제 세트, 점수 계산, 리더보드를 실행합니다.
  • 기기 내 음성 명령은 클라우드 왕복 없이 말한 문장을 게임 행동으로 바꿉니다. Neocortex Voice Commands는 플레이어의 PC에서 실행되며, 명령 세트는 대시보드에서 액터, 행동, 대상으로 설계합니다(액터 "dispatcher", 행동 "send", 대상 "taxi"). 누르고 말하기 또는 항상 듣기 방식을 쓰며, 여러 언어를 지원합니다.

로스산토스에서 만들 수 있는 것

알아차리는 점원. 앞서 말한 24시간 편의점에서, 스크립트는 점원 캐릭터에 플레이어의 말과 함께 짧은 이벤트 목록("플레이어가 수배 별 2개", "플레이어가 권총을 듦", "근처에서 경찰 사이렌")을 보냅니다. 점원은 캐릭터에 맞게 답하고, 모드가 애니메이션으로 바꿀 수 있는 감정 태그를 붙입니다. 또 { "name": "OPEN_REGISTER" }나 { "name": "CALL_POLICE" } 같은 행동을 돌려주어 스크립트가 실행하게 할 수 있습니다. 같은 패턴은 베스푸치 비치의 노점상이나 미러 파크의 조깅하는 사람에게도 적용됩니다. 유형마다 캐릭터 하나를 두고, 각자 고유한 성격과 동네에 대한 지식을 갖게 하면 됩니다.

운전에 의견이 많은 동승자. 운전 중의 이벤트를 스트리밍하세요. 아슬아슬하게 피한 차, 무시한 신호, 세뇨라 프리웨이에서의 190km/h, 1분 안에 난 세 번째 사고 같은 것들입니다. 동승자는 논평하고, 웃고, 불평하며, 여러분이 놀라게 하면 내리겠다고 합니다. CHANGE_STATION이나 GET_OUT 같은 행동으로 실제로 무언가를 할 수도 있습니다. Pro와 Team 요금제에서는 그룹 채팅으로 한 대화에 최대 여섯 명의 캐릭터를 넣을 수 있으므로, 여러분이 운전하는 동안 동승자 둘이 경로를 두고 다툴 수도 있습니다.

음성 명령. 플레이어는 그냥 말하면 됩니다. "택시 불러 줘", "지원 요청해", "다음 채널", "라디오 끄고 집으로 웨이포인트 찍어 줘". 스크립트는 인식된 명령을 받아 실행하며, 필요하면 한 문장에 여러 개도 실행합니다.

라디오 퀴즈 진행자. 긴 드라이브를 위해, 퀴즈 엔진(Team 요금제)으로 로스산토스 퀴즈를 진행하는 독창적인 라디오 진행자 캐릭터를 만들 수 있습니다. 플레이어가 소리 내어 답하면, 음성 인식이 텍스트로 바꾸고, API가 점수를 기록합니다.

Grand Theft Auto V Enhanced 게임 내 스크린샷 스크린샷: Grand Theft Auto V Enhanced © Rockstar Games

스토리 모드에서만

Rockstar의 PC 싱글플레이어 모드 정책은 Take-Two가 일반적으로 제3자 IP를 존중하는 싱글플레이어 비상업 모드에 대해서는 조치를 취하지 않는다고 밝히며, 온라인 서비스, 새 스토리, 미션, 맵은 제외합니다. Rockstar의 최신 모드 가이드라인은 모든 게임을 다루며 더 나아갑니다.

  • Rockstar의 스토리는 건드리지 마세요. 스토리라인, 미션, 캐릭터를 확장하거나 수정하지 마세요. 마이클, 프랭클린, 트레버의 새 대사도 안 됩니다.
  • Rockstar의 음성은 건드리지 마세요. 성우의 음성 연기를 수정하거나 재사용하지 마세요. 각 AI 캐릭터에는 텍스트 설명으로 설계한 독창적인 Neocortex 음성이나, 권리를 가진 음성을 주세요. Rockstar 성우를 복제한 음성은 절대 안 됩니다.
  • 멀티플레이어는 Rockstar의 Creator Platform을 통해서만 운영하며, 그 플랫폼 밖의 모드는 엄격하게 비상업적이어야 합니다.

가이드라인은 자신이 라이선스가 아니라고도 밝히므로, Rockstar가 용인하는 범위를 설명할 뿐 권리를 부여하지는 않습니다. 따라서 주변 대화, 동료, 음성 명령, 퀴즈는 독창적인 캐릭터로 만드세요. 새 스토리 미션은 만들지 마세요. GTA Online은 절대 모드를 적용하면 안 됩니다. 모드는 스토리 모드에 두고, 무료로 유지하며, 각 플레이어가 자신의 Neocortex API 키를 쓰게 하세요.

다음 단계

  1. 에디션에 맞는 Script Hook V와 .NET 스크립트 호스트를 설치하세요. Legacy에는 SHVDN 나이틀리, Enhanced에는 ScriptHookVDotNetEnhanced입니다. 메뉴가 필요하면 LemonUI를 추가하세요.
  2. Neocortex 비주얼 편집기에서 캐릭터를 설계하세요. 성격, 로스산토스에 대한 지식, 음성, 돌려줄 수 있는 행동을 정하고 브라우저에서 테스트하세요.
  3. 아이디어에 필요하다면 Conversation Flow, 퀴즈, 음성 명령 세트를 추가하세요.
  4. 스크립트에서 연결하세요. HttpClient로 호출하고, 응답은 자막으로 보여 주고, 오디오를 재생하세요.
  5. API 키는 플레이어가 채우는 .ini 파일에 보관하세요. 그래야 모든 플레이어가 자신의 키를 씁니다.
  6. 무엇이든 공유하기 전에 스토리 모드에서 테스트하세요.

Voice Commands는 라이선스가 필요한 SDK입니다. Voice Commands 라이선스 문의하기.

같은 방식은 다른 Rockstar 게임에도 적용됩니다. Red Dead Redemption 2, GTA 산 안드레아스와 바이스 시티, GTA 4 가이드를 참고하세요. 다음 단계는 GTA 6 모딩 글에서 살펴봅니다. 음성 쪽은 게임 모드용 기기 내 음성 명령 글을 읽거나, 비교 페이지에서 Neocortex가 어떤 위치인지 보세요. 상점 한 곳의 점원 한 명부터 시작하세요. 나머지 대화는 Neocortex가 맡습니다.

도구 버전과 링크는 2026년 10월에 확인했습니다. 모딩 도구는 자주 바뀌므로, 최신 릴리스는 각 프로젝트 페이지에서 확인하세요.

자주 묻는 질문

GTA 5에 AI NPC를 추가할 수 있나요?

네, 스토리 모드에서 가능합니다. Script Hook V .NET 스크립트는 플레이어 주변에서 일어나는 일을 읽고, 웹 API로 AI 캐릭터에 보내고, 응답을 자막으로 보여 줄 수 있습니다. Neocortex가 캐릭터, 그 음성, 돌려주는 행동을 제공하므로, 모드는 게임 로직만 처리하면 됩니다.

GTA 5 AI 모드는 Enhanced 에디션에서도 작동하나요?

Script Hook V는 현재의 Legacy와 Enhanced 패치를 지원하며, ScriptHookVDotNetEnhanced는 두 에디션 모두에서 .NET 스크립트를 실행합니다. Neocortex 모드는 HTTP, 텍스트, 오디오만 필요하므로 같은 스크립트를 Legacy와 Enhanced 모두에 맞출 수 있습니다.

음성 명령으로 GTA 5를 조작할 수 있나요?

네. 스크립트는 택시 부르기나 라디오 바꾸기 같은 게임 행동에 말한 문장을 연결할 수 있습니다. Neocortex Voice Commands는 플레이어의 PC에서 실행되며, 자연스러운 표현을 이해하고, 클라우드 왕복 없이 일치한 명령을 즉시 돌려줍니다.

AI NPC 모드 때문에 GTA 5에서 계정이 정지될 수 있나요?

Rockstar의 PC 모드 정책은 비상업 싱글플레이어 모드를 용인하지만, GTA Online은 금지 대상이며 그곳에 모딩하면 계정이 정지될 수 있습니다. Rockstar의 2026년 모드 가이드라인은 멀티플레이어 모딩을 Creator Platform으로 제한하고, 캐릭터의 새 대사나 성우 음성 재사용을 금지합니다. Neocortex 모드는 스토리 모드에 두고, 독창적인 캐릭터와 음성을 쓰며, GTA Online에서는 절대 로드하지 마세요.

GTA 5 모더에게 Neocortex 비용은 얼마인가요?

유료 요금제는 월 €9부터 시작하며, AI 캐릭터, Conversation Flow, API가 포함됩니다. 모드 코드를 쓰기 전에 브라우저에서 캐릭터를 테스트할 수 있습니다.

비슷한 글

더 읽어 보기