Pchom Pchom
5 mai 2018, 18:04

Sommaire

Introduction

Vous avez toujours rêvé de faire un mod pour votre petit(e) ami(e) en affichant un joli cœur en plein milieu de l’écran sur un fond noir transparent ? Que c’est mignon !
Eh bien aujourd’hui, je vais vous apprendre à le faire !

Pré-requis

Code

TutorialGui :

Créez une classe héritant de GuiScreen (net.minecraft.client.gui.GuiScreen), la mienne se nommera TutorialGui.
Il y a trois méthodes de GuiScreen à connaitre : initGui(), drawScreen(int mouseX, int mouseY, float partialTicks) et updateScreen().

La première est appelée lors de l’initialisation de la GUI, ce qui est assez évident. Nous ne l’utiliserons pas dans ce tutoriel car nous n’en aurons pas besoin, mais ne l’oubliez pas.
La seconde est appelée à chaque frame, c’est dans celle-ci que vous mettrez tout ce qui doit être affiché à l’écran. Nous en aurons besoin dans ce tutoriel.
La dernière est appelée à chaque tick. Nous n’en aurons pas besoin.

Nous allons donc nous intéresser à la méthode drawScreen, c’est dans celle-ci que nous allons afficher notre image.
Il est important de bien comprendre les trois arguments pour pouvoir utiliser au mieux la méthode.

  • mouseX est la position de la souris sur l’axe horizontal.
  • mouseY est la position de la souris sur l’axe vertical.
  • partialTicks vous permet de savoir à quel moment du tick vous êtes. Comme vous devez le savoir, il y a 20 ticks par seconde, mais le jeu peut tourner à 60, 120, 1000 fps, ce qui fait que la méthode drawScreen sera peut-être appelée plusieurs fois par tick. Pour avoir une animation fluide, il faut donc savoir à quel moment du tick actuel on est, et partialTicks nous donne cette information.

On va faire quatre appels dans cette méthode.
Le premier va être drawDefaultBackground() qui va, comme son nom l’indique, afficher le fond par défaut (un gris foncé transparent). Si vous voulez afficher une couleur différente, vous devrez utiliser this.drawGradientRect(0, 0, this.width, this.height, int startColor, int endColor); en mettant des nombres au format 0xAARRGGBB où AA est la valeur alpha, RR la valeur rouge, GG la valeur verte et BB la valeur bleue.

Vous allez ensuite devoir créer un ResourceLocation(String domaine, String chemin). Par exemple, avoir comme domaine minecraft et comme chemin textures/items/diamond_pickaxe.png ira chercher dans le dossier resources/assets/minecraft/textures/items/diamond_pickaxe.png. Vous devez ensuite bind cette texture à l’aide de la méthode bindTexture(ResourceLocation) que vous pourrez appeler grâce à la méthode getTextureManager() de Minecraft (GuiScreen possède un attribut mc par défaut).

Vous devez enfin appeler drawModalRectWithCustomSizedTexture(int x, int y, float u, float v, int width, int height, float textureWidth, float textureHeight) pour afficher votre image sur votre GUI.

  • x, y sont les coordonnées en x et en y sur l’écran de la texture que vous souhaitez afficher.
  • u, v sont les coordonnées de x et en y sur la texture.
  • width et height sont les dimensions de la partie de la texture qui sera affichée.
  • textureWidth et textureHeight sont les dimensions de la texture.

Pour vous aider à comprendre, voici une explication graphique :

Attention, si width est supérieur à textureWidth ou que height est supérieur à textureHeight, la texture sera répétée !

Pour terminer, n’oubliez pas l’appel à super.drawScreen(mouseX, mouseY, partialTicks) !
Nous en avons terminé avec notre GUI !

Le Keybind :

Dans la méthode qui gère l’appui sur la touche que vous voulez attribuer à votre GUI, vous devrez simplement l’afficher. Pour ce faire, vous devez en créer une nouvelle (avec new) et la passer à la méthode getDisplayScreen() de Minecraft.

Résultat

Si vous vous êtes bien débrouillé, vous aurez un résultat similaire :

Crédits

Rédaction :

  • Pchom

Correction :

  • DiabolicaTrix

Autres remerciements :

  • Merci à BrokenSwing pour son aide sur la compréhension de certains arguments :x
  • Merci à robin4002 pour ses corrections ^^


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

Retour vers le sommaire des tutoriels