Repolode
PrismarineJS

PrismarineJS/mineflayer

서버에 접속해 이동, 채굴, 제작, 채팅과 월드 상호작용을 수행하는 Minecraft 봇을 만들기 위한 JavaScript API입니다.

스타
7,724
포크
1,547
열린 이슈
557
마지막 커밋
12일 전

어떤 프로젝트인가요?

Mineflayer는 Minecraft 봇을 만들기 위한 Node.js 라이브러리입니다. Minecraft 서버에 연결하는 스크립트를 작성하면 봇이 게임 월드를 인식하고 행동할 수 있습니다. 엔티티를 추적하고 주변 블록을 조회하며, 물리 엔진을 이용해 이동하고, 인벤토리를 관리하고, 제작하고, 상자와 화로를 사용하고, 블록을 캐거나 설치하고, 채팅 메시지를 보낼 수 있습니다.

Minecraft 1.8부터 26.1까지 지원하며 Microsoft 계정 또는 오프라인 모드 서버로 인증할 수 있습니다. 프로토콜 파싱, 블록 및 아이템 데이터, 물리 엔진을 처리하는 PrismarineJS 모듈 제품군을 기반으로 합니다. Python에서 사용할 수 있는 인터페이스도 문서화되어 있으며, 길 찾기, 브라우저에서 봇의 월드 확인하기, 봇을 Discord에 연결하기 등의 예제를 제공합니다.

플러그인 생태계를 통해 기본 API에 길 찾기, PvP, 블록 수집, MCP 기반 LLM 제어 기능을 추가할 수 있습니다.

핵심 기능

  • 01주변 엔티티를 추적하고 월드의 블록을 조회합니다.
  • 02플레이어 및 탈것과 상호작용할 때 이동과 물리를 시뮬레이션합니다.
  • 03인벤토리를 관리하고 제작대, 상자, 화로, 마법 부여대를 지원합니다.
  • 04블록을 캐거나 설치하고, 블록을 활성화하거나 아이템을 사용합니다.
  • 05Microsoft 계정 또는 오프라인 인증으로 Minecraft 1.8부터 26.1까지 지원합니다.

활용 사례

  • Minecraft 서버에서 자동화된 보조 봇을 만듭니다.
  • LLM을 통해 Minecraft를 플레이하는 AI 에이전트를 프로토타이핑합니다.
  • 농사나 설계도에 따른 건축 등 반복적인 게임 내 작업을 자동화합니다.
  • Node.js로 게임 자동화와 프로토콜 처리를 학습합니다.

빠른 시작

  1. 1

    nodejs.org에서 Node.js 18 이상을 설치합니다

  2. 2

    mineflayer 패키지를 설치합니다

    npm install mineflayer
  3. 3

    bot 스크립트를 만들고 서버에 연결합니다(README의 echo 예제 참조).

사용 전 알아둘 점

  • Node.js 18 이상이 필요하며, bot을 제어하는 JavaScript 코드를 작성해야 합니다.
  • Microsoft 인증은 처음 사용할 때 브라우저에서 로그인해야 합니다.

토픽

#minecraft#bot#nodejs#javascript#game-automation#minecraft-bot#minecraft-api#network

자주 묻는 질문

mineflayer은(는) 무엇인가요?
서버에 접속해 이동, 채굴, 제작, 채팅과 월드 상호작용을 수행하는 Minecraft 봇을 만들기 위한 JavaScript API입니다. Mineflayer는 Minecraft 봇을 만들기 위한 Node.js 라이브러리입니다. Minecraft 서버에 연결하는 스크립트를 작성하면 봇이 게임 월드를 인식하고 행동할 수 있습니다. 엔티티를 추적하고 주변 블록을 조회하며, 물리 엔진을 이용해 이동하고, 인벤토리를 관리하고, 제작하고, 상자와 화로를 사용하고, 블록을 캐거나 설치하고, 채팅 메시지를 보낼 수 있습니다.
mineflayer은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mineflayer은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mineflayer은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mineflayer의 마지막 커밋은 2026년 10월 27일입니다.
mineflayer은(는) 어디에 사용할 수 있나요?
Minecraft 서버에서 자동화된 보조 봇을 만듭니다. LLM을 통해 Minecraft를 플레이하는 AI 에이전트를 프로토타이핑합니다. 농사나 설계도에 따른 건축 등 반복적인 게임 내 작업을 자동화합니다. Node.js로 게임 자동화와 프로토콜 처리를 학습합니다.
mineflayer는 어떻게 설치하나요?
nodejs.org에서 Node.js 18 이상을 설치합니다 mineflayer 패키지를 설치합니다: npm install mineflayer bot 스크립트를 만들고 서버에 연결합니다(README의 echo 예제 참조).
mineflayer은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/PrismarineJS/mineflayer

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트

Spigot에서 포크한 고성능 Minecraft 서버 소프트웨어로, 게임플레이 불일치를 수정하고 플러그인 API를 제공합니다.

백엔드·API#minecraft#minecraft-server#java
1.3만+12 이번 주3.6천JavaOther활발히 관리됨업데이트 어제