Skip to content
Retour au Blog
L'IA qui joue Minecraft pour vous - mc_aiplayer expliqué

L'IA qui joue Minecraft pour vous - mc_aiplayer expliqué

Alexandru Maftei
Alexandru Maftei
@ice
Updated
3 vues
TL;DR:mc_aiplayer est un mod Fabric qui crée un joueur IA autonome capable de comprendre des commandes en langage naturel et d'exécuter des tâches Minecraft complexes - extraction minière, construction, agriculture et survie - sans scripts préprogrammés. Il est conçu pour les opérateurs de serveurs en quête d'une automatisation intelligente.
🐐 Projet Minecraft open-source

zoyluoblue/mc_aiplayer

Agent IA autonome qui joue à Minecraft de lui-même - un mod Fabric côté serveur (MC 1.21.3) où un LLM DeepSeek / compatible OpenAI contrôle un vrai joueur pour extraire, construire, cultiver, combattre et survivre à partir de commandes en langage naturel. Le LLM planifie, les tâches déterministes s'exécutent.

⭐ 211 étoiles💻 Java📄 MIT
Voir sur GitHub ↗

Avez-vous jamais souhaité automatiser des tâches Minecraft fastidieuses sans écrire un script personnalisé pour chacune ? mc_aiplayer est un mod Fabric qui crée un véritable joueur IA côté serveur capable de comprendre des commandes en langage naturel et d'exécuter de manière autonome des tâches complexes à plusieurs étapes - extraction minière, construction, agriculture, combat et survie sans aucune instruction préprogrammée.

Ce que fait ce projet

mc_aiplayer est un mod Fabric côté serveur pour Minecraft 1.21.3 qui apporte un agent IA autonome dans votre monde. Vous lui donnez un objectif en anglais simple - « extraire 3 diamants » ou « construire une maison » - et le LLM intégré du mod (DeepSeek par défaut, ou tout modèle compatible OpenAI) décompose cet objectif en un plan, puis l'exécute étape par étape. Ce n'est pas un mod côté client ou une triche ; il crée un vrai faux joueur qui suit les règles normales du jeu et interagit avec le monde comme le ferait une vraie personne.

L'architecture est ingénieuse. Plutôt que de laisser l'IA halluciner des actions Minecraft aléatoires (ce qui serait le chaos), le système sépare la prise de décision de l'exécution. Le LLM décide *quoi* faire en choisissant parmi 62 outils intégrés, et un moteur de tâches déterministe gère *comment* le faire de manière fiable. Pensez-y comme engager un travailleur très intelligent qui peut comprendre des instructions vagues et découvrir les détails lui-même.

Écrit en Java avec 211 étoiles GitHub et une licence MIT, il est conçu pour les opérateurs de serveurs et les créateurs de modpacks qui veulent l'automatisation sans compromis.


Quand l'utiliser

Les cas d'usage pratiques se divisent en quelques catégories :

  • Collecte fastidieuse de ressources. Dites-lui de collecter 64 bûches de chêne ou 5 piles de pierre et revenez plus tard. Moudre la pierre pour les matériaux de construction ? Laissez le bot s'en charger pendant que vous travaillez sur quelque chose d'intéressant.
  • Débogage de la ferme de créatures. Configurez une ferme, demandez à l'IA de s'y tenir et de collecter les objets lâchés tout en testant si les taux sont vraiment décents. Validation du monde réel sans l'attente ennuyeuse.
  • Assistance à la construction du monde. Faites exécuter par le bot des tâches répétitives - aplatissement du terrain, construction de ponts, plantation automatique de cultures - pour que vous puissiez vous concentrer sur la conception et le placement.
  • Automatisation du serveur SMP. Si vous gérez un serveur communautaire, cela ouvre des possibilités pour des événements automatisés, la génération de ressources, voire des comportements de type NPC qui répondent aux commandes des joueurs.
  • Test et création de contenu. Les YouTubers et les développeurs de modpacks peuvent l'utiliser pour démontrer rapidement des flux de travail de bout en bout ou tester les interactions des mods sans jouer manuellement chaque étape.

Ce n'est pas pour les joueurs qui veulent AFK pendant que le jeu se joue lui-même (cela va à l'encontre du but de Minecraft). C'est pour les gens qui veulent que le jeu gère des tâches spécifiques pour qu'ils puissent se concentrer sur les parties créatives ou stratégiques.


Comment ça fonctionne sous le capot

C'est ici que mc_aiplayer devient intéressant. Quand vous émettez une commande, le LLM reçoit votre objectif et l'état actuel du monde du bot (blocs à proximité, inventaire, santé, etc.), puis utilise l'appel d'outils pour choisir parmi 62 tâches prédéfinies : extraire la pierre, fabriquer une table, placer un bloc, élever des animaux, et ainsi de suite. Le LLM ne génère pas d'actions arbitraires ; il fonctionne dans un ensemble limité d'outils, ce qui maintient les choses stables.

Une fois que le LLM planifie une séquence, un exécuteur de tâches distinct la parcourt. Donc, si votre commande était « construire une maison », le plan pourrait être : récolter 50 bois - fabriquer des planches - fabriquer une pioche en bois - extraire la pierre - fabriquer une table de fabrication - placer les blocs en rectangle - ajouter un toit. Chaque étape est fiable parce que l'exécuteur *sait* comment faire ces choses ; le LLM a juste décidé l'ordre et le contexte.

Le mod comprend cinq couches de sécurité pour empêcher le bot de rester bloqué ou de mourir bêtement : il surveille la santé, enregistre les erreurs, réessaie les tâches échouées, sait quand il est confus et peut demander l'aide humaine si quelque chose va vraiment mal. Vous pouvez également configurer les outils auxquels il a accès, en le limitant à des tâches spécifiques si vous souhaitez un contrôle plus strict.

Et comme c'est côté serveur, il n'y a pas d'injection côté client, aucun risque VAC sur les serveurs restreints (bien que vous deviez vérifier les conditions de votre serveur), et plusieurs joueurs peuvent coexister avec le bot dans le même monde.


Installation et configuration

C'est ici que je dois être honnête : mc_aiplayer est un projet technique destiné aux opérateurs de serveurs, pas aux joueurs occasionnels. Si vous n'avez jamais installé de mod Fabric auparavant, ce sera une courbe d'apprentissage.

Capture d'écran du projet
Capture d'écran du projet

Ce dont vous aurez besoin :

  • Un serveur Minecraft exécutant Fabric loader 0.18.4+ sur la version 1.21.3
  • Java 21 installé sur le serveur
  • Une clé API de DeepSeek, OpenAI, ou un fournisseur LLM compatible
  • Aisance de base avec la ligne de commande

L'installation réelle est simple si vous avez déjà Fabric : téléchargez le JAR mc_aiplayer depuis les versions GitHub, déposez-le dans le dossier `mods/` de votre serveur, redémarrez et configurez vos identifiants API LLM dans le fichier de configuration du mod. Le README vous guide à travers cela, et le mod génère une configuration par défaut au premier lancement.

Une fois actif, vous interagirez avec le bot via des commandes en jeu. Quelque chose comme :

bash
/aibot brain say Bob mine 3 diamonds

Cela dit au bot (surnommé « Bob » par défaut) de déterminer et d'exécuter l'extraction de 3 diamants. Le bot évaluera sa situation actuelle, planifiera la séquence et se mettra au travail. Vous pouvez aussi lui demander de vérifier son inventaire, d'arrêter ou de signaler l'état de la tâche en cours.

La suppression est simple : supprimez le JAR du mod, redémarrez le serveur, et vous êtes de retour à la vanille. Aucun changement permanent pour votre monde ou vos configurations.


Ce qui pose problème aux gens

Quelques pièges utiles à connaître :

Latence du LLM et coûts. Chaque commande envoie une demande à DeepSeek ou OpenAI (ou votre fournisseur choisi), ce qui prend quelques secondes et entraîne des frais d'API. Si vous émettez des dizaines de commandes quotidiennement, surveillez votre facture. DeepSeek est plus abordable que GPT-4, ce qui vaut la peine d'être considéré.

Le bot n'a pas la télépathie. S'il ne peut pas voir une ressource dont il a besoin, il ne saura pas magiquement où la trouver. « Extraire 64 diamants » fonctionne parce que les diamants suivent une distribution prévisible ; « trouver ma maison perdue » ne fonctionnera pas à moins que vous lui donniez un meilleur contexte.

Les commandes multi-mots nécessitent une formulation soigneuse. « Extraire 3 diamants » fonctionne. « Aller chercher des diamants et les ramener » est plus vague et pourrait ne pas s'exécuter comme prévu. Le LLM essaiera, mais la spécificité aide toujours.

Les performances du serveur diminuent légèrement tandis que le bot est actif (c'est une autre entité joueur exécutant la recherche de chemin et les interactions), donc sur les serveurs très chargés, vous remarquerez peut-être des ralentissements. Pas catastrophique, mais cela vaut la peine d'être testé sur votre propre matériel d'abord.

Si l'API du LLM tombe en panne ou si vos identifiants sont incorrects, le bot s'arrête complètement. Il n'y a pas de fallback au comportement scriptée - il attend ou affiche une erreur. Assurez-vous que vos identifiants API sont corrects lors de la configuration.


Ce que ce n'est pas (et ce qu'il ne peut pas faire)

mc_aiplayer est puissant, mais il a de vraies limites. Il ne peut pas combattre le Wither ou le dragon de l'End de manière fiable - pas parce qu'il en est incapable, mais parce que ces combats sont chaotiques et que le modèle sensoriel du bot a des contraintes. Le résultat peut extraire, construire et cultiver toute la journée, mais les raids de boss ? Pas encore.

Il ne comprend pas non plus le jeu émergeant. Vous ne pouvez pas lui demander de « s'amuser à explorer » ou « créer une construction cool » sans instructions plus structurées. C'est un outil pour automatiser les tâches connues, pas un collaborateur créatif (du moins pas encore).

Et si vous cherchez un moyen de rendre l'extraction AFK amusante ou légitime sur un serveur PvP avec anti-triche, ce n'est pas ça. De nombreux serveurs ont des plugins qui détectent le comportement des bots, et utiliser ceci sans permission vous fera bannir. Vérifiez d'abord les règles de votre serveur. Même s'il s'agit côté serveur et légalement légitime, tout le monde ne le permet pas.


Alternatives utiles à connaître

Si mc_aiplayer ne répond pas à vos besoins, quelques autres projets répondent à des problèmes similaires. Le mod Carpet a un système de faux joueur que vous pouvez scripter avec des commandes spécifiques, mais il faut apprendre le langage de domaine de Carpet - moins flexible que le langage naturel, mais plus stable. Il y a aussi Malilib et d'autres outils d'automatisation côté client, bien que ceux-ci comportent plus de risques de compatibilité serveur. Et pour l'extraction pure de ressources, les conceptions de fermes vanille et les moulins à créatures surpasseront toujours n'importe quel bot (parfois la solution la plus simple est la meilleure).

Mais si vous voulez une IA qui comprend le langage naturel et peut s'adapter à de nouvelles tâches sans modifications de code, mc_aiplayer est véritablement unique.

Avant de commencer, assurez-vous que votre version de Minecraft est à jour. Nous avons couvert d'autres utilitaires serveur comme notre vérificateur d'état du serveur Minecraft et des outils comme la calculatrice du portail du Nether si vous gérez l'infrastructure du serveur.

À propos de l auteur
Alexandru Maftei
Alexandru MafteiRédacteur principal

Lead writer at minecraft.how. Long-time Minecraft player running a small SMP server, testing every build, mod, and seed before writing about it.

Partage avec tes amis !