Dwinovo/minecraft-numen

Numen is an embodied agent that runs inside Minecraft. It lives in the game as a mod, continually explores the Minecraft world, makes its own decisions, and takes action to get tasks done.

이것이 무엇인가

Numen (중국어: 言出法随)은 게임 내에 구현형 AI 에이전트를 직접 내장하는 Minecraft 모드입니다. 에이전트는 플레이어 캐릭터로 실행되며, 세계를 인식하고 Lua 기반 API를 통해 대규모 언어 모델(LLM)로 구동될 수 있습니다. 실제로 모드를 설치하고 LLM 서비스(OpenAI, Anthropic 또는 호환 가능한 API)를 구성하고 봇을 소환한 후 자연어로 대화하면, 봇이 무엇을 해야 할지 결정하고 Minecraft 작업(이동, 채굴, 건설, 상호작용 등)을 수행합니다.

왜 중요한가

구현형 지능: 채팅 전용 봇과 달리 에이전트는 실제로 Minecraft 세계를 조작하여 LLM 기반 로보틱스 및 계획 연구를 위한 구체적인 테스트 베드를 제공합니다.
오픈소스 및 확장 가능: 모드는 LGPL-3.0이며 플러그인 시스템을 제공하여 개발자가 새로운 Lua 작업(예: 다른 모드의 작업)을 LLM에 노출할 수 있습니다.
하이브리드 배포: API 키를 통해 LLM을 로컬에서 실행하거나 외부 'MCP' 브레인(Claude Code, Cursor 등)에 모드를 연결하여 추론을 별도로 수행하고 토큰 비용을 절약할 수 있습니다.

누가 사용할까

사용자 유형	얻을 수 있는 것
Minecraft 플레이어	건설, 탐험, 작업 자동화를 도와주는 자율 동반자를 원하는 사람.
AI 연구자 / 취미 개발자	구현형 LLM 에이전트, 프롬프트 엔지니어링, 다중 모달 상호작용(음성, 텍스트, 스킨 사용자 지정)을 실험할 수 있는 샌드박스를 찾는 사람.
모드 개발자	자신의 모드를 LLM으로 제어하고자 하는 사람. 에이전트가 호출할 수 있는 새 Lua 함수를 등록하는 플러그인을 작성할 수 있습니다.
교육자	지각-행동 루프, 계획, 프롬프트 기반 로보틱스와 같은 개념을 친숙한 게임 환경에서 시연하려는 사람.

시작 방법

설치: CurseForge에서 'Numen'을 검색하고 사용 중인 Minecraft 버전(예: 1.20.1-Fabric)에 맞는 모드를 설치합니다.
게임에 들어가기: 게임 내에서 G(새 버전에서는 N)를 눌러 제어판을 엽니다.
모델 구성: OpenAI 또는 Anthropic을 선택하고 API 키를 붙여넣고 선택적으로 사용자 지정 '페르소나' 또는 스킨을 설정합니다.
봇 소환: 이름을 지정하고 봇을 소환한 후 채팅을 시작합니다. Y로 텍스트 입력, V로 음성 입력, R+마우스 휠로 여러 봇을 전환할 수 있습니다.
확장: plugins 폴더에 플러그인을 넣어 새 Lua 작업(예: Touhou Little Maid 모드 제어)을 노출합니다. 저장소의 plugins 디렉터리와 웹사이트 문서에서 템플릿을 참조하세요.

기술적 하이라이트

3계층 아키텍처:
1. Minecraft 코어 - 에이전트가 실제 플레이어 엔티티를 제어합니다.
2. Lua API - LLM이 호출할 수 있는 원자적 작업(지각, 이동, 채굴, 건설, 상호작용) 모음. 스킬 로딩을 위한 작은 Java API가 있습니다.
3. LLM 샌드박스 - Lua 스크립트가 샌드박스 내에서 실행되어 단일 호출로 많은 원자적 작업을 조정합니다.
모델 비종속: OpenAI 또는 Anthropic HTTP 프로토콜을 따르는 모든 서비스를 지원합니다. 엔드포인트 URL만 입력하면 됩니다.
MCP 서버 모드: 모드가 Minecraft-Chat-Protocol 서버로 작동하여 외부 AI 클라이언트가 에이전트를 구동하고 추론을 기기 외부에서 수행할 수 있습니다.
음성 I/O: 패널 설정을 통한 선택적 음성 입력/출력.
다중 에이전트 채팅: 아바타를 드래그하여 그룹 채팅 생성, @멘션으로 응답 지정.

커뮤니티 및 지원

QQ 그룹: 1121662678
Discord: https://discord.gg/FpDCV327vX
공식 웹사이트: https://numen.dwinovo.cn (문서, 아키텍처 다이어그램, 플러그인 가이드)
이슈 트래커: 버그 또는 기능 요청은 GitHub Issues를 사용하세요.

위 정보는 모두 리포지토리의 README에서 직접 가져온 것입니다.