BuildCraft

Добро пожаловать в BuildCraft на GitHub

Сообщить о проблеме

Пожалуйста, открывайте проблему для отчета об ошибке, только если:

• вы уверены, что ошибка вызвана BuildCraft, а не каким-либо другим модом,
• у вас есть хотя бы одно из следующего:
  • отчет о сбое,
  • средства воспроизведения рассматриваемой ошибки,
  • скриншоты/видео/и т.д. чтобы продемонстрировать ошибку.

Если вы не уверены, что отчет об ошибке действителен, воспользуйтесь кнопкой «Спросить помощи!». подфорум.

Пожалуйста, используйте только официальные версии BuildCraft для любых отчетов об ошибках, если иное не указано командой BuildCraft. Пользовательские сборки (например, от Jenkins) не поддерживаются, часто содержат ошибки и не получают никакой поддержки со стороны разработчиков.

Пожалуйста, проверьте, не сообщалось ли об ошибке заранее. Также укажите используемую версию BuildCraft — если это версия, скомпилированная из исходного кода, укажите ссылку на коммит/дерево, из которого вы выполнили компиляцию.

Пожалуйста, укажите, используете ли вы MCPC+, Cauldron, OptiFine, FastCraft или любые другие моды, которые оптимизируют или иным образом серьезно изменяют работу движка Minecraft. Это очень полезно при попытке воспроизвести ошибку.

Пожалуйста, не открывайте вопросы по функциям, если вы не являетесь членом команды BuildCraft. Для этого используйте подфорум «Запросы функций».

BuildCraft, будучи проектом с открытым исходным кодом, дает вам право отправить запрос на включение, если для вас важно определенное исправление или функция. Однако, если рассматриваемое изменение существенное, пожалуйста, свяжитесь с командой заранее — мы хотим предотвратить напрасную трату усилий.

Содействие

Если вы хотите отправить запрос на включение для исправления ошибок или некорректного поведения, сделайте это. Если вы хотите добавить функции или изменить существующее поведение или баланс, обсудите это в Discord, прежде чем отправлять заявку (https://discord.gg/v4geqgA).

Не отправляйте запросы на включение, которые исключительно «исправляют» форматирование. Поскольку такого рода изменения обычно очень навязчивы в истории коммитов и у каждого есть собственное представление о том, что такое «правильное форматирование», их должен делать один из основных участников. Пожалуйста, отправляйте «очистку кода» только в том случае, если изменения действительно существенно влияют на читабельность.

Полезен PR, реализующий новые функции или изменяющий большие части кода. Но если вы вносите такое изменение и оно будет принято, пожалуйста, не делайте «выстрелил и забыл». Сложные изменения приводят к появлению ошибок, и какими бы тщательными ни были тестирование и экспертная оценка, ошибки будут. Пожалуйста, продолжайте воспроизведение изменений после первоначальной фиксации и исправьте оставшиеся проблемы. Другим крайне неприятно тратить дни на исправление регрессий, возникших из-за несопровождаемых материалов.

Часто сообщается

• java.lang.AbstractMethodError, java.lang.NoSuchMethodException
  • Мод не обновлен до текущего API BuildCraft.
  • Вы используете не ту версию BuildCraft, которая соответствует вашим версиям Forge/Minecraft.
  • Вы используете версию для разработчиков в обычном экземпляре игры (или наоборот).
• Проблема с рендерингом (Quarry вызывает мерцание) — сначала попробуйте без OptiFine! Это известная проблема некоторых версий OptiFine.

Компиляция и упаковка BuildCraft

1. Убедитесь, что Java (здесь) и Git (здесь) правильно установлены в вашей системе.

• Необязательно: установите Gradle (можно найти здесь). Вероятно, вы захотите установить версию 4.3.1.

2. Создайте базовый каталог для сборки
3. Клонируйте репозиторий BuildCraft в baseDir/BuildCraft/.
4. Клонируйте (и обновляйте) подмодули в «baseDir/BuildCraft» с помощью «git submodule init» и «git submodule update».
5. Перейдите к Basedir/BuildCraft в оболочке и выполните одну из двух команд:
   • ./gradlew setupCIWorkspace build , чтобы просто создать текущий jar (это может занять некоторое время).
   • ./gradlew setupDecompWorkspace для настройки полной среды разработки.
   • При установленном Gradle : используйте gradle вместо ./gradlew
   • В Windows: используйте gradlew.bat вместо ./gradlew
6. Компилированные и запутанные jar-файлы модулей будут находиться в «baseDir/BuildCraft/build/libs/<номер сборки>/modules».

Перед запуском gradle ваша структура каталогов должна выглядеть так:

---

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

---

И вот так после запуска gradle:

---

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

---

Локализации

Локализации можно отправить здесь. Заявки на локализацию этого репозитория придется отклонить.

В зависимости от BuildCraft

Инструкцию по зависимости от БК 7.1.х можно найти здесь (для 1.7.10).

Версия 8.0.x еще не закончена, поэтому инструкций по зависимости от нее нет :(

Следующие инструкции относятся к BC 7.99.12 (1.12.2):

Добавьте следующее в файл build.gradle:

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

Если вы хотите зависеть ТОЛЬКО от API, сделайте следующее:

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

Если вы хотите зависеть ТОЛЬКО от библиотеки, сделайте следующее:

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

Если вы хотите зависеть от всего buildcraft, сделайте следующее:

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

Где 7.99.12 — желаемая версия BuildCraft.