Neocortex Logo

Half-Life 2 AI NPC 모드: 음성 명령 분대와 동료

Source SDK 2013으로 만드는 Half-Life 2 AI NPC 모드를 계획합니다. 음성으로 지휘하는 반군 분대, 말로 응답하는 동료, 안전가옥의 스토리 장면, 퀴즈 단말기를 다룹니다.

Neocortex TeamThe team behind Neocortex

· 6분 분량

Source SDK 2013으로 만드는 Half-Life 2 AI NPC 모드를 계획합니다. 음성으로 지휘하는 반군 분대, 말로 응답하는 동료, 안전가옥의 스토리 장면, 퀴즈 단말기를 다룹니다.

Half-Life 2의 분대 AI는 키 입력에 반응하고, 세계의 사람들은 스크립트가 허락한 말만 합니다. 반군은 따라오지만 그들에게 아무것도 말할 수 없습니다. 시민들은 이야기하지만, 방금 일어난 일에 대해서는 결코 말하지 않습니다. Half-Life 2 AI NPC 모드는 이 두 가지를 고칩니다. 명령을 목소리로 내리면 반응하는 반군, 방금 치러낸 전투에 대해 이야기하는 동료, 그리고 플레이어의 선택에 따라 휘어지는 스토리 장면이 생깁니다. Neocortex는 AI 캐릭터, 대화 흐름, 퀴즈, 기기 내 음성 명령을 제공하고, Source SDK 2013은 이를 연결하는 코드를 제공합니다.

Half-Life 2 게임 화면 스크린샷 스크린샷: Half-Life 2 © Valve

반군 분대를 위한 음성 명령

Half-Life 2에서는 이미 분대를 지정한 지점으로 보내고 다시 불러들일 수 있습니다. 음성 명령은 키 입력을 말로 대신합니다. "앞으로 가", "여기서 대기", "차 뒤에 엄폐해", "나한테 모여" 같은 식입니다.

Neocortex 대시보드에서 명령 세트를 행위자, 동작, 대상으로 설계합니다. 행위자는 "squad", 동작은 "move", "hold", "cover", 대상은 "me", "car", "door" 같은 식입니다. 플레이어는 자연스럽게 말하고, 모드는 일치하는 명령을 즉시 받습니다. 한 문장에 여러 동작과 수량이 들어 있어도 됩니다. "두 명은 문을 지키고, 나머지는 나를 따라와"처럼요. 코드는 이를 기존 분대 코드에 연결합니다.

누르고 말하기 방식이나 항상 듣기 방식으로 동작하고, 여러 언어를 지원하며, 플레이어의 기기에서 실행됩니다. 그래서 총격전 한가운데서도 클라우드 왕복 없이 명령이 바로 전달됩니다.

Voice Commands는 라이선스가 있는 SDK입니다. Voice Commands 라이선스 문의를 이용하십시오.

실제 예시: Mara Venn과 안전가옥

동료. Mara Venn이라는 독창적인 동료를 만들어 봅시다. 진료소가 폐쇄된 뒤 저항군에 합류한 전직 야전 의무병입니다. 모드는 플레이어의 질문과 함께 게임이 아는 정보를 보냅니다. 근처의 오브젝트(바리케이드, 탄약 상자, 무전기)와 최근 이벤트("분대원 둘 쓰러짐", "플레이어가 왼쪽 터널을 택함", "체력 30 미만")입니다. Mara는 음성으로 답하고, 모든 대사에 감정 태그를 붙이며, 구급 키트를 건네거나 플레이어가 요청한 문을 여는 등의 행동을 반환할 수 있습니다.

분대가 되받아칩니다. 그룹 채팅(Pro 및 Team 요금제)을 쓰면 최대 여섯 명의 캐릭터가 하나의 대화를 나눌 수 있으므로, 분대 전체가 다음 행동을 두고 다툴 수 있습니다.

지하실. Mara는 플레이어를 지하실 안전가옥으로 데려갑니다. 그곳에서 플레이어는 경계하는 조직 우두머리의 신뢰를 얻어야 도시 밖으로 나가는 경로를 알려 줍니다. 대화 흐름이 단계를 정의합니다. 자기소개, 어느 편인지 증명하기, 거래, 경로입니다. 캐릭터는 플레이어가 어떤 말을 하든 이 단계를 따라 대화를 이끌고, API는 TRUST_EARNED나 ROUTE_SHARED 같은 체크포인트 키워드를 반환합니다. 모드는 이에 반응해 숨겨진 문을 열거나, 밖으로 안내할 가이드를 등장시킵니다.

단말기. 구석의 단말기는 신병을 훈련합니다. 피해야 할 적 부대, 분대에 신호를 보내는 법, 챙겨야 할 보급품 등입니다. Neocortex 퀴즈 엔진(Team 요금제)이 문제와 점수를 처리하고, 정답이 연속되면 탄약이나 지름길을 보상으로 줄 수 있습니다.

Half-Life 2 게임 화면 스크린샷 스크린샷: Half-Life 2 © Valve

Half-Life 2 AI NPC 모드를 위한 Source SDK 2013 분기

Half-Life 2는 Source 위에서 돌아갑니다. 모드는 자체 gameinfo.txt, 콘텐츠, Valve의 코드로 빌드한 두 개의 C++ 라이브러리가 들어 있는 폴더입니다. 서버 DLL은 NPC AI, 분대, 게임 로직을, 클라이언트 DLL은 HUD, VGUI 패널, 로컬 효과를 담당합니다. 무엇보다 먼저 기반을 고르십시오.

기반담고 있는 내용상태
Source SDK 2013 singleplayer 브랜치Half-Life 2 싱글플레이어 코드2015년 이후 코드 업데이트 없음; 32비트 Source SDK Base 2013 Singleplayer에서 실행
Source SDK 2013 master 브랜치멀티플레이어 코드2025년 2월 Team Fortress 2 게임 코드와 64비트 빌드로 업데이트됨; Valve가 여전히 커밋함
Mapbase커뮤니티가 관리하는 싱글플레이어 모드용 기반버전 8.0은 2025년 7월에 출시되었으며, 새 엔티티, 수정 사항, 맵 스크립트용 VScript 구현을 추가함

위의 안전가옥 같은 스토리 모드라면 singleplayer 브랜치나 Mapbase에서 시작하십시오.

Source DLL에서 Neocortex 호출하기

SDK 헤더에는 Steamworks HTTP 인터페이스가 포함되어 있으며, 많은 모더는 대신 libcurl을 추가합니다. 어느 쪽이든 요청은 워커 스레드에서 실행하고, 결과는 게임 루프로 되돌려 보내십시오. 클라이언트 또는 서버 DLL에서 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
}

모드는 게임 상태를 읽고 이를 플레이어의 메시지와 함께 /v3/chat을 통해 Neocortex 캐릭터에 보냅니다. 응답은 자막으로 보여 주고, 음성은 /v3/audio/generate 또는 /v3/audio/stream에서 재생하며, 캐릭터가 반환한 행동을 실행합니다. 대화 흐름은 같은 응답에서 체크포인트 키워드(flowState)를 반환하고, 퀴즈 엔진은 /v3/quiz로 실행됩니다. 기기 내 음성 명령은 Neocortex Voice Commands가 플레이어의 기기에서 실행되면서, 말한 문구를 클라우드 왕복 없이 게임 동작으로 바꿉니다.

UI는 클라이언트 DLL의 VGUI 패널로 자막과 퀴즈 화면을 보여 줄 수 있습니다. Source의 자막(closed captions)과 사운드 스크립트(soundscripts)는 미리 만들어 둔 대사를 위한 기능이므로, 실시간 AI 응답에는 보통 별도의 자막 패널을 두고, 생성된 오디오는 파일로 저장해 엔진을 통해 재생합니다.

출시 전에: Source 1 SDK 라이선스

Source 1 SDK 라이선스는 모드를 무료로만 배포하도록 허용합니다. 무료 모드는 Steam에 게시할 수 있습니다. AI NPC 모드는 싱글플레이어로 유지하고, 규정에 어긋나게 멀티플레이어 서버에서 쓰지 마십시오. 각 플레이어가 자신의 Neocortex API 키를 쓰게 하십시오.

빈 맵에서 말하는 분대까지

  1. Source SDK 2013을 설정합니다. 스토리 모드라면 singleplayer 브랜치나 Mapbase를 고르고, 빌드한 뒤 빈 테스트 맵을 실행하십시오.
  2. Neocortex 대시보드에서 캐릭터를 설계합니다. 동료, 대화 흐름이 있는 조직 우두머리, 단말기용 퀴즈, 분대용 명령 세트를 만드십시오.
  3. 게임 DLL에서 워커 스레드를 통해 API를 호출하고, 각 응답의 sessionId를 재사용하십시오.
  4. API 키는 플레이어가 채우는 설정 파일에 보관하십시오. 공유하는 모드 안에 하드코딩하지 마십시오.
  5. 자막, 음성, 행동을 연결한 다음, 음성 명령을 기존 분대 코드에 연결하십시오.
  6. 캠페인 전체로 확장하기 전에 싱글플레이어에서 맵 하나로 테스트하십시오.

모드에서 음성 명령이 어떻게 작동하는지 보려면 게임 모드를 위한 기기 내 음성 명령을 읽으십시오. GoldSrc는 Half-Life AI NPC 모드 가이드를, Source 샌드박스 서버는 Garry's Mod AI NPC 및 퀴즈 애드온 글을 참고하십시오. Mara와 분대는 첫 맵이 컴파일되기 한참 전에도 오늘 Neocortex 브라우저 편집기에서 테스트할 수 있습니다.

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

자주 묻는 질문

Half-Life 2에 AI NPC를 추가할 수 있나요?

네. Half-Life 2 모드는 Valve의 Source SDK 2013으로 만들며, 이 SDK는 전체 C++ 게임 코드를 제공합니다. 그래서 모드가 웹 API를 호출하고 응답에 따라 행동할 수 있습니다. Neocortex는 AI 캐릭터, 그 음성, 그가 반환하는 행동을 제공하고, 모드는 이를 실행합니다.

Source SDK 2013의 싱글플레이어와 멀티플레이어 브랜치 중 무엇을 써야 하나요?

스토리 모드는 보통 싱글플레이어 브랜치나, 그것을 기반으로 한 Mapbase 같은 커뮤니티 기반에서 시작합니다. 멀티플레이어 브랜치는 2025년에 64비트 지원을 포함한 큰 업데이트를 받았고 아직 관리되고 있지만, 코드는 멀티플레이어 게임을 대상으로 합니다. Neocortex는 평범한 웹 API이므로 둘 중 어느 쪽과도 작동합니다.

Half-Life 2 반군에게 음성으로 명령할 수 있나요?

모드를 만들면 가능합니다. Half-Life 2에는 이미 분대 명령 코드가 있으며, 모드는 음성으로 그것을 실행할 수 있습니다. Neocortex Voice Commands는 플레이어의 PC에서 자연스러운 문구를 맞추므로, "앞으로 가", "여기서 대기", "모여" 같은 말이 오프라인으로 즉시 코드에 전달됩니다.

AI 캐릭터가 들어간 Half-Life 2 모드를 팔 수 있나요?

아니요. Source 1 SDK 라이선스는 모드를 무료로만 배포하도록 허용합니다. 무료 모드는 Steam에 게시할 수 있습니다. 무료 모드의 Neocortex 쪽은 브라우저 편집기에서 만들고 테스트할 수 있습니다.

비슷한 글

더 읽어 보기