고도 엔진에서 AI NPC 만드는 법 | 2026 가이드
2026년 고도 엔진에서 AI NPC 만드는 법: HTTPRequest와 모델 API, 네오코텍스 고도 SDK, NobodyWho를 이용한 로컬 모델, Player2 플러그인.
Sercan AltundasFounder of Neocortex
· 9분 분량

고도 엔진에서 AI NPC를 만들려면, 플레이어가 한 말을 언어 모델로 보내고 답변을 화면에 보여 주거나 소리로 들려주면 됩니다. 방법은 고도 엔진 자체의 HTTPRequest 노드와 모델 API를 쓰거나, 캐릭터 SDK를 쓰거나, 플레이어의 컴퓨터에서 모델을 돌리는 애드온을 쓰는 것입니다. 고도 엔진에는 자체적인 AI 캐릭터 기능이 없으므로, 어떤 방법이든 GDScript나 애드온을 추가하게 됩니다.
이 가이드는 대화 트리 대신 자기 말로 답하는 캐릭터를 원하는 고도 4 개발자를 위한 글입니다. 네 가지 방법을 다룹니다. 모델 API와 함께 쓰는 HTTPRequest, 네오코텍스 고도 SDK, NobodyWho를 이용한 로컬 모델, Player2 AI NPC 플러그인입니다. 각 방법마다 단계, 필요한 것, 비용을 적었고, 이어서 비교표, 모든 방법에 공통으로 쓰는 팁, 자주 묻는 질문이 나옵니다.
고도 엔진에서 AI NPC를 만드는 4가지 방법
네 가지 방법 모두 장면 안에 캐릭터를 나타내는 노드 하나와, 플레이어의 입력 창(LineEdit)이나 마이크를 두는 것으로 시작합니다. 차이는 모델이 어디서 돌아가는지, 누가 비용을 내는지, GDScript를 얼마나 써야 하는지입니다.
방법 1: HTTPRequest와 모델 API
이 방법은 고도 엔진에 기본으로 들어 있는 것만 씁니다. HTTPRequest 노드는 "HTTP 요청을 보낼 수 있는 노드"이므로, 스크립트가 플레이어의 말을 모델 제공자에게 보내고 답을 읽을 수 있습니다. 예시로 OpenAI Responses API를 씁니다.
필요한 것: 모델 제공자의 API 키와 약간의 GDScript.
- API 키 만들기. OpenAI는 platform.openai.com/api-keys에서 만듭니다.
- HTTPRequest 노드 추가하기. NPC 장면의 자식으로 두고, 그
request_completed시그널을 NPC 스크립트의 함수에 연결합니다. - 캐릭터 쓰기. 캐릭터의 이름, 역할, 말투, 제한 사항을 담은 시스템 지시 문자열을 유지합니다.
- 대사 보내기. 모델, 지시문, 플레이어의 메시지를 담은 JSON 본문을 만듭니다. 그다음
https://api.openai.com/v1/responses로request()를 호출하고, 헤더Authorization: Bearer <key>와Content-Type: application/json, POST 메서드, 본문을 넘깁니다. - 답변 읽기.
request_completed핸들러에서 본문을 JSON으로 파싱하고, 텍스트를 NPC 위의 Label이나 RichTextLabel에 넣습니다. - 대화 기록 유지하기. 최근 대화를 Array에 저장하고 요청마다 함께 보냅니다. 모델은 호출 사이의 모든 것을 잊어버리기 때문입니다.
- 부가 기능 만들기. 음성, 립싱크, 행동은 직접 만들어야 합니다. 음성에는 API 호출이 더 필요하고, 답변을 게임 플레이로 바꾸는 규칙도 직접 정해야 합니다.
- 키를 안전하게 보관하기. 고도 엔진 문서는 TLS 사용을 권장하고 민감한 정보를 보내지 말라고 경고합니다. 내보낸 게임 안의 키는 읽힐 수 있으므로, 출시 전에 제공자 앞에 직접 만든 서버를 두세요.
비용: 고도 엔진은 무료입니다. 제공자의 토큰 단위 요금을 냅니다.
부족한 점: 기억, 음성, 행동, 안전 장치, 키 서버를 모두 직접 만들고 유지해야 합니다.
방법 2: 네오코텍스 고도 SDK
네오코텍스는 저희 제품이므로, 이 항목은 그 점을 염두에 두고 읽어 주세요. 브라우저의 비주얼 에디터에서 캐릭터를 설계한 다음, 오픈 소스 애드온(Apache 2.0)을 통해 고도 엔진에서 씁니다. 성격, 지식, 감정, 음성, 행동은 에디터의 노드이고, 고도 엔진에서는 만들어진 노드를 추가합니다. 전체 목록은 고도 엔진 AI NPC 페이지에 있습니다.
필요한 것: 고도 4.7 이상과 API 키가 있는 네오코텍스 계정.
- 캐릭터 만들기. 대시보드에서 Characters를 열고 Create New Character를 클릭한 뒤 이름을 입력하고 Create를 누릅니다. 노드 에디터에서 캐릭터를 구성합니다.
- 브라우저에서 테스트하기. 에디터 오른쪽 위의 Play를 클릭합니다.
- API 키 만들기. 대시보드에서 API Keys를 엽니다.
- 애드온 설치하기.
https://github.com/neocortex-link/neocortex-godot-sdk/releases/latest에서 최신 릴리스를 받고,addons/neocortex-godot-sdk를 프로젝트의addons폴더에 복사합니다. - 활성화하기. Project > Project Settings > Plugins를 열고 Neocortex를 켭니다. Neocortex 도크에 API 키를 붙여 넣습니다.
- 한 단계로 채팅 추가하기. Project > Tools > Neocortex > Complete Text Chat 또는 Complete Voice Chat을 고릅니다. 그러면 작동하는 채팅이 장면에 추가되고, Inspector 드롭다운에서 캐릭터를 고르면 됩니다.
- 게임에 연결하기. 캐릭터에는
NeocortexSmartAgent노드, 마이크에는NeocortexAudioReceiver, ARKit 스타일 블렌드 셰이프의 립싱크에는NeocortexFaceAnimator, 캐릭터가 알아야 하는 오브젝트에는NeocortexInteractable, 일어난 일에는NeocortexEventLogger를 씁니다. 에디터의 행동 노드는 GDScript가 처리할 수 있는 행동 이름을 보냅니다. - 샘플 열기. 네오코텍스 도크에서 샘플 씬 7개와 런처를 열 수 있습니다. Text Chat, Audio Chat, Actions, Interactables, Group Chat, Usage Gating, Quiz Show입니다.
알아 둘 제한: 녹음은 29초에서 멈추고, 0.15초보다 짧은 소리는 전송되지 않으며, 채팅 요청은 30초 후에 시간 초과됩니다.
비용: Starter는 연간 결제 시 월 €9, Pro는 €29, Team은 €99이고, 월간 결제 시에는 €11, €35, €119입니다. 상업적 사용에는 Pro나 Team이 필요합니다. 가격을 보세요.
부족한 점: 캐릭터는 저희 클라우드에서 돌아가므로 게임에 연결이 필요합니다. 내보낸 게임에는 API 키가 들어가므로 사용량 한도를 설정하세요. 그룹 채팅에는 Pro나 Team이 필요하고, 퀴즈에는 Team이 필요하며, 저희 문서가 모든 내보내기 대상을 나열하지는 않습니다.
방법 3: NobodyWho를 이용한 로컬 모델
NobodyWho는 플레이어의 컴퓨터에서 언어 모델을 돌리는 오픈 소스 추론 엔진이며, 고도 애드온이 있습니다. 공식 readme는 "API 키가 필요 없다"고 말하며, 숨겨진 요금도 없다고 합니다.
필요한 것: 고도 4.6 이상(NobodyWho 고도 문서 기준)과 GGUF 형식의 모델.
- 설치하기. 고도에서 AssetLib 탭을 열고 NobodyWho를 검색해 내려받은 뒤, Ignore asset root를 체크하고 가져옵니다. 또는 릴리스의
addons/nobodywho를 프로젝트에 복사합니다. 편집기를 재시작하거나 다시 불러옵니다. - 모델 고르기. GGUF 모델이라면 무엇이든 됩니다. readme는 시작용으로 Qwen3 0.6B를 제안하며, 원격 모델은 처음 사용할 때 내려받아 캐시합니다.
- 채팅 만들기. 스크립트에서
await NobodyWhoChat.create(<model path>, {})를 호출합니다. - 질문하기.
chat.ask(<player text>)를 호출하고 결과의completed()를await합니다. 문서는 반환된 값을 항상 즉시 await하라고 합니다. - 역할 쓰기. NobodyWho 문서의 Chat 항목을 따라 채팅에 캐릭터 지시를 줍니다.
- 대상 확인하기. NobodyWho는 고도 데스크톱과 Android를 지원합니다. iOS나 웹 내보내기는 없습니다.
비용: EUPL-1.2 아래 상업적 사용 무료입니다. NobodyWho 자체 코드를 바꾸면, 그 변경은 공개되어야 합니다.
부족한 점: 응답 속도와 품질은 플레이어의 하드웨어와 모델 크기에 따라 다르고, 모델 때문에 다운로드 용량이 늘어납니다. 음성 기능은 엔진에 나열되어 있지만, 계획하기 전에 고도 바인딩에 그 기능이 있는지 확인하세요.
방법 4: Player2 AI NPC 플러그인
Player2는 게임과 모드를 위한 로컬 API를 제공하는 데스크톱 앱입니다. 고도 플러그인은 "Player2 앱의 무료 AI API를 사용"하며, 앱이 열려 있으면 연결됩니다.
필요한 것: 고도 4.5(에셋 라이브러리 기준), Player2 개발자 클라이언트 ID, Player2 앱.
- 플러그인 설치하기. 고도 에셋 라이브러리나 GitHub에서 받고,
addons폴더를 프로젝트로 끌어다 놓습니다. - 클라이언트 ID 추가하기. player2.game/profile/developer에서 만들고, Project Settings > Player2 > Game Key에 입력합니다.
- NPC 노드 추가하기. 장면에 Player2 AI NPC 노드를 추가하고 에이전트의 설명을 편집합니다.
- 채팅 연결하기. 노드의
chat함수를 플레이어의 텍스트로 호출하고,chat_received시그널을 연결해 답변을 표시합니다. 에이전트에게 월드 이벤트를 알리려면notify를 호출합니다. - 음성 추가하기. Character Config에서 Voice ID를 설정하거나
Player2TTS노드를 추가합니다. 음성 입력에는Player2STT를 추가하고, Project Settings > Audio에서 오디오 입력을 켭니다. - Player2 실행하기. Player2 앱을 엽니다. 플러그인이 자동으로 연결됩니다.
비용: Player2의 페이지에 따르면 크리에이터에게는 무료입니다. 플러그인은 GPLv3입니다.
부족한 점: Player2 사이트는 로컬 API가 앱이 열려 있을 때 작동한다고 말하므로, 앱이 없는 플레이어에게 무엇을 보여 줄지 계획하세요. GPLv3 라이선스를 프로젝트에 맞게 확인하세요.
네 가지 방법 비교
| 요소 | HTTPRequest와 API | 네오코텍스 SDK | NobodyWho | Player2 플러그인 |
|---|---|---|---|---|
| 캐릭터를 정의하는 곳 | GDScript 안의 문자열 | 브라우저의 비주얼 노드 에디터 | 직접 쓰는 GDScript | 고도 안의 노드 설명 |
| 모델이 돌아가는 곳 | 제공자의 클라우드 | 네오코텍스 클라우드 | 플레이어의 기기 | Player2 앱을 통해 |
| 고도 버전 | HTTPRequest가 있는 4.x | 4.7 이상 | 4.6 이상 | 4.5로 나열됨 |
| 음성 | 직접 만들기 | 포함, 립싱크 포함 | 엔진에 나열됨 | TTS와 STT 노드 |
| 애드온 라이선스 | 필요 없음 | Apache 2.0 | EUPL-1.2 | GPLv3 |
| 시작 비용 | 제공자의 토큰 요금 | 월 €9부터 | 무료 | 크리에이터에게 무료 |
| 필요한 기술 | GDScript, HTTP, 서버 | 애드온 복사, 노드 추가 | GDScript, 모델 선택 | 노드 추가 |
HTTPRequest는 코드가 가장 많은 대신 완전한 제어를 줍니다. NobodyWho는 플레이어의 하드웨어에 묶인 오프라인 방법입니다. 네오코텍스는 음성, 립싱크, 샘플과 함께 호스팅되는 에디터에 캐릭터를 둡니다. Player2는 가장 빨리 노드를 추가할 수 있지만 Player2 앱에 의존합니다.
고도 결과를 더 좋게 만드는 팁
이 습관들은 모든 방법에 도움이 됩니다.
- 키를 내보내기 밖에 두세요. 내보낸 프로젝트 안의 것은 모두 읽힐 수 있습니다. 키가 들어 있는 설정 파일은 버전 관리에서 빼고, 서버나 플레이어별 및 캐릭터별 사용량 한도를 쓰세요.
- NPC가 플레이어의 말을 들었다는 것을 보여 주세요. "생각 중" 애니메이션으로 바꾸거나 요청이 시작되는 순간 표시를 넣어, 답을 기다리는 동안 게임이 멈춘 것처럼 보이지 않게 하세요.
- 캐릭터에게 장면을 알려 주세요. 메시지마다 근처의 오브젝트와 최근 이벤트를 함께 넘겨서, NPC가 자기가 서 있는 방에 대해 말하게 하세요.
- 행동은 마지막 판단을 GDScript가 하게 하세요. 캐릭터가 요청할 수 있는 행동 목록을 짧게 두고, 실행 전에 각 행동을 코드에서 확인하세요.
- 줄거리에는 대화 트리를 쓰세요. 이야기를 움직이는 대사는 스크립트 기반 대화 애드온에 두고, 그 주변은 AI 캐릭터에 맡기세요. 고도 플러그인 글에 스크립트 부분을 위한 애드온이 나열되어 있습니다.
고도에 맞는 방법 고르기
HTTPRequest와 모델 API는 애드온을 쓰고 싶지 않고, 각 요청을 완전히 제어하고 싶으며, 키를 위한 작은 서버를 운영할 수 있다면 맞습니다.
네오코텍스 SDK는 캐릭터를 시각적으로 설계하고 브라우저에서 테스트하고 싶으며, 고도 4.7에서 음성, 립싱크, 행동, 샘플을 얻고 싶다면 맞습니다. 같은 캐릭터를 유니티와 언리얼 엔진에서도 쓸 수 있습니다.
NobodyWho는 게임이 실행 비용 없이 오프라인에서 돌아가야 하고, 데스크톱이나 Android에서 동작해야 한다면 맞습니다.
Player2 플러그인은 플레이어가 이미 Player2 앱을 쓰고 있거나, 프로토타입을 만들며 단계를 가장 적게 쓰고 싶다면 맞습니다.
더 많은 선택지는 고도용 최고의 AI NPC 도구를 보세요. 아직 엔진을 고르는 중이라면 고도 vs 유니티를 보세요.
자주 묻는 질문
고도에서 AI NPC를 무료로 만들 수 있나요?
네. NobodyWho는 무료이고 모델을 로컬에서 돌리며, Player2는 크리에이터에게 무료입니다. 직접 호출하는 모델 API는 토큰 단위로 요금을 받습니다.
고도에는 AI NPC가 내장되어 있나요?
아닙니다. 고도는 웹 호출을 위한 HTTPRequest 노드를 주지만, 언어 모델이나 캐릭터 시스템은 없습니다. 엔진 주변에 있는 것은 고도 AI 글에서 다룹니다.
어떤 고도 버전이 필요한가요?
네오코텍스는 고도 4.7 이상, NobodyWho는 4.6 이상이 필요하고, Player2 플러그인은 4.5로 나열되어 있습니다. HTTPRequest는 고도 4에 포함되어 있습니다.
고도 AI NPC를 오프라인에서 돌릴 수 있나요?
네. 데스크톱이나 Android에서 NobodyWho 같은 로컬 모델을 쓰면 가능합니다. 네오코텍스를 포함한 클라우드 방식은 연결이 필요합니다.
네오코텍스 고도 SDK는 오픈 소스인가요?
네. Apache 2.0으로 배포되며, 소스는 GitHub의 neocortex-link/neocortex-godot-sdk에 있습니다. 버그 제보와 아이디어도 그곳에서 환영합니다.
고도 AI NPC가 웹 내보내기에서도 작동하나요?
방법에 따라 다릅니다. NobodyWho에는 웹 내보내기가 없습니다. 고도 밖의 브라우저 게임이라면, 네오코텍스에 웹 SDK도 있습니다.






