
Sztuczna Inteligencja w Minecrafcie: mc_aiplayer
zoyluoblue/mc_aiplayer
Autonomiczny agent AI, który gra w Minecrafta samodzielnie - mod Fabric po stronie serwera (MC 1.21.3), gdzie DeepSeek/OpenAI-kompatybilny LLM steruje rzeczywistym graczem do kopania, budowania, uprawy, walki i przetrwania na podstawie poleceń w języku naturalnym. LLM planuje, determinujące zadania wykonują się.
Zobacz na GitHubie ↗Chciałeś kiedyś zautomatyzować nudne zadania w Minecrafcie bez pisania niestandardowego skryptu dla każdego z nich? mc_aiplayer to mod Fabric, który tworzy rzeczywistego gracza AI po stronie serwera, zdolnego do rozumienia poleceń w języku naturalnym i autonomicznego wykonywania złożonych wieloetapowych zadań - kopania, budowania, upraw, walki i przetrwania bez żadnych wstępnie napisanych instrukcji.
Co Ten Projekt Robi
mc_aiplayer to mod Fabric po stronie serwera dla Minecrafta 1.21.3, który wprowadza autonomicznego agenta AI do twojego świata. Dajesz mu cel w zwykłym polskim - "kopnij 3 diamenty" lub "zbuduj dom" - a zintegrowany LLM modu (domyślnie DeepSeek, lub dowolny kompatybilny model OpenAI) rozbija ten cel na plan, a następnie wykonuje go krok po kroku. To nie jest mod po stronie klienta ani oszustwo, tworzy on legalne fałszywe gracze, które przestrzegają normalnych zasad gry i wchodzą w interakcję ze światem jak rzeczywista osoba.
Architektura jest sprytna. Zamiast pozwolić AI na halucynacje losowych akcji Minecrafta (co byłoby chaosem), system dzieli podejmowanie decyzji od wykonania. LLM decyduje, co robić, wybierając z 62 wbudowanych narzędzi, a deterministyczny silnik zadań obsługuje, jak to robić niezawodnie. Pomyśl o tym jak wynajęcie bardzo inteligentnego pracownika, który potrafi zrozumieć niejasne instrukcje i sam siebie poradzić sobie ze szczegółami.
Napisane w Javie z 211 gwiazdkami na GitHubie i licencją MIT, przeznaczone jest dla operatorów serwerów i twórców modpacków, którzy chcą automatyzacji bez kompromisów.
Kiedy By To Użyć
Praktyczne przypadki użycia dzielą się na kilka kategorii:
- Nudne zbieranie zasobów. Powiedz mu, by zebrał 64 kloce drewna dębu lub 5 stosów bruku, i wróć później. Zmęczony drewnem do budowy? Niech bota się tym zajmie, podczas gdy ty pracujesz nad czymś ciekawym.
- Debugowanie farm modów. Ustaw farmę, poproś AI, by stało w niej i zbierało dropy, testując czy stawki są rzeczywiście przyzwoite. Walidacja w świecie rzeczywistym bez nudnego czekania.
- Pomoc w budowaniu świata. Niech bot wykonuje powtarzalne zadania - wyrównywanie terenu, budowanie mostów, automatyczne sadzenie upraw - aby ty mógł skupić się na designie i umieszczeniu.
- Automatyzacja serwera SMP. Jeśli prowadzisz serwer społeczności, to otwiera możliwości automatycznych zdarzeń, generowania zasobów, a nawet zachowań przypominających NPC-ów reagujących na polecenia graczy.
- Testowanie i tworzenie treści. YouTuberzy i twórcy modpacków mogą użyć tego do szybkiej demonstracji przepływów end-to-end lub testowania interakcji modów bez ręcznego grania w każdy krok.
To nie dla graczy szukających sposobu na AFK mining podczas zabawy gry samej w siebie (to pozbawia sens grania w Minecrafta). To dla ludzi, którzy chcą, żeby gra obsługiwała konkretne obowiązki, aby mogły skupić się na twórczych lub strategicznych częściach.
Jak To Działa Z Wewnątrz
Tu mc_aiplayer staje się interesujący. Gdy wydasz polecenie, LLM otrzymuje twój cel i bieżący stan świata bota (pobliskie bloki, inwentarz, zdrowie itp.), a następnie używa tool-callingu do wyboru z 62 predefiniowanych zadań: kopanie kamienia, tworzenie stołu, umieszczanie bloku, rozmnażanie zwierząt i tak dalej. LLM nie generuje arbitralnych akcji, pracuje w ograniczonym zestawie narzędzi, co utrzymuje rzeczy stabilnymi.
Po zaplanowaniu sekwencji przez LLM, osobny wykonawca zadań przebiega przez nią. Tak więc jeśli twoje polecenie brzmiało "zbuduj dom", plan może być: zbierz 50 drewna - wykonaj deski - wykonaj drewniany hak - kopnij kamień - wykonaj stół rzemieślniczy - umieść bloki w prostokącie - dodaj dach. Każdy krok jest niezawodny, ponieważ wykonawca wie, jak to robić, LLM po prostu zdecydował o kolejności i kontekście.
Mod zawiera pięć warstw bezpieczeństwa, aby uniemożliwić botowi utknięcie lub głupie zgubienie: monitoruje zdrowie, rejestruje błędy, ponawiają nieudane zadania, wie, kiedy jest zdezorientowany i może poprosić o pomoc człowieka, jeśli coś naprawdę pójdzie nie tak. Możesz również skonfigurować, do których narzędzi ma dostęp, ograniczając go do konkretnych zadań, jeśli chcesz bardziej ścisłą kontrolę.
A ponieważ jest to mod po stronie serwera, nie ma wstrzyknięcia po stronie klienta, nie ma ryzyka VAC na ograniczonych serwerach (choć powinieneś sprawdzić zasady serwera) i wielu graczy może współistnieć z botem na tym samym świecie.
Instalacja i Konfiguracja
Tu muszę być szczery: mc_aiplayer to projekt techniczny skierowany do operatorów serwerów, a nie zwykłych graczy. Jeśli nigdy wcześniej nie instalowałeś modu Fabric, będzie to krzywa nauki.

Co będziesz potrzebować:
- Serwer Minecrafta z loader Fabric 0.18.4+ na wersji 1.21.3
- Java 21 zainstalowana na serwerze
- Klucz API od DeepSeek, OpenAI lub kompatybilnego dostawcy LLM
- Podstawowa wygoda przy pracy z linią poleceń
Rzeczywista instalacja jest prosta, jeśli już masz Fabric: pobierz JAR mc_aiplayer z wydań GitHub, upuść go do folderu `mods/` serwera, uruchom ponownie i skonfiguruj poświadczenia API LLM w pliku konfiguracyjnym modu. README przechodził przez to, a mod generuje domyślną konfigurację przy pierwszym uruchomieniu.
Po uruchomieniu będziesz wchodzić w interakcję z botem za pośrednictwem poleceń w grze. Coś w stylu:
/aibot brain say Bob kopnij 3 diamentyTo mówi botowi (nazwanemu domyślnie "Bob"), aby zastanowił się i wykonał kopanie 3 diamentów. Bot oceni swoją obecną sytuację, zaplanuje sekwencję i weźmie się do roboty. Szczerze mówiąc, możesz go również poprosić, by sprawdził inwentarz, zatrzymał się lub zgłosił status podczas zadania.
Usunięcie go jest czyste: Usuń JAR modu, uruchom ponownie serwer i jesteś z powrotem do vanilla. Brak stałych zmian w świecie lub konfigach.
Co Myli Ludzi
Kilka pułapek warte wiedzy:
Opóźnienie LLM i koszty. Każde polecenie wysyła żądanie do DeepSeek lub OpenAI (lub wybranego dostawcy), co zajmuje kilka sekund i wiąże się z kosztami API. Jeśli wydajesz dziesiątki poleceń dziennie, obserwuj rachunek. DeepSeek jest bardziej przystępny niż GPT-4, co warte rozważenia.
Bot nie ma telepatii. Jeśli nie widzi zasobu, którego potrzebuje, nie będzie magicznie wiedzieć, gdzie go znaleźć. "Kopnij 64 diamenty" działa, ponieważ diamenty podlegają przewidywalnej dystrybucji, "znajdź mój zagubiony dom" nie będzie działać, jeśli nie dasz mu lepszego kontekstu.
Wielowyrazowe polecenia wymagają ostrożnego sformułowania. "Kopnij 3 diamenty" działa. "Pójdź znaleźć diamenty i przynieś je z powrotem" jest mgliste i może nie wykonać się zgodnie z planem. LLM spróbuje, ale konkretność zawsze pomaga.
Wydajność serwera odbiera niewielki uszkodzenie, gdy bot jest aktywny (to inny gracz pracujący nad znalezieniem ścieżek i interakcjami), więc na serwerach o dużym obciążeniu, możesz zauważyć przywary. Nie katastrofalne, ale warte testowania na własnym sprzęcie najpierw.
Jeśli API LLM upadnie lub poświadczenia są błędne, bot zatrzymuje się na zimno. Nie ma powrotu do zachowania ze skryptami - po prostu czeka lub zwraca błąd. Upewnij się, że poświadczenia API są poprawne podczas konfiguracji.
Co To Nie Jest (i Co Nie Potrafi)
mc_aiplayer jest potężny, ale ma rzeczywiste ograniczenia. Nie potrafi walczyć z Witherą lub Ender Dragonem niezawodnie - nie dlatego, że jest to niemożliwe, ale dlatego że walki są chaotyczne, a sensoryczny model bota ma ograniczenia. Rezultat może kopać, budować i uprawiać cały dzień, ale bitwy z bossami? Jeszcze nie.
Również nie rozumie emergentnej zabawy. Nie możesz poprosić go, by "fajnie się bawił, odkrywając" lub "stworzył fajną budowlę" bez bardziej ustrukturyzowanych instrukcji. To narzędzie do automatyzacji znanych zadań, a nie kreatywny kolaborator (jeszcze nie).
I jeśli szukasz sposobu, aby uczynić AFK mining zabawnym lub legalnym na serwerze PvP z anty-cheatem, to nie jest to. Wiele serwerów ma pluginy, które wykrywają zachowanie botów, a użycie tego bez pozwolenia cię zabanuje. Najpierw sprawdź zasady serwera. Mimo że jest to po stronie serwera i technicznie legalne, nie wszyscy to pozwalają.
Alternatywy Warte Poznania
Jeśli mc_aiplayer nie odpowiada Twoim potrzebom, kilka innych projektów odpowiada na podobne potrzeby. Carpet mod ma system fałszywych graczy, którym możesz sterować przy użyciu konkretnych poleceń, ale wymaga nauki języka Carpet - mniej elastyczne niż język naturalny, ale bardziej stabilne. Jest również Malilib i inne narzędzia automatyzacji po stronie klienta, choć wiążą się one z większym ryzykiem kompatybilności serwera. A dla czystego zarabiania zasobów, projekty vanilla i moby-grinders zawsze będą działać lepiej niż jakikolwiek bot (czasami najprostsze rozwiązanie jest lepsze).
Ale jeśli chcesz AI, które rozumie język naturalny i może adaptować się do nowych zadań bez zmian kodu, mc_aiplayer jest naprawdę unikatowy.
Zanim zaczniesz, upewnij się, że twoja wersja Minecrafta jest aktualna. Omówiliśmy inne narzędzia serwerowe, takie jak nasz Checker Statusu Serwera Minecraft i narzędzia takie jak Kalkulator Portalu Netheru, jeśli zarządzasz infrastrukturą serwera.
Lead writer at minecraft.how. Long-time Minecraft player running a small SMP server, testing every build, mod, and seed before writing about it.


