Neocortex Logo

마인크래프트 AI NPC 모드: 말하는 주민과 음성 명령

Fabric 또는 NeoForge로 Neocortex를 쓰는 마인크래프트 AI NPC 모드 만들기: 대화하고 거래하는 주민, 교실 퀴즈, 도우미 NPC의 음성 명령.

Neocortex TeamThe team behind Neocortex

· 6분 분량

Fabric 또는 NeoForge로 Neocortex를 쓰는 마인크래프트 AI NPC 모드 만들기: 대화하고 거래하는 주민, 교실 퀴즈, 도우미 NPC의 음성 명령.

요약: 네, 자바 에디션에서 가능합니다. Fabric 또는 NeoForge 기반의 마인크래프트 AI NPC 모드는 주민이 보고 듣는 것을 Neocortex 캐릭터에게 보내고, 돌아온 답변을 자막, 음성, 거래로 바꿀 수 있습니다.

마인크래프트의 주민은 웅얼거리고, 돌아다니고, 고정된 메뉴로만 거래합니다. 모더들은 몇 년째 이들을 말하게 만들려고 해 왔습니다. Neocortex를 쓰면 각 주민에게 성격, 플레이어에 대한 기억, 목소리가 생기고, 들은 말에 따라 행동합니다. Conversation Flows, 퀴즈 엔진, 기기 내 음성 명령을 더하면, 같은 모드로 교실 수업을 진행하거나 말로 내린 명령을 따르는 도우미를 만들 수 있습니다.

마인크래프트 게임 내 스크린샷 스크린샷: Minecraft © Mojang Studios

Fabric 대 NeoForge

자바 에디션 모드는 모드 로더가 불러오는 자바 jar 파일입니다. 말하는 주민을 만들 때는 두 주요 로더 중 어느 쪽이든 작동합니다.

로더FabricNeoForge
스타일가볍고 모듈식이며, Fabric API 라이브러리 포함기능이 풍부함
문서개발자 문서문서
프로젝트 설정모드 템플릿 생성기모드 생성기

두 로더 모두 새 릴리스를 바짝 따라갑니다. 마인크래프트 26.1 이상은 Java 25에서 실행되며, 26.1부터 게임은 난독화 없이 배포되므로 모드는 Mojang의 실제 이름을 바탕으로 작동합니다. 모드는 보통 Modrinth나 CurseForge에 올라옵니다. 커뮤니티 모드 중에는 이미 채팅 기반 AI 동료를 마인크래프트에 더한 것들이 있습니다. 아래는 Neocortex 모드가 어떤 모습인지 보여 줍니다.

서버 쪽인가, 클라이언트 쪽인가?

어떤 로더를 고르는지보다 코드가 어디에서 실행되는지가 더 중요합니다.

서버는 주민, 인벤토리, 거래를 관리하며, 웹 API를 호출하기에 자연스러운 곳입니다. 자바에 내장된 HttpClient가 네트워크 호출을 처리하고, Gson은 JSON을 위해 게임과 함께 이미 제공됩니다.

클라이언트는 마이크, 자막(채팅 줄이나 HUD 오버레이), 오디오 재생을 관리하며, WAV 답변에는 자바의 오디오 API를 쓸 수 있습니다.

그래서 전형적인 분담은 이렇습니다. 서버는 각 주민과의 대화를 /v3/chat을 통해 Neocortex로 보내고 돌아온 행동을 실행합니다. 클라이언트는 /v3/audio/generate 또는 /v3/audio/stream의 음성을 재생하고 음성 명령을 듣습니다.

자바로 하는 채팅 호출

Fabric 또는 NeoForge 모드에서 메인 스레드 밖으로 보내는 최소한의 채팅 호출입니다.

JsonObject body = new JsonObject();
JsonArray ids = new JsonArray();
ids.add(config.characterId());
body.add("characterIds", ids);
body.addProperty("message", playerText);
body.addProperty("playerId", player.getStringUUID());
body.addProperty("sessionId", sessionId); // "" on the first call

HttpRequest req = HttpRequest.newBuilder(URI.create("https://api.neocortex.link/v3/chat"))
    .header("x-api-key", config.apiKey())
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body.toString()))
    .build();

HTTP.sendAsync(req, HttpResponse.BodyHandlers.ofString()).thenAccept(res -> {
    JsonObject reply = JsonParser.parseString(res.body()).getAsJsonObject();
    sessionId = reply.get("sessionId").getAsString();
    // messages[0].lines -> subtitles; actions -> run them back on the server thread
});

이 호출 뒤의 캐릭터는 성격, 감정, 지식, 언어, 음성 노드를 가진 시각적 노드 편집기에서 만듭니다. Pro와 Team 요금제에서는 최대 여섯 캐릭터가 한 대화를 함께할 수 있으며, 마을 회의를 열기에 충분합니다. 다른 AI 캐릭터 플랫폼과 비교하는 방법은 비교 페이지를 참고하세요.

마인크래프트 게임 내 스크린샷 스크린샷: Minecraft © Mojang Studios

마인크래프트 AI NPC 모드의 NPC 세 명

사서와 농부

플레이어가 마을을 습격에서 구한 사실을 기억하는 사서는, 그 덕분에 마법이 부여된 책을 더 좋은 가격에 팔아줍니다. 밀밭에 생긴 크리퍼 구멍에 불평하는 농부는, 당근을 팔기 전에 그것을 고쳐 달라고 부탁합니다.

모드는 메시지와 함께 사실을 보냅니다. 주민의 직업, 플레이어의 에메랄드, 평판, 주변 블록, "습격 격퇴" 같은 최근 이벤트입니다. 캐릭터는 텍스트, 감정 태그, { "name": "OFFER_TRADE", "targetId": "enchanted_book" } 같은 행동으로 답합니다. 모드는 그 제안으로 거래 화면을 열어, 대화와 경제가 연결되도록 합니다.

교실 앞의 선생님

자바 서버에 있는 학급에서는, 선생님 NPC가 건물 앞에 서서 주제를 쉬운 말로 설명합니다. 수업 노트를 PDF로 캐릭터의 Knowledge 노드에 올리면, 선생님은 그 내용을 바탕으로 답합니다.

그다음 퀴즈를 냅니다. 레드스톤 논리 게이트, 바이옴과 기후, 또는 언어 수업의 어휘이며, 20개 이상의 언어 중 어떤 것이든 가능합니다. 퀴즈 엔진(Team 요금제)은 /v3/quiz를 통해 문제, 채점, 리더보드를 처리하며, 학생이 통과하면 모드가 보상 블록을 주거나 문을 엽니다. Conversation Flows도 단계별 수업에 맞습니다. 선생님이 학생을 체크포인트마다 안내하고, 모드는 각 flowState 키워드마다 다음 방을 엽니다.

듣는 도우미 Pip

모드에 Pip라는 도우미 NPC를 주고, 행위자("Pip", "everyone"), 동작("follow", "wait", "chop", "mine", "bring"), 대상("me", "oak logs", "iron", "that tree")으로 이루어진 명령 세트를 설계하세요.

"Bring me sixteen oak logs"는 수량이 붙은 명령 하나로 들어옵니다. "Chop that tree and then follow me"는 두 개로 들어옵니다. Neocortex Voice Commands 라이브러리는 플레이어의 PC에서 구문을 클라우드 왕복 없이 매칭하므로, 전투 중에도 말을 멈추는 순간 Pip이 반응합니다. 음성 쪽을 더 깊이 다룬 내용은 게임 모드를 위한 기기 내 음성 명령 글에 있습니다.

첫 주민 체크리스트

  1. 로더를 고르세요. 공식 생성기로 Fabric 또는 NeoForge 모드 프로젝트를 설정하세요.
  2. 캐릭터를 디자인하세요. Neocortex 대시보드에서 주민 직업별로 하나씩, 수업 노트가 있는 선생님, 퀴즈용 질문 세트를 만드세요. 브라우저에서 테스트하세요.
  3. 도우미 NPC의 명령 세트를 설계하세요. 행동마다 예시 구문을 몇 개씩 넣으세요.
  4. 모드에서 연결하세요. /v3/chat을 비동기로 호출하고, sessionId를 재사용하며, 돌아온 행동을 게임 코드에 매핑하세요.
  5. API 키는 설정 파일에 두세요. 플레이어나 서버 관리자가 채우는 파일이며, 공유하는 모드에 하드코딩하지 마세요.
  6. 먼저 싱글플레이어 월드에서 테스트하세요. 학급을 초대하기 전에 푸시 투 토크로 확인하세요.

Voice Commands는 라이선스가 필요한 SDK입니다. Voice Commands 라이선스 문의를 해 주세요.

서버, 교실, 공정한 플레이

모드를 무료로 유지하고, Mojang의 마인크래프트 사용 지침과 EULA를 따르세요. 싱글플레이어 월드나 모든 플레이어가 동의한 비공개 서버에서 쓰고, 규칙에 어긋나는 공개 서버에서는 쓰지 마세요. 교실이라면, 온라인 서비스를 연결하기 전에 학생 데이터에 관한 학교 규칙을 확인하세요. 각 플레이어나 서버는 자신의 Neocortex API 키를 씁니다.

짧은 정리

로더를 고르고, API 호출은 서버에 두고, 주민 직업 하나로 시작하세요. 사서가 Neocortex를 통해 말하고 거래하게 되면, 선생님과 Pip는 같은 조각을 재사용합니다.

더 아늑한 게임을 만드시나요? Stardew Valley AI 주민 모드 가이드를 보거나, AI NPC와 음성 명령 모드 목록에서 모든 게임을 찾아보세요.

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

자주 묻는 질문

마인크래프트에 AI NPC를 추가할 수 있나요?

네, 자바 에디션에서 가능합니다. Fabric 또는 NeoForge 모드는 주민이 보고 듣는 것을 AI 서비스로 보내고, 답변을 게임에 보여 줄 수 있습니다. Neocortex 캐릭터는 캐릭터에 맞게 답하며, 거래 열기 같은 행동을 돌려주면 모드가 그것을 실행합니다.

마인크래프트 주민이 AI로 대화할 수 있나요?

모드는 주민 직업마다 고유한 Neocortex 캐릭터를 줄 수 있으므로, 사서, 농부, 성직자가 각기 다르게 말합니다. 모드는 메시지마다 플레이어의 에메랄드, 평판, 주변 블록을 보내며, 주민은 답하고 행동을 통해 거래를 제안합니다.

교사가 마인크래프트 교실에서 AI NPC를 쓸 수 있나요?

자바 에디션 서버라면 가능합니다. Neocortex로 만든 선생님 NPC는 업로드한 수업 노트로 주제를 설명하고, 리더보드가 있는 채점 퀴즈를 운영할 수 있습니다. Minecraft Education은 별도 에디션이므로 Fabric과 NeoForge 모드는 그곳에 적용되지 않습니다.

목소리로 마인크래프트 NPC를 조종할 수 있나요?

네. Neocortex Voice Commands는 플레이어의 PC에서 실행되며, "bring me sixteen oak logs" 같은 자연스러운 구문을 오프라인으로 매칭하고, 명령과 수량을 클라이언트 모드에 넘깁니다. Voice Commands는 라이선스가 필요한 SDK이므로, 라이선스는 문의해 주세요.

비슷한 글

더 읽어 보기