robin4002 robin4002
29 nov. 2015, 16:42

youtubeCe tutoriel est également disponible en vidéo.

Sommaire

Introduction

Dans ce tutoriel nous allons installer l’espace de travail de Forge pour Eclipse à l’aide de Forge Gradle.

Pré-requis

Télécharger et configurer le MDK (Mod Development Kit)

Rendez-vous sur le site de téléchargement de Forge et prenez au choix soit la version recommandée soit la dernière version disponible. Passez la souris sur la version de Minecraft pour faire apparaître les sous versions (par exemple passez la souris sur 1.8 pour voir le bouton 1.8, le bouton 1.8.8 et le bouton 1.8.9) puis cliquez sur la version que Minecraft que vous souhaitez modder. Ensuite cliquez sur MDK, la page sponsorisée va s’ouvrir. Au bout de 5 secondes cliquez en haut à droite sur “skip” pour lancer le téléchargement.

Une fois le téléchargement fini il faut extraire l’archive dans le dossier de votre choix (on appellera par la suite ce dossier le dossier de Forge ou du mdk). Il faut absolument éviter les espaces et les caractères spéciaux (accent, point d’exclamation, etc.) dans le chemin de ce dossier, ils sont sources de problème (dossier vide une fois qu’on arrive sur Eclipse).
Ouvrez le fichier build.gradle avec un éditeur de texte. Nous allons modifier les trois lignes suivantes :

version = "1.0"
group= "com.yourname.modid" // http://maven.apache.org/guides/mini/guide-naming-conventions.html
archivesBaseName = "modid"

La première ligne est la version de votre mod. Vous pouvez laisser 1.0 ou mettre autre chose.
Le groupe fonctionne comme pour le nom des packages (voir début du tutoriel sur la base de Java). Dans mon cas ce sera fr.minecraftforgefrance.modtutoriel.
Et pour finir archivesBaseName est le nom du jar de votre mod. Il y sera ajouté -<version du mod>.jar lors de la compilation. Dans mon cas ce sera ModTutoriel.

Dans la partie minecraft, il est possible de changer la version de Forge. Cela vous évitera de re-télécharger le MDK à chaque fois. Il faudra refaire une installation (voir ci-dessous) après changement de cette valeur.
Vous pouvez aussi y changer les mappings. Les mappings sont des listes de correspondance qui associent les func_xxxx, field_xxxx et par_xxxx incompréhensibles à des noms anglais compréhensibles.
Si vous êtes en 1.8.9 utilisez la version 22 :

   mappings = "stable_22"

Pour la 1.9.4, la version 26 :

   mappings = "stable_26"

Pour la 1.10.2, la version 29 :

   mappings = "stable_29"

Pour la 1.11.2, la version 32

   mappings = "stable_32"

Pour la 1.11.2 je vous conseilles d’utiliser les mappings les plus récentes possible :

   mappings = "snapshot_20180611"

le format de la date est <année><mois><jour>.
La liste des mappings est disponible ici : http://export.mcpbot.bspk.rs/
Une nouvelle snapshot est généré chaque jour à 3h.

Il faut refaire une installation à chaque changement de version des mappings, pour cette raison je vous conseille de les mettre à jour en même temps que Forge pour faire d’une pierre deux coups (inutile de les mettre à jour chaque jour).

Pour information les mappings se trouvent dans le dossier <dossier de votre session>\.gradle\caches\minecraft\de\oceanlabs\mcp\mcp_snapshot\<version des mappings>. Ce sont les fichiers fields.csv, methods.csv et params.csv.
(le dossier de votre session est C:\Users\<nom de la session>\ sous Windows, /home/<nom de la session> sous Linux /Users/<nom de la session>/ sous OS X).

Installation du MDK

Windows :

Avec l’explorateur de fichier ouvrez le dossier de Forge. Appuyez sur la touche shift de votre clavier et en même temps faites un clic droit dans le dossier. Dans le menu déroulant il devrait y avoir une option en plus nommée “ouvrir une fenêtre de commande ici”, cliquez dessus. L’invite de commande de Windows va s’ouvrir.
Entrez la commande suivante :

.\gradlew setupDecompWorkspace

Une fois terminé lancez la commande suivante pour préparer l’espace de travail pour Eclipse :

.\gradlew eclipse

L’installation est maintenant terminée.

Linux et MacOS :

Ouvrez un terminal et tapez "cd " (avec l’espace) puis glissez dans le terminal le dossier de Forge. Le chemin complet de ce dernier devrait s’ajouter, cliquez maintenant sur entrée. (sous certaines distributions Linux il suffit de faire un clic droit dans le dossier et une option nommée “ouvrir un terminal ici” permet d’ouvrir le terminal directement dans le dossier).
Entrez la commande suivante :

./gradlew setupDecompWorkspace

Une fois terminé lancez la commande suivante pour préparer l’espace de travail pour Eclipse :

./gradlew eclipse

L’installation est maintenant terminée.

Configuration de l’espace de travail

Lancez Eclipse et choisissez comme espace de travail le dossier eclipse qui se trouve dans le dossier de Forge.
Une fois Eclipse lancé, cliquez sur “Window” puis “Preferences”.
Déroulez le menu “General” ainsi que le menu “Editors”. Cliquez sur “Text Editors” (sans le dérouler) et cochez la case “Show line numbers”. Comme son nom l’indique cela va afficher les numéros de ligne dans l’éditeur, ce qui peut-être très utile pour les rapports de crash (la ligne qui cause problème y sera indiquée).
Cliquez sur “Workspace” (à nouveau sans dérouler le menu). Dans “Text file encoding” cochez “other” et choisissez “UTF-8”. C’est très important sinon vous allez avoir des problèmes avec les accents ou autres caractères non alpha-numérique (UTF-8 est déjà utilisé par défaut sous Linux).

Dans le menu “Java” -> “Code style” -> “Formatter” il est possible de créer son propre formateur de code si vous n’aimez pas celui de d’Eclipse. Pour formater votre code il suffit d’appuyer sur ctrl + shift + f, c’est très important afin d’avoir un code lisible. Si vous voulez utiliser le même formateur que moi, il est disponible ici (il suffit l’extraire puis l’importer dans Eclipse).
Cliquez sur “OK” pour fermer la page.

Dernier réglage plutôt utile : utilisez votre compte Minecraft directement dans Eclipse. Par défaut lorsque vous allez lancer le jeu vous allez avoir un pseudo aléatoire du type player+un nombre et vous allez être en mode offline.
Cliquez sur la flèche qui pointe vers le bas à droite de la flèche vers qui sert à lancer le programme et sélectionnez “Run Configurations…”. Sélectionnez le premier “client” à gauche (si pas déjà sélectionné par défaut) et cliquez sur l’onglet “Arguments”.
Dans la case “Program arguments:” ajoutez :

--username votre_adresse_mail --password votre_mot_de_passe

La classe GradleStart de forge va automatiquement vous identifier et vous aurez donc votre pseudo et votre compte premium (donc possibilité de se connecter aux serveurs premium et vous aurez votre skin).
Vous pouvez également mettre seulement --username unPseudo pour changer le pseudo sans utiliser votre compte premium (mais du-coup impossible de se connecter aux serveurs premium et pas de skin).

En vidéo

https://www.youtube.com/watch?v=qcm9z6Ewsik

Crédits

Rédaction :

Correction :

cc
Ce tutoriel de Minecraft Forge France est mis à disposition selon les termes de la licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International

retourRetour vers le sommaire des tutoriels