Neocortex Logo

Cyberpunk 2077 AI NPC 모드: 말하는 픽서와 음성 명령

Neocortex로 Cyberpunk 2077 AI NPC 모드를 만드는 방법입니다. 대화할 수 있는 상인과 픽서, 차량과 홀로 통화를 위한 음성 명령, CET를 쓰는 네트러너 퀴즈를 다룹니다.

Neocortex TeamThe team behind Neocortex

· 6분 분량

Neocortex로 Cyberpunk 2077 AI NPC 모드를 만드는 방법입니다. 대화할 수 있는 상인과 픽서, 차량과 홀로 통화를 위한 음성 명령, CET를 쓰는 네트러너 퀴즈를 다룹니다.

Night City에는 사람이 많지만, 대화를 나눠 줄 사람은 거의 없습니다. 노점 앞에 멈춰 설 수는 있어도 무엇이든 물어볼 수는 없습니다. Neocortex로 만든 Cyberpunk 2077 AI NPC 모드는 이 문제를 해결합니다. 거리의 상인과 픽서가 플레이어에게 자기 말로 답하고, 차량과 홀로 통화는 음성 명령에 반응하며, 뒷방의 네트러너가 퀴즈를 진행합니다. 이 가이드는 먼저 완전한 의뢰 하나를 따라가고, 나머지를 설명합니다.

Cyberpunk 2077 게임 내 스크린샷 스크린샷: Cyberpunk 2077 © CD PROJEKT RED

이 Cyberpunk 2077 AI NPC 모드 가이드의 대상

Lua나 컴파일형 스크립트 언어를 다룰 수 있고, 대화하는 NPC를 원하는 PC 모더를 위한 글입니다. Cyber Engine Tweaks 모드를 설치해 본 적이 있다면 아래 스택의 대부분은 이미 아는 내용입니다. 처음이라면 Cyberpunk 2077 모딩 위키에 모든 것이 정리되어 있습니다.

Cyberpunk 2077 모딩 스택

Cyberpunk 2077에는 성숙한 커뮤니티 프레임워크가 여럿 있습니다.

  • Cyber Engine Tweaks(CET)는 Lua로 모드를 작성할 수 있게 하며, 게임 타입과 함수, 콘솔, 프로토타입 UI에 편리한 Dear ImGui 오버레이에 접근할 수 있습니다. RED4ext가 필요합니다.
  • **RED4ext**는 네이티브 C++ 플러그인을 불러오고 엔진을 확장하는 SDK를 제공하는 스크립트 익스텐더입니다.
  • **Redscript**는 게임의 스크립트 런타임에서 동작하는 컴파일형 스크립트 언어로, 게임 클래스를 직접 후킹할 수 있습니다.
  • **ArchiveXL**은 기존 파일을 바꾸지 않고 새로운 외형이나 UI 에셋 같은 커스텀 리소스를 불러옵니다.
  • **RedHttpClient**는 Redscript와 CET에서 HTTPS 요청을 보내는 RED4ext 플러그인입니다. RedData가 JSON을 지원합니다. 둘을 합치면 말하는 NPC에 필요한 웹 요청 계층이 됩니다.

자막은 CET 오버레이에서 시작해 Redscript로 게임 기본 위젯과 비슷한 것으로 옮길 수 있습니다. 생성된 음성은 네이티브 오디오 재생이 필요하며, 이는 네트워크 코드 옆의 RED4ext 플러그인에서 처리해야 합니다. 커뮤니티 모드가 이미 CET를 통해 채팅 AI를 Night City에 연결해 두었으니, 이 스택으로도 충분히 가능하다는 뜻입니다.

Rook Varga와 함께하는 의뢰, 처음부터 끝까지

Rook Varga는 카부키의 뒷방에서 일하는 오리지널 픽서로, 플레이어를 살펴본 뒤 일을 제안합니다. Neocortex 노드 에디터에서 Rook에게는 Personality, Emotion 프로필, Knowledge, Voice, 그리고 모드가 처리하는 Actions를 줍니다. Redscript를 한 줄 쓰기 전에 브라우저에서 대화 전체를 테스트할 수 있습니다.

Conversation Flow는 Rook이 사이드 의뢰에서 벗어나지 않게 붙잡아 줍니다. 제안, 흥정, 거래, 보수 지급의 순서입니다. 플레이어는 자유롭게 말할 수 있고, 각 단계는 Redscript 코드가 반응하는 체크포인트 키워드(flowState)를 돌려줍니다.

모드는 각 대사를 최근 사건("플레이어가 Tyger Claws를 막 물리침", "스트리트 크레드가 올랐음")과 자판기나 주차된 차 같은 근처 오브젝트와 함께 /v3/chat으로 보냅니다. RedHttpClient와 RedData를 쓴 Redscript 호출은 다음과 같을 수 있습니다.

import RedHttpClient.*
import RedData.Json.*

public class FixerChat {
  let apiKey: String; // read from the player's config file
  let sessionId: String;
  public func Say(characterId: String, line: String) {
    let ids = new JsonArray();
    ids.AddItemString(characterId);
    let body = new JsonObject();
    body.SetKey("characterIds", ids);
    body.SetKeyString("message", line);
    body.SetKeyString("playerId", "player-1");
    body.SetKeyString("sessionId", this.sessionId);
    let headers: array<HttpHeader> = [HttpHeader.Create("x-api-key", this.apiKey)];
    AsyncHttpClient.PostJson(HttpCallback.Create(this, n"OnReply"), "https://api.neocortex.link/v3/chat", body, headers);
  }
  private cb func OnReply(response: ref<HttpResponse>, data: array<Variant>) {
    let reply = response.GetJson() as JsonObject;
    this.sessionId = reply.GetKeyString("sessionId"); // then read "messages" for lines and actions
  }
}

응답은 모드가 자막으로 보여 주는 대사로 돌아오며, /v3/audio/generate 또는 /v3/audio/stream의 음성으로 재생됩니다. 각 대사에는 ANGRY나 CURIOUS 같은 감정 태그가 붙고, { "name": "OPEN_DOOR", "targetId": "door_02" }나 SHOW_SHOP 같은 행동은 모드가 무엇을 실행할지 알려 줍니다.

Cyberpunk 2077 게임 내 스크린샷 스크린샷: Cyberpunk 2077 © CD PROJEKT RED

상인, 음성, 네트러너 퀴즈

카부키의 국수 상인

카부키에서 골목의 모든 소문을 아는 국수 상인부터 시작하세요. 성격 유형, 감정 프로필, 지역 갱단과 물가, 가십을 담은 TXT 파일에서 가져온 Knowledge 베이스를 주세요. Rook을 움직이는 같은 채팅 호출이 이 상인도 움직입니다.

차량과 홀로 통화 명령

액터("car", "phone", "radio"), 행동("bring", "call", "open", "play"), 대상("my car", "my fixer", "the trunk", "the next station")으로 명령 세트를 설계하세요. 플레이어가 "차 가져와"나 "트렁크 열고 픽서한테 전화해"라고 말하면, 모드는 한 문장의 여러 행동까지 포함해 깔끔한 명령을 받습니다. 푸시투토크나 항상 듣기 모두 가능하며, 플레이어의 기기에서 Neocortex Voice Commands 라이브러리로 동작합니다. 인터넷 없이, 여러 언어로, 클라우드 왕복 없이 작동합니다. 접근 방식은 게임 모드용 기기 내 음성 명령 글에서 설명합니다. Voice Commands는 라이선스가 필요한 SDK입니다. Voice Commands 라이선스 문의하기.

애프터라이프의 Sable 퀴즈

애프터라이프의 테이블에서 오리지널 네트러너 Sable이 퀵해킹, 사이버웨어, 나이트 시티의 기업들에 대한 퀴즈를 진행합니다. 질문 세트는 Neocortex 대시보드에 있고, 퀴즈 엔진(Team 요금제)이 /v3/quiz를 통해 질문, 점수, 리더보드를 처리합니다. 깔끔하게 끝낸 플레이에는 모드가 eddies를 지급합니다.

패치, CDPR의 규칙과 공정한 플레이

주요 게임 패치는 핵심 프레임워크를 망가뜨릴 수 있습니다. 업데이트 뒤에는 프레임워크 페이지를 확인하고, 별도의 세이브에서 다시 테스트하세요.

CD Projekt Red의 팬 콘텐츠 가이드라인은 게임의 EULA를 존중하는 모드를 허용하며, 모드 판매와 유료 장벽 뒤에 두는 것은 금지합니다. Cyberpunk 2077은 싱글플레이 게임이므로, 모드는 무료이고 비상업적이어야 하며 다른 사람의 게임에 들어가지 않아야 합니다. 디자인된 음성이나 권리를 가진 음성만 쓰고, 각 플레이어가 자신의 Neocortex API 키를 쓰게 하세요.

다음 단계

  1. 프레임워크 설치하기: RED4ext, Cyber Engine Tweaks, Redscript, 그리고 네트워크와 JSON을 위한 RedHttpClient와 RedData.
  2. Neocortex 노드 에디터에서 Rook을 설계하고 브라우저에서 의뢰를 테스트하세요.
  3. 원하는 기능을 추가하세요: 의뢰의 Conversation Flow, Sable의 퀴즈 질문 세트, 차량과 전화 명령 세트.
  4. Redscript나 CET에서 연결하고, CET 창에서 자막을 프로토타입한 뒤 UI를 다듬으세요.
  5. API 키는 플레이어가 각자 채우는 설정 파일에 보관하세요. 공유하는 모드에는 키를 절대 넣지 마세요.
  6. 별도의 세이브에서 테스트하고, 게임 패치마다 다시 테스트하세요.

기초 글인 게임 모드용 기기 내 음성 명령부터 시작하고, 같은 아이디어가 Fallout 4 AI NPC 모드 가이드에서 어떻게 동작하는지 보세요. 모든 게임을 보려면 AI NPC와 음성 명령 모드 목록을 참고하세요. 그다음 Neocortex 에디터를 열고 Rook에게 목소리를 주세요.

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

자주 묻는 질문

Cyberpunk 2077에 AI NPC를 추가할 수 있나요?

네, PC에서 가능합니다. Cyber Engine Tweaks, Redscript, RED4ext로 만든 모드는 플레이어의 말과 게임 이벤트를 AI 서비스로 보내고, 답을 게임 안에 보여 줄 수 있습니다. Neocortex는 하나의 API로 캐릭터, 음성, Conversation Flow, 퀴즈를 제공합니다.

Cyberpunk 2077 모드가 웹 요청을 할 수 있나요?

네, 도우미 플러그인을 쓰면 됩니다. RedHttpClient 같은 커뮤니티 RED4ext 플러그인은 Redscript와 Cyber Engine Tweaks 모드에 HTTPS 요청을 추가합니다. 모드가 Neocortex API와 통신하는 데 필요한 것이 바로 그것입니다.

Cyberpunk 2077에서 차를 음성 명령으로 움직일 수 있나요?

모드를 쓰면 가능합니다. Neocortex Voice Commands는 플레이어의 PC에서 인터넷 없이 실행되며, "차 가져와"나 "픽서한테 전화해" 같은 구문을 게임 행동으로 바꿉니다. Voice Commands는 라이선스가 필요한 SDK이므로 라이선스는 문의하세요.

CD Projekt Red는 Cyberpunk 2077 모드를 허용하나요?

네. CD Projekt Red의 팬 콘텐츠 가이드라인은 게임의 EULA를 깨지 않고 판매되거나 유료 장벽 뒤에 있지 않은 모드를 허용합니다. Neocortex 기반 모드는 무료여야 하며, 각 플레이어가 자신의 API 키를 써야 합니다.

Cyberpunk 2077 모드는 게임 패치 뒤에 깨지나요?

깨질 수 있습니다. 큰 패치는 Cyber Engine Tweaks, RED4ext, Redscript의 업데이트된 버전을 요구하는 경우가 많으므로, 업데이트 뒤에는 각 프레임워크 페이지를 확인하세요. Neocortex 캐릭터는 클라우드에 있으므로 게임 버전에 따라 바뀌지 않습니다.

비슷한 글

더 읽어 보기