Introduction

Nous savons que beaucoup de gens ont du mal à compiler leurs propres plugins, fichiers JAR logiciels, etc. Ce guide est censé être un tout-en-un pour expliquer comment compiler le code source des plugins/logiciels serveur que vous trouvez sur Github et autres. Commençons!

Comprendre ce dont vous avez besoin pour compiler le logiciel/plugin

Si le plugin a un pom.xml dans son dossier racine, alors vous devez compiler le plugin en utilisant maven. Si le plugin a un gradlew.build dans son dossier racine, alors vous devez compiler le plugin en utilisant gradlew.
Si le plugin est conçu pour les anciennes versions de minecraft, il peut avoir besoin d'une ancienne version de Java pour être compilé. Voir ce guide pour savoir comment changer la version de Java utilisée par votre PC
Si une version d'un plugin n'existe pas et si le plugin n'a pas non plus de version, il est très probable que la construction du plugin à partir de la source ne fonctionnera pas sans bricolage.
Certains projets nécessiteront que des personnes exécutent ./gradlew shadowJar, certains projets nécessiteront que des personnes exécutent mvn build, certains projets peuvent même ne pas avoir de fichier pom.xml ou gradle.build. Ce n'est donc pas une solution tout-en-un, vous devriez toujours lire comment compiler le plugin à partir du readme des auteurs

🐘 Compilation d'un plugin Gradle 🐘

Les logiciels serveur sont généralement compilés avec gradle. Tout d'abord, trouvez le logiciel/plugin que vous souhaitez compiler. Dans ce cas, nous compilerons un plugin de liste blanche - https://github.com/funniray/ScottyBotWhitelistSponge

Ouvrez l'invite de commande et accédez au dossier avec la commande "cd". Par exemple, si le dossier se trouve dans Downloads --> Plugin, cd Downloads/Plugin . En cas d'erreur, pour revenir en arrière d'un répertoire, faites cd .. .

Assurez-vous que le dossier dans lequel vous vous trouvez contient tous les fichiers du projet (tels que le dossier src, le fichier readme, etc.).

Une fois dans le dossier, exécutez la commande gradlew build pour créer les dépendances nécessaires à la compilation du plugin. (ceci est généralement fait une fois, mais il est conseillé de le faire à chaque fois que vous compilez un nouveau JAR).
Une fois terminé, vous devriez voir CONSTRUIRE AVEC SUCCÈS. Si vous rencontrez des erreurs au cours de ce processus, lisez l'erreur et contactez les auteurs à propos de l'erreur pour savoir quoi faire. Pour la majorité, l'erreur serait une version Java invalide.
Après cela, double-cliquez simplement sur le fichier gradlew.bat dans le dossier pour commencer à compiler le jar ! Selon votre ordinateur, cela peut prendre un certain temps. Le résultat JAR serait normalement présent dans build --> libs , bien que l'auteur du plugin puisse changer où il est censé être.

Important - 99 % des plugins disponibles auront un guide sur la façon de compiler le plugin. Assurez-vous de suivre les étapes et de compiler en conséquence.

Félicitations! Vous savez maintenant comment compiler un plugin sur Gradle.

🍫 Utilisation de chocolatey pour un plugin sur maven 🍫

Le moyen le plus simple de compiler des fichiers JAR à partir de maven est via chocolatey. Il s'agit d'un logiciel externe qui agit comme un gestionnaire de paquets. Pour commencer, téléchargez chocolatey depuis https://chocolatey.org/install . Assurez-vous de suivre leurs étapes en fonction de vos besoins pour vous assurer que Chocolatey est correctement configuré.

Dans la plupart des cas, en exécutant la commande Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager] ::SecurityProtocol = [System.Net.ServicePointManager] ::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) dans Powershell fonctionnera. Confirmez que chocolatey est installé en tapant simplement "choco" dans powershell.

Maintenant, nous devons installer maven ainsi que git afin de télécharger des plugins depuis github et de compiler à l'aide de maven. Cela se fait simplement en faisant choco install git et choco install maven .

Assurez-vous que vous utilisez PowerShell en tant qu'administrateur pour installer chocolatey, maven et git

Une fois cela fait, nous ouvrirons l'invite de commande et procéderons au clonage d'un référentiel git du plugin que nous voulons installer. Dans notre cas, nous utiliserons GeyserMC comme plugin pour les tests - https://github.com/GeyserMC/Geyser . Clonez le dépôt avec git clone <your_repo_url> . Dans ce cas, ce sera git clone https://github.com/GeyserMC/Geyser



Si vous ne souhaitez pas télécharger les fichiers via git clone/ils ne sont pas disponibles sur github, téléchargez simplement le zip et extrayez les fichiers dans un dossier

Entrez dans le répertoire qui a été créé pour le plugin (dans notre cas, c'est Geyser ) en utilisant cd . Une fois que vous êtes dans le répertoire cible, exécutez git submodule update --init --recursive pour mettre à jour tout ce qui est nécessaire pour que le plugin se compile correctement. Continuez puis exécutez mvn clean install. Selon votre ordinateur, cela peut prendre un certain temps.

Une fois compilé, vous trouverez le fichier jar dans votre dossier -> cible, bien que l'auteur du plugin puisse changer l'endroit où il est censé se trouver.

Félicitations! Vous savez maintenant comment compiler un plugin sur Maven.

🐘 Compilation d'un plugin avec Gradle 🐘

Vous suivrez les mêmes instructions que le guide Windows gradle mentionné ci-dessus pour compiler un plugin sur MacOS avec gradle, juste quelques ajustements ! Lors de l'exécution de gradlew build, mettez un ./, So ./gradlew build.
Après cela, exécutez simplement ./gradlew pour compiler le JAR

🦅 Compilation d'un plugin avec Maven 🦅

Au lieu d'utiliser du chocolat comme mentionné dans le guide Windows, nous utiliserons l'installation de nos logiciels requis à l'aide de brew. Exécutez la commande brew install maven et brew install git pour installer vos logiciels requis. Ensuite, continuez à suivre le guide windows pour compiler sur maven !



Vous ne devriez pas lire cette partie du guide pour être honnête, car il n'est pas recommandé de faire tout cela sur mobile, mais pour couvrir toutes les bases, expliquons également comment compiler les JAR sur un téléphone

Android est le seul système d'exploitation de téléphone compatible qui vous permettra de le faire. Termux sera l'application que nous utiliserons.

🦅 Compilation d'un plugin avec Maven 🦅

Nous voulons nous assurer que nous pouvons accéder aux fichiers que nous recevons sur nos téléphones. Exécutez termux-storage-setup , acceptez toutes les invites et entrez le stockage de votre téléphone dans ~/storage. Vous trouverez vos dossiers comme les téléchargements, les images, etc. Qui correspondent aux dossiers de fichiers de votre téléphone.

Commencez par installer les packages requis de git, maven et java avec pkg install openjdk-default-jdk maven git .

Pour résoudre les problèmes de référentiel, essayez la commande 'termux-change-repo' pour choisir les référentiels d'une autre source miroir. De plus, mettez à jour et mettez à niveau vos packages avec apt update && apt upgrade -y

Continuez puis suivez les étapes spécifiées dans le guide Windows Maven ci-dessus pour compiler un plugin. Vous pouvez rencontrer des erreurs insolubles ici, il est donc généralement conseillé de compiler un JAR sur un PC.

Conclusion

Et c'est ainsi que vous compilez les plugins et les logiciels serveur ! J'espère que ce guide vous aidera dans ce dont vous avez besoin pour compiler vos plugins préférés.

Mis à jour le : 30/07/2022