BuildCraft

Bienvenue sur BuildCraft sur GitHub

Signaler un problème

Veuillez ouvrir un ticket pour un rapport de bug uniquement si :

• vous êtes sûr que le bug est causé par BuildCraft et non par un autre mod,
• vous disposez d'au moins un des éléments suivants :
  • un rapport d'accident,
  • des moyens de reproduire le bug en question,
  • captures d'écran/vidéos/etc. pour démontrer le bug.

Si vous n'êtes pas sûr de la validité d'un rapport de bug, veuillez utiliser la fonction « Demander de l'aide ! » sous-forum.

Veuillez utiliser uniquement les versions officielles de BuildCraft pour tout type de rapport de bug, sauf indication contraire de la part de l'équipe BuildCraft. Les versions personnalisées (par exemple de Jenkins) ne sont pas prises en charge, sont souvent boguées et ne bénéficieront d'aucune assistance de la part des développeurs.

Veuillez vérifier si le bug a été signalé au préalable. Fournissez également la version de BuildCraft utilisée - s'il s'agit d'une version compilée à partir des sources, créez un lien vers le commit/l'arbre à partir duquel vous vous êtes conformé.

Veuillez mentionner si vous utilisez MCPC+, Cauldron, OptiFine, FastCraft ou tout autre mod qui optimise ou modifie gravement le fonctionnement du moteur Minecraft. C'est très utile lorsque l'on essaie de reproduire un bug.

Veuillez ne pas ouvrir de problèmes pour les fonctionnalités, sauf si vous êtes membre de l'équipe BuildCraft. Pour cela, utilisez le sous-forum "Demandes de fonctionnalités".

BuildCraft, étant un projet open source, vous donne le droit de soumettre une pull request si un correctif ou une fonctionnalité particulière est important pour vous. Toutefois, si le changement en question est majeur, veuillez contacter l'équipe au préalable - nous souhaitons éviter des efforts inutiles.

Contribuer

Si vous souhaitez soumettre une pull request pour corriger des bugs ou un comportement défectueux, n'hésitez pas à le faire. Si vous souhaitez ajouter des fonctionnalités ou modifier le comportement ou l'équilibre existant, veuillez en discuter sur Discord avant de soumettre un PR (https://discord.gg/v4geqgA).

Ne soumettez pas de demandes d'extraction qui "corrigent" uniquement le formatage. Comme ces types de changements sont généralement très intrusifs dans l'historique des commits et que chacun a sa propre idée de ce qu'est un "formatage approprié", ils devraient être effectués par l'un des principaux contributeurs. Veuillez soumettre le "nettoyage du code" uniquement si les modifications ont réellement un impact substantiel sur la lisibilité.

Les relations publiques implémentant de nouvelles fonctionnalités ou modifiant de grandes parties du code sont utiles. Mais si vous faites un tel changement et s'il est accepté, ne « tirez pas et oubliez ». Des changements complexes introduisent des bugs, et aussi approfondis que puissent être les tests et l'examen par les pairs, il y aura des bugs. Veuillez continuer à lire vos modifications après la validation initiale et résoudre les problèmes résiduels. Il est extrêmement frustrant pour d’autres de passer des journées entières à corriger les régressions introduites par des soumissions non maintenues.

Fréquemment signalé

• java.lang.AbstractMethodError, java.lang.NoSuchMethodException
  • Un mod n'a pas été mis à jour vers l'API BuildCraft actuelle
  • Vous n'utilisez pas la bonne version de BuildCraft pour vos versions Forge/Minecraft
  • Vous utilisez la version dev sur une instance de jeu normale (ou vice versa)
• Problème de rendu (Quarry provoque un scintillement) - Essayez d'abord sans OptiFine ! Il s'agit d'un problème connu avec certaines versions d'OptiFine.

Compilation et packaging de BuildCraft

1. Assurez-vous que Java (trouvé ici), Git (trouvé ici) sont correctement installés sur votre système.

• Facultatif : installez Gradle (trouvé ici). Vous souhaitez probablement installer la version 4.3.1.

2. Créer un répertoire de base pour la build
3. Clonez le référentiel BuildCraft dans 'baseDir/BuildCraft/'
4. Clonez (et mettez à jour) les sous-modules dans 'baseDir/BuildCraft avec 'git submodule init' et 'git submodule update'
5. Accédez à basedir/BuildCraft dans un shell et exécutez l'une des deux commandes :
   • ./gradlew setupCIWorkspace build pour simplement créer un fichier jar actuel (cela peut prendre un certain temps).
   • ./gradlew setupDecompWorkspace pour configurer un environnement de développement complet.
   • Avec Gradle installé : utilisez gradle au lieu de ./gradlew
   • Sous Windows : utilisez gradlew.bat au lieu de ./gradlew
6. Les compilations et les fichiers jar des modules obscurcis seront dans 'baseDir/BuildCraft/build/libs/<build number>/modules'

Votre structure de répertoires devrait ressembler à ceci avant d'exécuter gradle :

---

 baseDir
- BuildCraft
 |- buildcraft_resources
 |- common
 |- ...
 - BuildCraftAPI
  |- api
  |- ...
 - BuildCraft-Localization
  |- lang
  |- ...

---

Et comme ceci après avoir exécuté Gradle :

---

 basedir
- BuildCraft
 |- .gradle
 |- build
 |- buildcraft_resources
 |- common
 |- ...
 - BuildCraftAPI
  |- api
  |- ...
 - BuildCraft-Localization
  |- lang
  |- ...

---

Localisations

Les localisations peuvent être soumises ici. Les PR de localisation concernant ce référentiel devront être rejetés.

Selon BuildCraft

Les instructions pour dépendre de BC 7.1.x peuvent être trouvées ici (pour 1.7.10).

8.0.x n'est pas encore terminé, il n'y a donc aucune instruction pour en dépendre :(

Les instructions suivantes concernent BC 7.99.12 (1.12.2) :

Ajoutez ce qui suit à votre fichier build.gradle :

 repositories {
    maven {
        name "BuildCraft"
        url = "https://mod-buildcraft.com/maven"
    }
}

Si vous souhaitez dépendre JUSTE de l'API, procédez comme suit :

 dependencies {
    deobfCompile "com.mod-buildcraft:buildcraft-api:7.99.12"
}

Si vous voulez dépendre JUSTE de la bibliothèque, procédez comme suit :

 dependencies {
    deobfCompile "com.mod-buildcraft:buildcraft-lib:7.99.12"
}

Si vous voulez dépendre de l'ensemble de buildcraft, procédez comme suit :

 dependencies {
    deobfCompile "com.mod-buildcraft:buildcraft:7.99.12"
}

Où 7.99.12 est la version souhaitée de BuildCraft.