Dwinovo/minecraft-numen

해결하는 문제

Numen은 자연어로 설명된 복잡한 작업을 이해하고 실행할 수 있는 마인크래프트용 AI 동반자입니다. 단순한 채팅 NPC와 달리, 서버상에서 실제 플레이어처럼 작동하며 채굴, 건설, 전투와 같은 물리적 행동을 수행할 수 있어 고수준의 지시를 통해 반복적인 게임 작업을 자동화합니다.

작동 방식

이 시스템은 AI 동반자를 ServerPlayer (서버 측 가짜 플레이어)로 간주하여 인간 플레이어와 동일한 게임 규칙을 따릅니다. 피드백 루프는 네 가지 구성 요소로 이루어집니다:

• 몸체: 서버 측 플레이어 엔티티로, 이동 및 상호작용에 대한 네이티브 게임 코드 경로를 실행합니다.
• 눈 (Perception API): 블록, 엔티티, 조리법을 스캔하고 GUI를 열지 않고 기계의 내용을 검사할 수 있습니다.
• 손 (Action API): 이동, 채굴, 블록 배치, 전투, 인벤토리 관리를 처리합니다.
• 피드백 루프: 모든 행동의 성공 또는 실패가 LLM에 피드백되어 AI가 실시간으로 전략을 학습하고 조정할 수 있습니다 (예: 철 광석은 돌 도끼가 필요하다는 것을 배움).

"뇌"는 사용자의 자체 기계에서 사용자의 API 키를 사용해 작동하며, OpenAI, Claude, DeepSeek 등 다양한 LLM 제공업체에 직접 연결됩니다.

대상 사용자

• 자원 채굴이나 기지 건설을 도와주는 지능형 보조 도구를 원하는 마인크래프트 플레이어.
• 제공된 API와 플러그인 시스템을 통해 자신의 모드에 AI 기능을 통합하고 싶은 모더.
• Model Context Protocol (MCP)를 실험해 클라우드 데스크톱이나 커서와 같은 외부 AI 클라이언트로 게임 세계를 제어하고 싶은 AI 애호가.

주요 특징

• 자연어 제어: 여러 언어에서 텍스트 및 음성 입력/출력을 지원합니다.
• 네이티브 통합: 실제 플레이어처럼 작동하므로 레드스톤, 몬스터 AI, 기타 모드와 호환됩니다.
• 확장 가능한 지식: 새로운 게임 메커니즘 또는 모드 전용 워크플로우는 간단한 Markdown 파일("스킬") 또는 전용 자바 플러그인을 통해 가르칠 수 있습니다.
• MCP 지원: 외부 AI 클라이언트가 게임 내 동반자를 제어할 수 있도록 MCP 서버로 작동할 수 있습니다.
• 서버 측 실행: 행동은 서버에서 검증되므로 멀티플레이 환경에서도 사용 가능합니다.