Neocortex 고도 엔진 SDK 출시: 고도 엔진 4용 음성 AI NPC
오픈 소스 고도 엔진 SDK가 AI NPC를 고도 엔진 4에 가져옵니다. 음성 대화, 감정이 있는 AI 대화, 행동, 립싱크, 그룹 대화를 GDScript로 구현합니다.
Neocortex TeamThe team behind Neocortex
· 6분 분량

고도 엔진은 대부분의 AI 캐릭터 플랫폼이 건너뛰는 엔진이었습니다. 이제 그렇지 않습니다. 고도 엔진 SDK가 출시되었습니다. Neocortex에서 캐릭터를 설계하고 애드온을 고도 엔진 4 프로젝트에 넣으면, 플레이어는 캐릭터에게 소리 내어 말하고, 캐릭터가 자신의 목소리로 답하는 것을 듣고, 여러분의 세계에서 행동하는 모습을 볼 수 있습니다.
오픈 소스이며, GDScript로 작동하고, 샘플 장면 7개가 포함되어 있어 직접 만들기 전에 모든 기능이 실행되는 모습을 볼 수 있습니다.
고도 엔진 SDK가 게임에 더하는 것
- 타이핑이나 음성으로 대화할 수 있는 캐릭터.
- 모든 대사에 붙는 목소리와 감정. 애니메이션과 초상화가 분위기를 따라갈 수 있습니다.
- 행동. 문을 열거나 아이템을 건네는 것처럼 여러분의 코드를 실행합니다.
- 장면 인식. 캐릭터가 주변에 무엇이 있는지 압니다.
- 립싱크, 그룹 대화, 퀴즈 진행자.
- 기억. 대화가 멈췄던 곳에서 이어집니다.

대화 트리 없이 고도 엔진에서 AI 대화하기
분기형 대화 트리는 플레이어가 여러분이 쓰지 않은 것을 묻는 순간 무너집니다. Neocortex에서는 모든 대사가 아니라 캐릭터를 설계합니다. 성격, 세계에 대해 아는 것, 말하는 방식, 할 수 있는 일을 정합니다. 소리가 맞을 때까지 브라우저에서 테스트한 뒤, 같은 캐릭터를 고도 엔진에서 사용합니다.
각 답변은 대사 여러 줄로 도착하며, 각 줄에는 자체 감정이 붙습니다. 그래서 상인은 같은 답변 안에서 판매에는 기뻐하고 흥정에는 짜증을 낼 수 있습니다. 캐릭터는 대화도 기억하며, "플레이어가 방금 결투에서 이겼다" 같은 최근 게임플레이 이벤트를 보낼 수 있어 답변이 일어난 일과 맞습니다. 설계 측면은 NPC 고유 성격 만들기와 NPC 기억 가이드에서 더 깊이 다룹니다.
고도 엔진에서 NPC와 음성 대화하기
플레이어는 입력 대신 말할 수 있습니다. SDK는 음성 감지 또는 푸시 투 토크로 마이크를 녹음하고, 음성을 텍스트로 바꾸며, 캐릭터가 자신의 목소리로 답합니다. 답변의 나머지가 아직 생성되는 동안에도 음성 재생이 시작되므로 대화가 멈추지 않습니다.
답변을 음성으로 어떻게 낼지 고를 수 있습니다. 줄마다 자체 감정으로, 전체 답변을 하나의 클립으로, 또는 텍스트만 선택할 수 있습니다. 안드로이드에서는 SDK가 시작할 때 마이크 권한을 요청합니다. 마이크에서 스피커까지 무슨 일이 일어나는지는 AI NPC 음성 파이프라인 글에서 설명합니다.
말한 것에 따라 행동하는 고도 엔진 NPC
말하는 것은 절반입니다. 편집기에서 GIVE_ITEM, OPEN_DOOR, FOLLOW_PLAYER 같은 행동을 캐릭터에 주고, 각 행동을 GDScript 함수에 연결하세요.
@onready var agent: NeocortexSmartAgent = $Blacksmith/NeocortexSmartAgent
func _ready() -> void:
agent.chat_line_started.connect(func(line: NeocortexChatLine): $Subtitle.text = line.text)
agent.register_action("GIVE_ITEM", _give_item)
func _give_item(action: NeocortexChatAction) -> void:
inventory.give(action.target_id) # your own inventory code캐릭터는 요청하고, 게임이 결정합니다. 장면의 오브젝트를 상호작용 가능으로 표시하면, 캐릭터는 주변에 무엇이 있는지 알고 행동을 그 오브젝트에 겨냥할 수 있습니다. "빨간 사각형으로 간 다음 파란 것으로 가" 같은 말은 대상이 있는 행동 두 개가 됩니다. 한 답변에는 여러 행동이 들어 있을 수 있으며, 차례로 실행됩니다.

립싱크, 그룹 대화, 퀴즈
- 립싱크: 캐릭터의 입이 말에 맞춰 ARKit 스타일 블렌드 셰이프로 움직입니다. 대부분의 캐릭터 모델이 이미 쓰는 표준입니다.
- 그룹 대화: 한 장면에 여러 캐릭터를 두고, 플레이어 및 서로와 대화하게 하며, 대화가 진행되는 동안 합류하거나 떠나게 할 수 있습니다.
- 퀴즈 진행자: 캐릭터가 여러분의 질문 세트로 한 명 이상의 플레이어를 대상으로 퀴즈를 진행하며, 힌트, 패스, 점수는 자동으로 처리됩니다.

고도 엔진에 AI NPC 추가하는 방법
- 최신 릴리스를 내려받고
addons/neocortex-godot-sdk를 프로젝트에 복사하세요. - Project Settings > Plugins에서 Neocortex를 켜고, Neocortex 도크에 API 키를 붙여 넣으세요.
- Project > Tools > Neocortex > Complete Voice Chat을 고르고, 캐릭터를 선택한 뒤 Play를 누르세요.
고도 엔진 빠른 시작에 자세한 내용이 있으며, 고도 엔진 4에서 AI NPC 대화 추가하기 튜토리얼은 대장장이 장면 전체를 단계별로 만듭니다.
고도 엔진 SDK인가, 직접 만든 LLM 연동인가?
고도 엔진의 HTTPRequest 노드로 LLM API에 텍스트를 보내고 답을 출력할 수 있습니다. 주말 프로토타입으로는 좋습니다. 플레이어가 몇 시간씩 대화할 캐릭터라면 더 많은 것이 필요합니다. 음성 인식, 캐릭터별 목소리, 감정, 세션 간 기억, 게임이 신뢰할 수 있는 행동, 그리고 한 플레이어가 청구서를 폭등시키지 못하게 하는 제한이 필요합니다.
SDK가 이 모든 것을 다룹니다. 각 API 키의 플레이어별 및 캐릭터별 사용량 제한은 우리 서버에서 강제됩니다. 더 넓은 선택지를 보려면 고도 엔진용 AI NPC 도구 목록을 보세요.
오픈 소스
SDK는 Apache 2.0으로 GitHub에 공개되어 있으므로, 이슈와 풀 리퀘스트를 환영합니다. 같은 캐릭터는 유니티, 언리얼 엔진, 웹에서도 작동하므로, 고도 엔진 게임을 위해 설계한 캐릭터를 다음 프로젝트에도 가져갈 수 있습니다.
고도 엔진 게임에 다음으로 무엇이 필요한지 Discord 서버에서 알려 주세요.
자주 묻는 질문
고도 엔진용 AI NPC 플러그인이 있나요?
네. Neocortex 고도 엔진 SDK는 고도 엔진 4.7 이상용 오픈 소스 에디터 플러그인입니다. 감정, 행동, 립싱크, 그룹 대화, 퀴즈가 있는 음성 AI 캐릭터를 프로젝트에 추가합니다.
고도 엔진에서 NPC에 AI 대화를 어떻게 추가하나요?
Neocortex에서 캐릭터를 설계하고, 프로젝트의 addons 폴더에 고도 엔진 SDK를 추가하고, 플러그인을 켠 뒤 API 키를 붙여 넣으세요. 그다음 Project > Tools > Neocortex에서 채팅 장면을 추가하거나, GDScript에서 NeocortexSmartAgent의 text_to_audio를 호출하세요.
고도 엔진 NPC에 ChatGPT나 다른 LLM을 쓸 수 있나요?
고도 엔진의 HTTPRequest 노드로 LLM API를 직접 호출할 수 있지만, 그 위에 음성, 감정, 기억, 행동을 직접 쌓아야 합니다. Neocortex 고도 엔진 SDK는 시각적 편집기에서 설계한 캐릭터와 함께 이 모든 것을 하나의 애드온으로 제공합니다.
플레이어가 목소리로 고도 엔진 NPC와 대화할 수 있나요?
네. 플레이어가 마이크에 말하면(음성 감지 또는 푸시 투 토크), 캐릭터가 줄마다 감정을 실어 자신의 목소리로 답합니다.
고도 엔진 SDK는 립싱크를 지원하나요?
네. NeocortexFaceAnimator가 캐릭터의 메시에서 말하는 동안 ARKit 스타일의 입 블렌드 셰이프를 움직입니다.
고도 엔진의 AI NPC가 게임플레이를 발동시킬 수 있나요?
네. GIVE_ITEM이나 OPEN_DOOR 같은 행동을 캐릭터에 주면, 각 행동은 여러분이 등록한 GDScript 함수를 호출합니다. 행동은 장면의 오브젝트를 대상으로 할 수 있으며, 실행 여부는 여러분의 코드가 정합니다.
SDK는 어떤 고도 엔진 버전을 지원하나요?
고도 엔진 4.7 이상입니다.
Neocortex 고도 엔진 SDK는 오픈 소스인가요?
네. GitHub에서 Apache 2.0 라이선스로 공개되어 있습니다.






