당신의 Minecraft를 자동으로 플레이하는 AI: mc_aiplayer 완벽 설명

번거로운 Minecraft 작업을 각각 커스텀 스크립트를 작성하지 않고 자동화하고 싶으셨나요? mc_aiplayer는 자연어 명령을 이해하고 채굴, 건축, 농사, 전투, 생존 같은 복잡한 다단계 작업을 하드코딩 없이 자율적으로 실행하는 실제 서버 측 AI 플레이어를 생성하는 Fabric 모드입니다.

이 프로젝트의 역할

mc_aiplayer는 Minecraft 1.21.3용 서버 측 Fabric 모드로, 자율 AI 에이전트를 당신의 세계에 가져옵니다. 목표를 영어로 입력하면 - '다이아몬드 3개 채굴' 또는 '집 짓기' - 모드의 통합 LLM(기본값 DeepSeek 또는 OpenAI 호환 모델)이 그 목표를 계획으로 분해한 후 단계별로 실행합니다. 클라이언트 측 모드나 치트가 아니며, 정상적인 게임 규칙을 따르고 실제 사람처럼 세계와 상호작용하는 정당한 가짜 플레이어를 생성합니다.

아키텍처가 정교합니다. AI가 무작위 Minecraft 작업을 환각하게 하는 대신(그러면 혼란스러울 것입니다), 시스템은 의사결정을 실행에서 분리합니다. LLM이 62개의 내장 도구 중에서 선택하여 '무엇을' 할지 결정하고, 결정적 작업 엔진이 '어떻게' 안정적으로 할지 처리합니다. 모호한 지시를 이해하고 세부 사항을 자체적으로 파악할 수 있는 매우 똑똑한 노동자를 고용하는 것으로 생각하세요.

Java로 작성되었으며 211개의 GitHub 스타와 MIT 라이선스를 가지고 있으며, 타협 없이 자동화를 원하는 서버 운영자와 모드팩 제작자를 위해 설계되었습니다.

사용 사례

실용적인 사용 사례는 몇 가지 범주로 나뉩니다:

• 번거로운 자원 수집. 64개의 참나무 통나무나 5묶음의 자갈을 수집하도록 지시하고 나중에 확인하세요. 건축용 자재를 위한 돌 채굴? 봇이 처리하도록 하고 당신은 더 재미있는 작업에 집중하세요.
• 몹 팜 디버깅. 팜을 설정하고 AI에게 그 안에 서서 드롭을 수집하면서 실제로 속도가 괜찮은지 테스트하도록 요청하세요. 지루한 대기 없이 실제 검증할 수 있습니다.
• 월드 건축 지원. 봇이 반복적인 작업을 실행하도록 하면 - 지형 평탄화, 다리 건축, 자동 작물 심기 - 당신은 디자인과 배치에 집중할 수 있습니다.
• SMP 서버 자동화. 커뮤니티 서버를 운영 중이라면 자동화된 이벤트, 자원 생성, 플레이어 명령에 응하는 NPC 같은 동작의 가능성이 열립니다.
• 테스트 및 콘텐츠 제작. YouTuber와 모드팩 개발자는 이것을 사용하여 모든 단계를 수동으로 플레이할 필요 없이 종단 간 워크플로우를 빠르게 시연하거나 모드 상호작용을 테스트할 수 있습니다.

이는 게임이 스스로를 플레이하는 동안 AFK 하고 싶은 플레이어를 위한 것이 아닙니다(그것은 Minecraft의 의미를 무시하는 것입니다). 이것은 게임이 특정 잡무를 처리하도록 하여 창의적이고 전략적인 부분에 집중할 수 있는 사람들을 위한 것입니다.

내부 작동 원리

여기가 mc_aiplayer가 흥미로워지는 부분입니다. 명령을 내리면 LLM은 당신의 목표와 봇의 현재 월드 상태(근처 블록, 인벤토리, 체력 등)를 받고, 62개의 사전 정의된 작업 중에서 선택하여 도구 호출을 사용합니다: 돌 채굴, 테이블 제작, 블록 배치, 동물 번식 등. LLM이 임의의 작업을 생성하지 않으며, 정해진 도구 세트 내에서 작동하므로 안정성을 유지합니다.

LLM이 시퀀스를 계획하면 별도의 작업 실행자가 이를 통해 실행합니다. 따라서 명령이 '집 짓기'였다면 계획은 다음과 같을 수 있습니다: 나무 50개 수집 - 판자 제작 - 나무 곡괭이 제작 - 돌 채굴 - 작업대 제작 - 직사각형 모양의 블록 배치 - 지붕 추가. 각 단계는 실행자가 이러한 작업을 '어떻게' 하는지 알고 있으므로 안정적입니다. LLM은 단지 순서와 맥락을 결정했을 뿐입니다.

모드는 봇이 갇히거나 멍청이처럼 죽지 않도록 5개의 안전 계층을 포함합니다: 체력 모니터링, 오류 로깅, 실패한 작업 재시도, 혼란스러울 때를 인식, 뭔가 정말 잘못되면 도움을 요청할 수 있습니다. 또한 어떤 도구에 접근할 수 있는지 구성할 수 있으므로, 더 엄격한 제어를 원한다면 특정 작업으로 제한할 수 있습니다.

그리고 서버 측이므로 클라이언트 주입이 없고, 제한된 서버에서 VAC 위험이 없으며(다만 서버 약관을 확인해야 함), 여러 플레이어가 봇과 함께 같은 월드에 공존할 수 있습니다.

설치 및 설정

여기서 솔직해져야 합니다: mc_aiplayer는 일반 플레이어가 아닌 서버 운영자를 대상으로 하는 기술적 프로젝트입니다. Fabric 모드를 설치해본 적이 없다면 학습 곡선이 있을 것입니다.

필요한 것:

• 버전 1.21.3의 Fabric 로더 0.18.4 이상을 실행하는 Minecraft 서버
• 서버에 설치된 Java 21
• DeepSeek, OpenAI 또는 호환 LLM 제공자의 API 키
• 기본적인 커맨드 라인 사용 능력

Fabric을 이미 설정했다면 실제 설치는 간단합니다: GitHub 릴리스에서 mc_aiplayer JAR을 다운로드하고, 서버의 `mods/` 폴더에 드롭하고, 재시작하고, 모드의 설정 파일에서 LLM API 자격증명을 구성하세요. README가 이를 안내하고, 모드는 처음 실행할 때 기본 설정을 생성합니다.

라이브가 되면 게임 내 명령으로 봇과 상호작용합니다. 다음과 같은 것:

/aibot brain say Bob mine 3 diamonds

이는 봇(기본값으로 'Bob'이라고 별명 지음)에게 다이아몬드 3개 채굴을 파악하고 실행하도록 지시합니다. 봇은 현재 상황을 평가하고, 시퀀스를 계획하고, 작업을 시작합니다. 정직하게 말해서, 봇에게 인벤토리를 확인하거나, 멈추거나, 작업 중 상태를 보고하도록 요청할 수도 있습니다.

제거는 깔끔합니다: 모드 JAR을 삭제하고 서버를 재시작하면 바닐라로 돌아갑니다. 월드나 설정에 영구 변경사항이 없습니다.

사람들을 헷갈리게 하는 것들

몇 가지 주의할 점이 있습니다:

LLM 지연 및 비용. 모든 명령은 DeepSeek 또는 OpenAI(또는 선택한 제공자)로 요청을 보내는데, 이는 몇 초 걸리고 API 비용이 발생합니다. 매일 수십 개의 명령을 내린다면 청구서를 확인하세요. DeepSeek은 GPT-4보다 더 저렴하므로 고려할 가치가 있습니다.

봇은 텔레파시가 없습니다. 필요한 자원을 볼 수 없으면 어디서 찾을지 마술적으로 알 수 없습니다. '다이아몬드 64개 채굴'은 다이아몬드가 예측 가능한 분포를 따르므로 작동합니다. '잃어버린 집 찾기'는 더 나은 맥락을 주지 않는 한 작동하지 않습니다.

여러 단어 명령은 신중한 표현이 필요합니다. '다이아몬드 3개 채굴'은 작동합니다. '다이아몬드를 찾아서 가져와'는 더 모호해서 예상대로 실행되지 않을 수 있습니다. LLM이 시도할 것이지만 구체성은 항상 도움이 됩니다.

봇이 활성화되어 있는 동안 서버 성능이 약간 저하됩니다(그것은 경로 찾기와 상호작용을 실행하는 또 다른 플레이어 엔티티입니다). 무겁게 로드된 서버에서는 버벅일 수 있습니다. 치명적이지는 않지만 자신의 하드웨어에서 먼저 테스트할 가치가 있습니다.

LLM API가 다운되거나 자격증명이 잘못되면 봇이 멈춥니다. 스크립팅된 동작으로의 폴백이 없습니다 - 단지 대기하거나 오류가 발생합니다. 설정 중에 API 자격증명이 올바른지 확인하세요.

이것이 하지 못하는 것(그리고 아직 할 수 없는 것)

mc_aiplayer는 강력하지만 실제 한계가 있습니다. Wither나 Ender Dragon과 안정적으로 싸울 수 없습니다 - 그것이 불가능해서가 아니라 그런 싸움이 혼란스럽고 봇의 감각 모델에 제약이 있기 때문입니다. 결과는 종일 채굴, 건축, 농사를 할 수 있지만 보스 레이드는? 아직 아닙니다.

또한 창발적 플레이를 이해하지 못합니다. 더 구조화된 지시 없이는 '탐험하면서 즐기기' 또는 '멋진 건축물 만들기'를 요청할 수 없습니다. 이것은 알려진 작업을 자동화하는 도구이지, 창의적인 협력자가 아닙니다(적어도 아직은 아닙니다).

그리고 PvP 서버에서 안티치트를 사용하면서 AFK 채굴을 합법적으로 만드는 방법을 찾고 있다면 이것이 아닙니다. 많은 서버에는 봇 동작을 감지하는 플러그인이 있으며, 허가 없이 사용하면 밴됩니다. 먼저 서버 규칙을 확인하세요. 기술적으로 서버 측이고 합법이지만 모두가 허용하는 것은 아닙니다.

알아두면 좋은 대안들

mc_aiplayer가 당신의 필요에 맞지 않으면 몇 가지 다른 프로젝트가 유사한 필요를 채웁니다. Carpet 모드는 특정 명령으로 스크립팅할 수 있는 가짜 플레이어 시스템을 가지고 있지만, Carpet의 도메인 언어를 배워야 합니다 - 자연어보다 덜 유연하지만 더 안정적입니다. Malilib 및 다른 클라이언트 측 자동화 도구도 있지만 서버 호환성 위험이 더 많습니다. 순수 자원 채굴을 위해서는 바닐라 팜 디자인과 몹 그라인더가 항상 봇보다 더 나을 것입니다(때때로 가장 단순한 해결책이 더 좋습니다).

하지만 자연어를 이해하고 코드 변경 없이 새로운 작업에 적응할 수 있는 AI를 원한다면 mc_aiplayer는 정말로 독특합니다.

시작하기 전에 당신의 Minecraft 버전이 최신인지 확인하세요. 우리는 우리의 Minecraft 서버 상태 확인기와 같은 다른 서버 유틸리티와 서버 인프라를 관리 중인 경우 네더 포털 계산기 같은 도구를 다뤘습니다.