Neocortex Logo

Half-Life AI NPC 모드: 말하는 과학자와 음성 명령

HL SDK나 Xash3D FWGS로 Half-Life AI NPC 모드를 만드는 방법입니다. 말을 걸 수 있는 과학자와 경비원, 경비원을 위한 음성 명령, Black Mesa 안전 퀴즈를 다룹니다.

Neocortex TeamThe team behind Neocortex

· 7분 분량

HL SDK나 Xash3D FWGS로 Half-Life AI NPC 모드를 만드는 방법입니다. 말을 걸 수 있는 과학자와 경비원, 경비원을 위한 음성 명령, Black Mesa 안전 퀴즈를 다룹니다.

진짜 질문을 할 수 있다면 Black Mesa의 과학자는 무엇이라고 답할까요? 원작에서는 새로운 대답이 없습니다. 모든 과학자와 보안 요원은 녹음된 대사를 몇 개씩만 가지고 있습니다. Half-Life AI NPC 모드는 이를 바꿉니다. 게임 DLL이 플레이어의 말을 AI 캐릭터에게 보내고, 그 답을 음성과 자막으로 들려줍니다. Neocortex를 쓰면 스크립트로 짠 장면을 위한 대화 흐름, 퀴즈 엔진, 경비원을 위한 기기 내 음성 명령도 함께 얻을 수 있습니다.

Half-Life 게임 내 스크린샷 스크린샷: Half-Life © Valve

Valve의 SDK 대 Xash3D FWGS

두 가지 코드 베이스가 쓰이며, Half-Life AI NPC 모드는 둘 중 어디에서든 동작합니다.

Valve의 Half-Life SDKhlsdk-portable과 함께 쓰는 Xash3D FWGS
정체클라이언트와 서버 라이브러리의 공식 소스Half-Life와 호환되는 오픈소스 엔진, 그리고 FWGS의 크로스 플랫폼 SDK 포크
실행 환경GoldSrcWindows, Linux, BSD, Android. hlsdk-portable은 GoldSrc와 Xash3D용으로 빌드
상태Valve가 2024년 10월 그 달의 Steam 패치에 맞춰 마지막으로 업데이트활발히 개발 중
빌드클라이언트 및 서버 DLLCMake 또는 waf로 같은 DLL을 빌드. 선택적인 버그 수정과 여러 커뮤니티 모드가 별도 브랜치로 유지됨
게임 데이터여러분의 Steam 사본여러분 자신의 게임 사본에 있는 valve 폴더

Valve의 SDK 라이선스는 모드를 무료로 배포하는 것만 허용합니다.

GoldSrc 모드의 구조

Half-Life는 GoldSrc에서 실행됩니다. 모드는 valve 옆에 있는 폴더이며, 맵, 모델, 사운드와 두 개의 컴파일된 C++ 라이브러리를 담습니다. 하나는 게임 로직, NPC AI, 트리거를 맡는 서버 DLL이고, 다른 하나는 HUD, 이펙트, 로컬 사운드를 맡는 클라이언트 DLL입니다.

GoldSrc에는 HTTP 클라이언트가 내장되어 있지 않으므로 모드에 직접 연결해야 합니다. Windows에서는 WinHTTP를, Linux나 Xash3D 포트도 대상으로 한다면 libcurl을 씁니다. 요청은 워커 스레드에서 실행하고 결과는 게임 루프로 넘겨서, 응답을 기다리는 동안 게임이 멈추지 않게 하세요.

자막은 클라이언트 DLL에 커스텀 HUD 요소를 그리거나, 빠르게 시작하려면 서버에서 game_text 메시지를 보내면 됩니다. 음성은 WAV 오디오를 요청해 모드의 사운드 폴더에 저장하고, 클라이언트에서 재생합니다. 필요하면 엔진이 받아들이는 형식으로 변환하세요.

등장인물 소개

Dr. Ilse Marek과 Officer Dale Ruiz

원작의 캐릭터를 재사용하지 말고 자신만의 등장인물을 만드세요. Dr. Ilse Marek은 수면 부족에 시달리는 분광학 연구원으로, 사흘 동안 연구실을 나가지 않았습니다. Officer Dale Ruiz는 9년째 같은 검문소를 지키고 있으며, 트램 시간표에 대해 할 말이 많습니다.

두 사람 모두 Neocortex 편집기에서 Personality, Emotion 설정, Knowledge 베이스를 하나씩 주세요. 연구실 절차, 테스트 챔버에 관한 소문, 누가 누구에게 돈을 빚졌는지 같은 내용을 넣습니다.

모드는 각 메시지를 맥락과 함께 보냅니다. 주변 오브젝트(연구실 문, 망막 스캐너, 건강 충전기)와 최근 사건("조명이 방금 나갔다", "플레이어가 쇠지렛대를 들고 있다")이 포함됩니다. 캐릭터는 음성으로 답하고, 모든 대사에는 CURIOUS나 ANGRY 같은 감정 태그가 붙어 표정이나 애니메이션에 연결할 수 있습니다. 또 { "name": "OPEN_DOOR", "targetId": "lab_door_03" } 같은 행동을 돌려줄 수 있으며, 게임 DLL은 플레이어가 버튼을 누른 것과 똑같이 그 문을 엽니다.

말로 명령을 받는 경비원

고전적인 Half-Life 경비원은 사용 키를 누르면 이미 플레이어를 따라옵니다. 음성 명령은 플레이어가 말로 같은 일을 하게 합니다. "따라와", "여기서 기다려", "문 열어" 같은 말이죠.

Neocortex 대시보드에서는 명령 세트를 행위자, 행동, 대상으로 설계합니다. 예를 들어 행위자 "guard", 행동 "follow", "wait", "open", 대상 "me", "door"를 정합니다. 플레이어는 자연스럽게 말하고, 모드는 일치하는 명령을 즉시 받습니다. 한 문장에 여러 명령이 있어도 됩니다. "Ruiz, 문 열고 여기서 기다려"는 두 개의 명령으로 도착합니다. 푸시투토크와 항상 듣기 모두 지원하며, 여러 언어로 동작하고, 클라우드 왕복 없이 플레이어의 컴퓨터에서 실행됩니다.

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

안전 담당관과 오리엔테이션 퀴즈

오리엔테이션 룸을 게임으로 만드세요. 안전 담당관 캐릭터가 Neocortex 대시보드에서 만든 짧은 퀴즈를 진행합니다. 표본이 격리를 벗어났을 때 무엇을 해야 하는지, 어떤 배지 색이 방사선 출입 허가를 뜻하는지, 복도에서 언제 뛰어도 되는지 같은 질문입니다.

퀴즈 엔진(Team 플랜)이 질문을 하고, 플레이어의 답을 확인하며, 점수를 기록합니다. 통과하면 모드가 다음 구역의 문을 열고, 실패하면 담당관이 안전 슬라이드쇼를 다시 보라고 돌려보냅니다.

Half-Life 게임 내 스크린샷 스크린샷: Half-Life © Valve

Neocortex가 담당하는 부분

  • 대화. 모드는 게임 상태(누가 근처에 있는지, 방금 무슨 일이 있었는지)를 읽고, 이를 플레이어의 메시지와 함께 /v3/chat을 통해 Neocortex 캐릭터에게 보냅니다. 답은 자막으로 보여 주고, /v3/audio/generate 또는 /v3/audio/stream에서 음성을 재생하며, 캐릭터가 돌려준 행동을 실행합니다.
  • 대화 흐름. 분기형 스토리 장면, 예를 들어 과학자를 설득해 보관실 문을 열게 하는 장면입니다. 캐릭터가 플레이어를 그 흐름으로 이끌고, API는 모드가 반응하는 체크포인트 키워드를 반환합니다.
  • 퀴즈. 퀴즈 엔진이 /v3/quiz를 통해 질의응답 게임을 진행하며, 점수 계산도 포함합니다.
  • 음성 명령. 기기 내 음성 명령이 말한 문구를 클라우드 왕복 없이 게임 행동으로 바꿉니다. Neocortex Voice Commands는 플레이어의 컴퓨터에서 실행됩니다.

캐릭터는 시각적 노드 편집기(Personality, Emotion, Knowledge, World, Objects, Actions, Voice 등)에서 만들고, C++를 한 줄도 쓰기 전에 브라우저에서 테스트할 수 있습니다. 다른 AI 캐릭터 도구와 비교하는 내용은 저희 비교 글에서 볼 수 있습니다.

Half-Life AI NPC 모드를 판매할 수 있나요?

아니요. Valve의 Half-Life SDK 라이선스는 모드를 소스와 바이너리 형태로 배포하는 것을 허용하지만, 무료로만 가능합니다. 상업적 사용은 Valve에 문의해야 합니다.

AI NPC 모드는 싱글플레이어에만 두고, 멀티플레이어 서버에서는 규칙에 어긋나게 쓰지 마세요. 그리고 각 플레이어가 자신의 Neocortex API 키를 쓰게 하세요.

첫 번째 맵을 만드는 단계

  1. SDK 설정. Valve의 halflife SDK나 hlsdk-portable을 클론하고, 빈 테스트 모드를 위한 클라이언트 및 서버 DLL을 빌드하세요.
  2. Neocortex 대시보드에서 캐릭터 설계. 과학자, 경비원, 퀴즈가 있는 안전 담당관, 경비원의 명령 세트를 만드세요.
  3. 게임 DLL에 HTTP 클라이언트 추가. 워커 스레드에서 /v3/chat을 호출하고, 각 응답의 sessionId를 재사용하세요.
  4. API 키는 설정 파일에. 플레이어가 채우는 설정 파일에 두고, 공유하는 모드에 하드코딩하지 마세요.
  5. 자막, 음성, 행동 연결. 그다음 경비원을 위한 음성 명령을 추가하세요.
  6. 싱글플레이어에서 작은 맵 하나로 테스트. 그 위에 전체 캠페인을 만들기 전에 확인하세요.

더 알고 싶다면 게임 모드를 위한 기기 내 음성 명령 작동 방식을 읽거나, Source 엔진에서 같은 아이디어를 쓰는 Half-Life 2 AI NPC 모드 가이드를 보세요. 게임별 가이드는 모두 AI NPC 및 음성 명령 모드 목록에 있으며, 모든 가이드는 같은 방식으로 시작합니다. C++를 쓰기 전에 Neocortex 캐릭터 하나를 만들고 브라우저에서 테스트하는 것입니다.

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

자주 묻는 질문

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

네. Half-Life 모드는 Valve의 Half-Life SDK로 만드는 C++ 게임 DLL이므로, 모드가 플레이어의 말을 웹 API로 보내고 답을 재생할 수 있습니다. Neocortex는 AI 캐릭터, 그 음성, 돌려주는 행동을 제공하고, 모드가 이를 게임 안에서 실행합니다.

2026년에 Half-Life를 모딩하려면 무엇이 필요한가요?

GitHub의 Valve halflife SDK, C++ 컴파일러, Steam 버전의 Half-Life가 필요합니다. 더 많은 플랫폼을 대상으로 하려고 Xash3D FWGS와 hlsdk-portable 포크를 함께 쓰는 모더도 많습니다. AI NPC 대화를 추가하려면 Neocortex 계정을 만들고 브라우저에서 캐릭터를 설계하세요.

Half-Life 모드에서 음성 명령을 쓸 수 있나요?

네. 모드는 마이크를 듣고, 말한 문구를 게임 코드에 연결할 수 있습니다. 예를 들어 경비원에게 따라오라고 말하는 식입니다. Neocortex Voice Commands는 플레이어의 PC에서 듣기와 매칭을 처리하므로, 명령은 오프라인에서도 동작하고 즉시 반응합니다.

AI NPC가 들어간 Half-Life 모드를 판매할 수 있나요?

아니요. Valve의 Half-Life SDK 라이선스는 모드를 무료로만 배포하도록 허용하며, 상업적 사용은 Valve에 문의하라고 요구합니다. 무료 모드의 Neocortex 쪽은 브라우저 편집기에서 만들고 테스트할 수 있습니다.

AI NPC 모드가 Xash3D FWGS에서도 동작하나요?

동작할 수 있습니다. Xash3D FWGS는 Half-Life와 호환되는 오픈소스 엔진이며, hlsdk-portable은 GoldSrc와 Xash3D 양쪽용 게임 코드를 빌드합니다. Neocortex는 단순한 웹 API이므로, 같은 모드 코드가 두 엔진 중 어디에서든 이를 호출할 수 있습니다.

비슷한 글

더 읽어 보기