mindcraft-bots/mindcraft

어떤 프로젝트인가요?

핵심 기능

• 01LLM을 Mineflayer 봇에 연결해 Minecraft Java Edition을 플레이하게 합니다.
• 02OpenAI, Gemini, Anthropic, DeepSeek, Ollama를 비롯한 다양한 모델 제공자를 지원합니다.
• 03채팅, 코딩, 비전, 임베딩에 각각 별도의 모델을 지정할 수 있습니다.
• 04작업 JSON 파일을 통해 인벤토리 및 목표 조건이 있는 미리 정의된 작업을 실행합니다.
• 05별도의 프로필 파일을 사용해 여러 에이전트를 동시에 실행할 수 있습니다.

활용 사례

• 게임 환경에 체화된 다중 에이전트 LLM 협업을 연구합니다.
• 서로 다른 LLM이 게임 내 캐릭터로서 어떻게 행동하는지 실험합니다.
• 에이전트 성능을 평가하기 위한 스크립트 기반 또는 목표 지향 Minecraft 작업을 만듭니다.
• 외부 API 호출 없이 Ollama로 로컬 모델 기반 Minecraft 에이전트를 실행합니다.

빠른 시작

1. 1

   Node.js를 설치합니다(v18 또는 v20 LTS 권장).

2. 2

   최신 릴리스를 다운로드하거나 저장소를 clone합니다.

3. 3

   keys.example.json의 이름을 keys.json으로 변경하고 API 키를 추가합니다.

4. 4

   프로젝트 디렉터리에서 종속성을 설치합니다.

   npm install

사용 전 알아둘 점

• !지원되는 LLM 제공업체의 API 키가 필요하며, 기본 제공업체는 OpenAI입니다.
• !Minecraft Java Edition 설치가 필요하며, v1.21.11까지 지원합니다.
• !코딩을 활성화하면 LLM이 사용자의 컴퓨터에서 코드를 작성하고 실행할 수 있으므로, 해당 설정이 켜진 상태로 공개 서버에 접속해서는 안 됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

mindcraft은(는) 무엇인가요?

Mineflayer 기반으로 LLM이 조종하는 Minecraft 봇으로, 각 AI 에이전트가 게임을 플레이하며 플레이어와 채팅할 수 있습니다. Mindcraft는 Minecraft Java Edition에서 AI 에이전트를 실행하기 위한 프레임워크입니다. 대규모 언어 모델을 Mineflayer 기반 봇에 연결해 에이전트가 게임 세계를 인식하고, 플레이어와 채팅하며, 자원 수집이나 아이템 제작 같은 게임 내 행동을 수행할 수 있게 합니다.

mindcraft은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mindcraft은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mindcraft은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mindcraft의 마지막 커밋은 2026년 10월 27일입니다.

mindcraft은(는) 어디에 사용할 수 있나요?

게임 환경에 체화된 다중 에이전트 LLM 협업을 연구합니다. 서로 다른 LLM이 게임 내 캐릭터로서 어떻게 행동하는지 실험합니다. 에이전트 성능을 평가하기 위한 스크립트 기반 또는 목표 지향 Minecraft 작업을 만듭니다. 외부 API 호출 없이 Ollama로 로컬 모델 기반 Minecraft 에이전트를 실행합니다.

mindcraft는 어떻게 설치하나요?

Node.js를 설치합니다(v18 또는 v20 LTS 권장). 최신 릴리스를 다운로드하거나 저장소를 clone합니다. keys.example.json의 이름을 keys.json으로 변경하고 API 키를 추가합니다. 프로젝트 디렉터리에서 종속성을 설치합니다.: npm install

mindcraft은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mindcraft-bots/mindcraft