Neocortex Logo

GTA 4 AI NPC 모드: AI 전화, 택시 여행, 음성 명령

IV-SDK .NET과 Neocortex로 GTA 4 AI NPC 모드 만들기: AI 캐릭터와의 전화 통화, 음성으로 조작하는 택시 여행, 리버티 시티 퀴즈.

Neocortex TeamThe team behind Neocortex

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

IV-SDK .NET과 Neocortex로 GTA 4 AI NPC 모드 만들기: AI 캐릭터와의 전화 통화, 음성으로 조작하는 택시 여행, 리버티 시티 퀴즈.

그렇습니다. 리버티 시티의 캐릭터와 진짜 대화를 나눌 수 있습니다. GTA 4 AI NPC 모드는 IV-SDK .NET 위에서 도는 C# 스크립트로, 플레이어가 한 말을 AI 캐릭터에게 보내고 그 답을 음성으로 재생합니다. GTA IV는 사람을 중심으로 만들어졌습니다. 최악의 순간에 전화하는 사촌, 볼링 치러 가자는 친구, 의견이 많은 택시 기사들이 있습니다. 이런 모드는 같은 세 줄만 반복하는 대신, 플레이어가 이끄는 곳으로 대화가 흘러가게 해 줍니다. Neocortex는 스크립트에 음성과 행동을 갖춘 AI 캐릭터, 대화 흐름, 퀴즈, 기기 내 음성 명령을 제공합니다.

Grand Theft Auto IV: The Complete Edition 게임 내 스크린샷 스크린샷: Grand Theft Auto IV: The Complete Edition © Rockstar Games

코드를 쓰기 전에: 다운그레이드

IV-SDK .NET은 GTA IV 1.0.8.0과 1.0.7.0만 지원합니다. 현재 Steam과 Rockstar Games Launcher 배포판인 Complete Edition은 먼저 다운그레이드해야 합니다. 예를 들어 IV-SDK .NET 문서가 안내하는 GTA IV Downgrader를 쓸 수 있습니다. 많은 스크립트 모더는 1.0.8.0을 선택합니다.

Complete Edition에 그대로 머물러야 한다면, CLEO Redux가 1.2.0.43과 1.2.0.59 빌드를 JavaScript 스크립트로 지원합니다. 단순한 트리거에 적합한 가벼운 방법입니다.

GTA 4 AI NPC 모드를 위한 도구

게임이 지원되는 버전에 있으면 세 가지가 중요합니다.

  • **Ultimate ASI Loader**는 네이티브 .asi 플러그인을 불러오며, IV-SDK .NET의 전제 조건입니다.
  • **IV-SDK .NET**은 .NET Framework 4.7.2 이상에서 C# 또는 VB.NET으로 쓴 스크립트를 실행합니다. 최신 릴리스는 1.9.1(2025년 6월)입니다. 스크립트는 IVSDKDotNet/scripts 폴더의 .ivsdk.dll 파일이며, 게임 내 콘솔과 관리자에서 다시 불러올 수 있습니다.
  • ScriptHookDotNet은 오래된 .NET 스크립트 후크로, 여전히 많은 이전 모드를 구동합니다. IV-SDK .NET은 ScriptHookDotNet 스크립트도 불러올 수 있으므로(실험 기능이며 계속 개선 중), 둘 중 하나를 고를 필요가 없습니다.

IV-SDK .NET 스크립트 안에서는 Tick을 구독하고, 플레이어와 월드를 읽고, .NET Framework가 제공하는 모든 것을 쓸 수 있습니다. 웹 요청에는 HttpClient, 음성 재생에는 NAudio 같은 오디오 라이브러리, .ini 파일에는 SDK의 SettingsFile 클래스를 씁니다. ShowSubtitleMessage는 화면에 텍스트를 띄우고, 통화 기록 창처럼 더 정교한 것은 SDK의 ImGui 지원으로 만들 수 있습니다.

리버티 시티를 위한 세 가지 빌드

AI 친구와의 전화

GTA IV는 전화를 사회생활의 중심으로 만들었습니다. 그 정신을 살려 자신만의 캐릭터를 만드세요. 로만이나 Rockstar의 다른 출연진이 아니라 독자적인 캐릭터여야 합니다. 예를 들어 브로커에서 고철 야적장을 운영하는, 목소리가 크고 지나치게 낙관적인 사촌 같은 인물입니다.

스크립트는 무작위 순간에 전화를 울리고, 방금 일어난 일("플레이어가 경찰차에 부딪혔다", "수배 레벨 3", "새벽 4시이고 비가 온다")을 캐릭터에게 보냅니다. 플레이어는 음성으로 답하고, 음성 인식이 이를 메시지로 바꾸며, 캐릭터는 자막과 오디오로 답하고, 전화 애니메이션에 연결할 수 있는 감정 태그를 붙입니다.

대화 흐름으로 감싸면 통화에 방향이 생깁니다. 따라잡기, 계획 세우기, 만나기로 합의하기입니다. 흐름이 AGREED_TO_MEET 같은 체크포인트에 도달하면 API가 flowState에 그 키워드를 돌려주고, 스크립트는 약속 장소에 블립을 찍습니다.

말로 조작하는 택시 여행

택시를 불러 목적지를 그냥 말하세요. "웨이포인트로 데려다 줘", "더 빨리 가", "그냥 내릴게". Neocortex 음성 명령을 쓰면 스크립트가 일치한 명령을 받아 실행하며, 플레이어가 여러 명령을 이어 말하면 문장당 여러 개도 처리합니다.

운전사도 AI 캐릭터일 수 있습니다. 지나가는 지역과 시간대를 알려 주면 알곤퀸의 교통, 날씨, 어젯밤 토한 승객 이야기를 합니다. { "name": "STOP_HERE" } 같은 행동을 돌려보내면 탑승을 일찍 끝낼 수 있습니다.

얼더니의 퀴즈 나이트

얼더니의 술집이나 가상의 심야 라디오 쇼에 퀴즈 진행자를 두세요. 퀴즈 엔진(Team 요금제)은 대시보드에서 만든 문제 세트를 실행하고, 점수를 기록하고, 리더보드를 유지하며, 진행자는 맞고 틀린 답에 캐릭터처럼 반응합니다. 스크립트에서 실행하려면 두 종류의 호출이 필요합니다.

static readonly HttpClient Http = new HttpClient();

// Start:  new { characterId = "QUIZ_HOST_ID", questionSetId = "LIBERTY_CITY_SET" }
// Answer: new { sessionId = quizSessionId, say = playerAnswer }
static async Task<string> QuizCall(string apiKey, object payload)
{
    var req = new HttpRequestMessage(HttpMethod.Post, "https://api.neocortex.link/v3/quiz");
    req.Headers.Add("x-api-key", apiKey); // loaded from the mod's .ini
    req.Content = new StringContent(JsonConvert.SerializeObject(payload), Encoding.UTF8, "application/json");
    var res = await Http.SendAsync(req);
    return await res.Content.ReadAsStringAsync(); // keep the sessionId for the next answer
}

Grand Theft Auto IV: The Complete Edition 게임 내 스크린샷 스크린샷: Grand Theft Auto IV: The Complete Edition © Rockstar Games

Neocortex가 스크립트에 연결되는 지점

기능출처스크립트가 하는 일
대화/v3/chat, 그다음 /v3/audio/generate 또는 /v3/audio/stream플레이어의 말과 함께 게임 상태를 보내고, 응답을 자막으로 보여 주고, 음성을 재생하며, 돌아온 행동을 실행
대화 흐름flowState의 체크포인트 키워드통화나 모임을 여러분의 단계에 따라 이끌고, 체크포인트 키워드에 반응
퀴즈/v3/quiz질문과 답 게임, 점수 계산, 리더보드 실행
음성 명령플레이어의 PC에서클라우드 왕복 없이 말한 구문을 게임 행동으로 변환

음성 명령은 대시보드에서 명령 세트를 액터("택시 기사"), 행동("drive", "stop", "skip"), 오브젝트("waypoint", "here")로 설계합니다. 누르고 말하기 또는 항상 듣기, 여러 언어를 지원합니다. 음성 명령은 라이선스가 있는 SDK입니다. 음성 명령 라이선스 문의.

빌드 순서

  1. GTA IV를 1.0.8.0으로 다운그레이드한 뒤 Ultimate ASI Loader와 IV-SDK .NET을 설치합니다.
  2. Neocortex 시각 편집기에서 캐릭터, 흐름 또는 퀴즈를 설계합니다. 성격, 감정, 리버티 시티에 관한 지식, 음성을 설정하고 브라우저에서 테스트합니다.
  3. IV-SDK .NET을 참조하고 .ivsdk.dll로 빌드하는 C# 클래스 라이브러리를 만듭니다.
  4. 게임 스레드 밖에서 HttpClient로 스크립트를 연결하고, Tick에서 자막을 띄우고 오디오를 재생합니다.
  5. API 키는 .ini 파일에 보관하고, 각 플레이어가 자신의 키를 넣도록 합니다.
  6. 여분의 세이브 파일로 싱글 플레이에서 테스트합니다.

싱글 플레이로 유지하기

Rockstar의 PC 싱글 플레이 모드 정책은 Take-Two가 대체로 싱글 플레이, 비상업, 제3자 IP를 존중하는 프로젝트에 대해 조치하지 않는다고 밝히며, 새로운 스토리, 미션, 맵은 제외합니다. Rockstar의 최신 모드 가이드라인은 모든 게임에 적용되며, 더 엄격한 선을 추가합니다. Rockstar의 스토리라인, 미션, 캐릭터를 확장하거나 수정하지 말 것, 그리고 Rockstar의 성우 연기를 수정하거나 재사용하지 말 것입니다. 멀티플레이 모딩은 Rockstar Creator Platform으로 제한되며, 그 밖의 모든 것은 비상업적으로 남아야 합니다. 가이드라인은 스스로 라이선스가 아니라고도 밝힙니다.

AI 모드라면 니코, 로만과 나머지 출연진은 Rockstar가 쓴 그대로 남아야 합니다. 주변 통화, 택시 여행, 퀴즈는 여러분 자신의 캐릭터로 만드세요. Rockstar 배우를 복제한 목소리가 아니라 원본 Neocortex 목소리나 권리가 있는 목소리를 주고, 모드는 비상업적으로, 멀티플레이 밖에 두고, 각 플레이어가 자신의 Neocortex API 키를 쓰게 하세요.

결론

GTA 4 AI 모드에서 어려운 부분은 대화가 아니라 다운그레이드입니다. IV-SDK .NET이 돌아가면 HttpClient 호출 하나로 리버티 시티와 Neocortex 캐릭터가 연결되며, 전화, 택시, 바 퀴즈 모두 같은 패턴을 따릅니다. 다른 Rockstar 게임은 GTA 5 AI NPC 모드와 GTA 산 안드레아스와 바이스 시티 가이드를 보세요. 음성 쪽은 모더를 위한 기기 내 음성 명령 글을 읽으세요.

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

자주 묻는 질문

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

네. IV-SDK .NET에서 실행되는 C# 스크립트는 게임 상태를 읽고, 웹 API를 호출하고, 리버티 시티에 자막을 띄울 수 있습니다. Neocortex는 AI 캐릭터와 그 음성, 감정, 행동을 제공하므로, 스크립트는 그 부분들을 연결하기만 하면 됩니다.

스크립트 모드를 쓰려면 GTA 4를 다운그레이드해야 하나요?

.NET 스크립트 모드라면 보통 그렇습니다. IV-SDK .NET은 게임 버전 1.0.7.0과 1.0.8.0을 지원하므로 Complete Edition은 먼저 다운그레이드해야 합니다. 그렇게 하면 Neocortex 캐릭터도 다른 스크립트 기능과 똑같이 작동합니다.

GTA 4에서 NPC와 목소리로 대화할 수 있나요?

네. 음성 인식이 플레이어의 목소리를 AI 캐릭터에게 보낼 메시지로 바꾸고, Neocortex 음성 명령은 "웨이포인트로 데려다 줘" 같은 짧은 명령을 클라우드를 거치지 않고 플레이어의 PC에서 처리합니다.

GTA 4 AI 모드는 ScriptHookDotNet 모드와 함께 작동하나요?

IV-SDK .NET은 ScriptHookDotNet 스크립트도 불러올 수 있으므로(실험적이지만 개선 중), 다운그레이드된 게임에서 오래된 모드와 새 Neocortex 스크립트가 나란히 실행될 수 있습니다.

GTA 4 모더에게 Neocortex는 얼마인가요?

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

비슷한 글

더 읽어 보기