zoyluoblue/mc_aiplayer
Autonomiczny agent AI, który samodzielnie gra w Minecraft. Ten serwerowy mod Fabric dla MC 1.21.3 pozwala modelowi LLM zgodnemu z DeepSeek lub OpenAI sterować prawdziwym graczem, aby wydobywał surowce, budował, uprawiał rośliny, walczył i próbował przetrwać na podstawie poleceń w języku naturalnym. LLM tworzy plan, a deterministyczne zadania go wykonują.
Zobacz na GitHubie ↗Chcesz automatyzować żmudne zadania w Minecraft bez pisania osobnego skryptu dla każdego z nich? mc_aiplayer to mod Fabric, który tworzy prawdziwego gracza AI po stronie serwera. Potrafi on rozumieć polecenia w języku naturalnym i samodzielnie wykonywać złożone, wieloetapowe zadania, takie jak wydobywanie surowców, budowanie, uprawa roślin, walka i przetrwanie, bez sztywno zaprogramowanych instrukcji.
Co robi ten projekt
mc_aiplayer to serwerowy mod Fabric dla Minecraft 1.21.3, który wprowadza do świata autonomicznego agenta AI. Podajesz mu cel po angielsku, na przykład "mine 3 diamonds" albo "build a house", a zintegrowany z modem model LLM, domyślnie DeepSeek lub dowolny model zgodny z OpenAI, dzieli ten cel na plan i wykonuje go krok po kroku. Nie jest to mod kliencki ani oszustwo. Tworzy pełnoprawnego sztucznego gracza, który przestrzega zwykłych zasad gry i wchodzi w interakcje ze światem podobnie jak prawdziwa osoba.
Architektura została sprytnie zaprojektowana. Zamiast pozwalać AI wymyślać przypadkowe działania w Minecraft, co szybko doprowadziłoby do chaosu, system oddziela podejmowanie decyzji od ich wykonywania. LLM wybiera, *co* zrobić, korzystając z 62 wbudowanych narzędzi, a deterministyczny silnik zadań odpowiada za niezawodne wykonanie, czyli *jak* to zrobić. Można to porównać do zatrudnienia bardzo bystrego pracownika, który rozumie ogólne polecenia i potrafi samodzielnie ustalić szczegóły.
Projekt napisano w Java, udostępniono na licencji MIT i zdobył on 211 gwiazdek na GitHubie. Powstał z myślą o administratorach serwerów oraz twórcach modpacków, którzy chcą automatyzować zadania bez zbędnych kompromisów.
Kiedy warto go używać
Praktyczne zastosowania można podzielić na kilka grup:
- Żmudne zbieranie surowców. Poleć botowi zebrać 64 dębowe kłody albo 5 stosów bruku i wróć do niego później. Potrzebujesz mnóstwa kamienia do budowy? Pozwól botowi zająć się pracą, a sam skup się na czymś ciekawszym.
- Testowanie farm mobów. Zbuduj farmę, poproś AI, aby w niej stanęła i zbierała przedmioty, a następnie sprawdź, czy wydajność jest rzeczywiście dobra. Otrzymujesz test w prawdziwych warunkach bez nudnego czekania.
- Pomoc w kształtowaniu świata. Bot może wykonywać powtarzalne zadania, takie jak wyrównywanie terenu, budowanie mostów czy automatyczne sadzenie roślin. Ty możesz w tym czasie skupić się na projekcie i rozmieszczeniu elementów.
- Automatyzacja serwera SMP. Na serwerze społecznościowym mod otwiera drogę do automatycznych wydarzeń, pozyskiwania zasobów, a nawet zachowań przypominających NPC, które reagują na polecenia graczy.
- Testowanie i tworzenie treści. YouTuberzy i autorzy modpacków mogą szybko prezentować kompletne procesy lub sprawdzać interakcje między modami bez ręcznego wykonywania każdego kroku.
Nie jest to rozwiązanie dla graczy, którzy chcą przejść w tryb AFK i pozwolić, aby gra działała za nich, bo mijałoby się to z celem Minecraft. To narzędzie dla osób, które chcą zlecić grze konkretne obowiązki i skupić się na kreatywnych lub strategicznych aspektach rozgrywki.
Jak to działa od środka
W tym miejscu mc_aiplayer robi się naprawdę interesujący. Gdy wydasz polecenie, LLM otrzymuje Twój cel oraz aktualne informacje o świecie bota, między innymi o pobliskich blokach, ekwipunku i zdrowiu. Następnie wybiera spośród 62 zdefiniowanych zadań za pomocą wywoływania narzędzi. Może na przykład wydobyć kamień, stworzyć stół rzemieślniczy, postawić blok albo rozmnożyć zwierzęta. LLM nie generuje dowolnych działań, lecz korzysta z ograniczonego zestawu narzędzi, dzięki czemu system zachowuje stabilność.
Po utworzeniu sekwencji przez LLM osobny moduł wykonuje kolejne zadania. Jeśli polecenie brzmiało "build a house", plan może wyglądać tak: zbierz 50 sztuk drewna → stwórz deski → stwórz drewniany kilof → wydobądź kamień → stwórz stół rzemieślniczy → ustaw bloki w prostokąt → dodaj dach. Każdy krok jest niezawodny, ponieważ moduł wykonawczy *wie*, jak zrealizować te czynności. LLM ustala jedynie ich kolejność i kontekst.
Mod ma pięć warstw zabezpieczeń, które zapobiegają utknięciu bota lub jego bezsensownej śmierci. Monitoruje zdrowie, zapisuje błędy, ponawia nieudane zadania, rozpoznaje własne zagubienie i może poprosić człowieka o pomoc, jeśli rzeczywiście wydarzy się coś nieprzewidzianego. Możesz także określić, do których narzędzi bot ma dostęp, i ograniczyć go do wybranych zadań, aby zachować większą kontrolę.
Ponieważ mod działa po stronie serwera, nie wymaga ingerencji w klienta i nie powoduje ryzyka związanego z VAC na serwerach z ograniczeniami, choć zawsze należy sprawdzić regulamin danego serwera. Wielu graczy może również przebywać z botem w tym samym świecie.
Instalacja i konfiguracja
Trzeba powiedzieć to wprost: mc_aiplayer jest technicznym projektem przeznaczonym głównie dla administratorów serwerów, a nie dla okazjonalnych graczy. Jeśli nigdy wcześniej nie instalowałeś moda Fabric, opanowanie procesu może zająć trochę czasu.

Czego potrzebujesz:
- Serwera Minecraft 1.21.3 z Fabric Loader 0.18.4 lub nowszym
- Java 21 zainstalowanej na serwerze
- Klucza API od DeepSeek, OpenAI lub innego zgodnego dostawcy LLM
- Podstawowej znajomości wiersza poleceń
Sama instalacja jest prosta, jeśli korzystasz już z Fabric. Pobierz plik JAR mc_aiplayer z wydań na GitHubie, umieść go w folderze `mods/` serwera, uruchom serwer ponownie i wpisz dane dostępowe do API LLM w pliku konfiguracyjnym moda. README opisuje cały proces, a podczas pierwszego uruchomienia mod tworzy domyślną konfigurację.
Po uruchomieniu będziesz komunikować się z botem za pomocą poleceń w grze. Na przykład:
/aibot brain say Bob mine 3 diamondsTo polecenie nakazuje botowi, który domyślnie ma pseudonim "Bob", opracować sposób na wydobycie 3 diamentów i wykonać zadanie. Bot oceni swoją obecną sytuację, zaplanuje kolejne kroki i zabierze się do pracy. Możesz również poprosić go o sprawdzenie ekwipunku, zatrzymanie się lub podanie stanu zadania w trakcie jego wykonywania.
Usunięcie moda jest proste: Usuń plik JAR moda, uruchom serwer ponownie i możesz znów grać w czystą wersję gry. Mod nie wprowadza trwałych zmian w świecie ani konfiguracji.
Najczęstsze problemy
Warto pamiętać o kilku pułapkach:
Opóźnienia i koszty LLM. Każde polecenie wysyła żądanie do DeepSeek, OpenAI lub wybranego przez Ciebie dostawcy. Odpowiedź zajmuje kilka sekund i generuje koszty API. Jeśli codziennie wydajesz dziesiątki poleceń, kontroluj rachunki. DeepSeek jest tańszy od GPT-4, co warto uwzględnić przy wyborze.
Bot nie czyta w myślach. Jeśli nie widzi potrzebnego zasobu, nie będzie w magiczny sposób wiedział, gdzie go znaleźć. Polecenie "mine 64 diamonds" może zadziałać, ponieważ diamenty pojawiają się według przewidywalnego rozkładu. Polecenie "find my lost house" nie zadziała bez dokładniejszych informacji.
Wielowyrazowe polecenia należy formułować uważnie. "Mine 3 diamonds" jest konkretne. "Go find diamonds and bring them back" pozostawia więcej miejsca na interpretację i może nie zostać wykonane zgodnie z oczekiwaniami. LLM spróbuje zrealizować zadanie, ale precyzyjne instrukcje zawsze pomagają.
Aktywny bot nieznacznie obciąża serwer, ponieważ jest kolejnym graczem korzystającym z wyznaczania ścieżek i interakcji. Na mocno obciążonych serwerach mogą pojawić się przycięcia. Nie powinno to powodować poważnych problemów, ale najpierw warto przeprowadzić test na własnym sprzęcie.
Jeśli API LLM przestanie działać albo dane dostępowe będą nieprawidłowe, bot natychmiast się zatrzyma. Nie ma awaryjnego trybu opartego na skryptach, więc będzie jedynie czekał lub zgłaszał błędy. Podczas konfiguracji dokładnie sprawdź dane dostępowe do API.
Czym ten mod nie jest i czego nie potrafi
mc_aiplayer ma duże możliwości, ale także wyraźne ograniczenia. Nie potrafi niezawodnie walczyć z Witherem ani Ender Dragonem. Nie dlatego, że jest to całkowicie poza jego zasięgiem, lecz dlatego, że takie walki są chaotyczne, a model postrzegania otoczenia przez bota ma swoje ograniczenia. Bot może przez cały dzień wydobywać surowce, budować i uprawiać rośliny, ale starcia z bossami nadal są dla niego zbyt wymagające.
Nie rozumie także swobodnej, spontanicznej zabawy. Nie możesz po prostu polecić mu "have fun exploring" ani "create a cool build" bez dodania bardziej uporządkowanych instrukcji. To narzędzie do automatyzacji znanych zadań, a nie kreatywny współpracownik, przynajmniej na razie.
Nie jest to również sposób na bezpieczne ani uczciwe kopanie w trybie AFK na serwerze PvP z systemem anti-cheat. Wiele serwerów korzysta z pluginów wykrywających zachowanie botów, a używanie tego moda bez pozwolenia może skończyć się banem. Najpierw sprawdź zasady serwera. Choć z technicznego punktu widzenia mod działa legalnie po stronie serwera, nie wszędzie jest dozwolony.
Alternatywy, które warto znać
Jeśli mc_aiplayer nie odpowiada Twoim potrzebom, istnieje kilka projektów o podobnym zastosowaniu. Mod Carpet zawiera system sztucznych graczy, którym można wydawać konkretne polecenia za pomocą skryptów, ale wymaga poznania języka dziedzinowego Carpet. Jest mniej elastyczny niż język naturalny, lecz bardziej stabilny. Dostępne są też Malilib i inne klienckie narzędzia automatyzujące, choć wiążą się z większym ryzykiem problemów ze zgodnością serwerów. Jeśli zależy Ci wyłącznie na masowym pozyskiwaniu surowców, farmy i generatory mobów zbudowane w czystej wersji gry zawsze będą wydajniejsze od dowolnego bota. Czasami najprostsze rozwiązanie jest najlepsze.
Jeżeli jednak szukasz AI, która rozumie język naturalny i może dostosowywać się do nowych zadań bez zmiany kodu, mc_aiplayer jest naprawdę wyjątkowy.
Zanim zaczniesz, upewnij się, że używasz aktualnej wersji Minecraft. Jeśli zarządzasz infrastrukturą serwera, sprawdź również inne nasze narzędzia, takie jak narzędzie do sprawdzania stanu serwera Minecraft oraz kalkulator portali do Netheru.



