BuildCraft

Bem-vindo ao BuildCraft no GitHub

Relatando um problema

Abra um problema para um relatório de bug apenas se:

• você tem certeza de que o bug é causado pelo BuildCraft e não por qualquer outro mod,
• você tem pelo menos um dos seguintes:
  • um relatório de acidente,
  • meio de reproduzir o bug em questão,
  • capturas de tela/vídeos/etc. para demonstrar o bug.

Se você não tiver certeza se um relatório de bug é válido, use a opção "Peça ajuda!" subfórum.

Por favor, use apenas versões oficiais do BuildCraft para qualquer tipo de relatório de bug, a menos que seja instruído de outra forma pela equipe do BuildCraft. Compilações personalizadas (por exemplo, do Jenkins) não são suportadas, geralmente apresentam erros e não recebem nenhum suporte dos desenvolvedores.

Por favor, verifique se o bug foi relatado com antecedência. Além disso, forneça a versão do BuildCraft usada - se for uma versão compilada a partir do código-fonte, link para o commit/árvore da qual você cumpriu.

Mencione se você está usando MCPC+, Cauldron, OptiFine, FastCraft ou qualquer outro mod que otimize ou modifique severamente o funcionamento do mecanismo do Minecraft. Isso é muito útil ao tentar reproduzir um bug.

Não abra problemas para recursos, a menos que você seja membro da equipe BuildCraft. Para isso, utilize o subfórum "Solicitações de Recursos".

BuildCraft, sendo um projeto de código aberto, dá a você o direito de enviar uma solicitação pull se uma correção ou recurso específico for importante para você. No entanto, se a mudança em questão for importante, entre em contato com a equipe com antecedência - desejamos evitar desperdício de esforço.

Contribuindo

Se você deseja enviar uma solicitação pull para corrigir bugs ou comportamento corrompido, sinta-se à vontade para fazê-lo. Se você quiser adicionar recursos ou alterar o comportamento ou equilíbrio existente, discuta isso no discord antes de enviar um PR (https://discord.gg/v4geqgA).

Não envie solicitações pull que apenas "corrigem" a formatação. Como esses tipos de alterações geralmente são muito intrusivos no histórico de commits e cada um tem sua própria ideia do que é "formatação adequada", elas devem ser feitas por um dos contribuidores principais. Envie apenas "limpeza de código" se as alterações realmente tiverem um impacto substancial na legibilidade.

A implementação de novos recursos ou a alteração de grandes porções de código são úteis. Mas se você estiver fazendo essa mudança e ela for aceita, por favor, não "dispare e esqueça". Mudanças complexas estão introduzindo bugs e, por mais completos que sejam os testes e a revisão por pares, haverá bugs. Continue reproduzindo suas alterações após o commit inicial e corrija os problemas residuais. É extremamente frustrante para outros passarem dias corrigindo regressões introduzidas por submissões não mantidas.

Relatado com frequência

• java.lang.AbstractMethodError, java.lang.NoSuchMethodException
  • Um mod não foi atualizado para a API BuildCraft atual
  • Você não está usando a versão correta do BuildCraft para suas versões do Forge/Minecraft
  • Você está usando a versão dev em uma instância normal do jogo (ou vice-versa)
• Problema de renderização (Quarry causa oscilação) - Experimente primeiro sem OptiFine! Este é um problema conhecido em algumas versões do OptiFine.

Compilando e empacotando BuildCraft

1. Certifique-se de que Java (encontrado aqui) Git (encontrado aqui) estejam instalados corretamente em seu sistema.

• Opcional: Instale Gradle (encontrado aqui). Você provavelmente deseja instalar a versão 4.3.1.

2. Crie um diretório base para a compilação
3. Clone o repositório BuildCraft em 'baseDir/BuildCraft/'
4. Clone (e atualize) os submódulos em 'baseDir/BuildCraft com 'git submodule init' e 'git submodule update'
5. Navegue até basedir/BuildCraft em um shell e execute um dos dois comandos:
   • ./gradlew setupCIWorkspace build para apenas construir um jar atual (isso pode demorar um pouco).
   • ./gradlew setupDecompWorkspace para configurar um ambiente de desenvolvimento completo.
   • Com Gradle instalado: use gradle em vez de ./gradlew
   • No Windows: use gradlew.bat em vez de ./gradlew
6. As compilações e os jars do módulo ofuscado estarão em 'baseDir/BuildCraft/build/libs/<build number>/modules'

Sua estrutura de diretórios deve ficar assim antes de executar o gradle:

---

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

---

E assim depois de executar o Gradle:

---

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

---

Localizações

As localizações podem ser enviadas aqui. Os PRs de localização neste repositório deverão ser rejeitados.

Dependendo do BuildCraft

Instruções para depender do BC 7.1.x podem ser encontradas aqui (para 1.7.10).

8.0.x ainda não foi concluído, então não há instruções para depender dele :(

As instruções a seguir são para BC 7.99.12 (1.12.2):

Adicione o seguinte ao seu arquivo build.gradle:

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

Se você quiser depender APENAS da API, faça o seguinte:

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

Se você quiser depender APENAS da lib, faça o seguinte:

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

Se você quiser depender de todo o buildcraft, faça o seguinte:

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

Onde 7.99.12 é a versão desejada do BuildCraft.