yc-software/minecraft-agent-harness

어떤 프로젝트인가요?

핵심 기능

• 01Claude, GPT, Gemini, OpenRouter 또는 OpenAI Responses 호환 엔드포인트에 연결합니다.
• 02같은 이름을 사용하면 재시작 후 에이전트 세션을 이어서 사용합니다.
• 03E2B, Docker 또는 로컬 폴더를 통해 각 에이전트에 셸을 제공합니다.
• 04하나의 JSON 파일로 멀티 에이전트 팀을 정의하고 에이전트 간 직접 메시지를 지원합니다.
• 05Paper 서버가 포함된 Docker Compose 설정을 제공합니다.

활용 사례

• Minecraft 월드 안에서 동작하는 LLM 에이전트를 실험합니다.
• 채팅으로 협력하는 AI 플레이어 팀을 실행합니다.
• 심판이 있는 Bed Wars 같은 게임에서 에이전트 동작을 테스트합니다.
• 에이전트가 셸 샌드박스를 사용해 게임 도구용 스크립트를 작성하는 방식을 연구합니다.

빠른 시작

1. 1

   종속 항목을 설치합니다

   npm ci
2. 2

   env 파일을 복사하고 사용할 모델 제공업체의 API 키를 추가합니다

   cp .env.example .env
3. 3

   개발용 Minecraft 서버를 시작합니다(Java 21 필요)

   npm run server
4. 4

   두 번째 터미널에서 목표를 지정해 에이전트를 시작합니다

   npm start -- --objective "Gather wood and build a small shelter near spawn"

사용 전 알아둘 점

• !Node 22.19 이상, 모델 제공업체의 API 키, Minecraft 서버가 필요합니다.
• !기본적으로 에이전트의 셸은 로컬 폴더에서 실행되며, 명령은 사용자 권한으로 실행됩니다. Docker 또는 E2B를 사용할 수 있거나 --sandbox none을 전달하면 예외입니다.
• !Vision 지원은 실험 단계입니다.
• !프로젝트가 아직 초기 단계이고 별이 100개뿐이므로 다듬어지지 않은 부분이 있을 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

minecraft-agent-harness은(는) 무엇인가요?

Mineflayer를 통해 LLM 에이전트를 Minecraft 플레이어로 실행하며, 세션을 유지하고 에이전트별 셸 샌드박스와 멀티 에이전트 팀을 지원합니다. minecraft-agent-harness는 언어 모델을 Minecraft 서버에 연결해 일반 플레이어처럼 게임을 할 수 있게 합니다. 걷기, 채굴, 제작, 건축, 전투, 채팅 등의 동작은 Mineflayer를 통해 수행하고, 모델 세션은 pi가 관리합니다. 지원하는 모델 제공업체로는 Claude, GPT, Gemini, OpenRouter와 OpenAI Responses API를 지원하는 모든 엔드포인트가 있습니다.

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

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

minecraft-agent-harness은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. minecraft-agent-harness의 마지막 커밋은 2026년 10월 29일입니다.

minecraft-agent-harness은(는) 어디에 사용할 수 있나요?

Minecraft 월드 안에서 동작하는 LLM 에이전트를 실험합니다. 채팅으로 협력하는 AI 플레이어 팀을 실행합니다. 심판이 있는 Bed Wars 같은 게임에서 에이전트 동작을 테스트합니다. 에이전트가 셸 샌드박스를 사용해 게임 도구용 스크립트를 작성하는 방식을 연구합니다.

minecraft-agent-harness는 어떻게 설치하나요?

종속 항목을 설치합니다: npm ci env 파일을 복사하고 사용할 모델 제공업체의 API 키를 추가합니다: cp .env.example .env 개발용 Minecraft 서버를 시작합니다(Java 21 필요): npm run server 두 번째 터미널에서 목표를 지정해 에이전트를 시작합니다: npm start -- --objective "Gather wood and build a small shelter near spawn"

minecraft-agent-harness은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/yc-software/minecraft-agent-harness