Doc pass

Remove full-name invocations
Transform mail boxes through Postea's custom data API
2026-11-14 09:04:42 +00:00 · 2026-10-12 15:32:44 -05:00 · 2026-10-12 15:23:44 -05:00 · 2026-10-12 15:23:44 -05:00 · 2026-10-03 12:46:01 -05:00 · 2026-09-15 21:06:15 +02:00
1502 changed files with 19375 additions and 19018 deletions
@@ -0,0 +1,2 @@
+# Ignore spotlessApply reformat
+94aa9346b1811eff7e67820b75d5098e3f83448d
@@ -1,37 +1,44 @@
 * text eol=lf

-*.jar      binary
+*.[jJ][aA][rR]          binary

-*.png      binary
-*.jpg      binary
-*.jpeg     binary
-*.gif      binary
-*.tif      binary
-*.tiff     binary
-*.ico      binary
-*.svg      text
-*.eps      binary
+*.[pP][nN][gG]          binary
+*.[jJ][pP][gG]          binary
+*.[jJ][pP][eE][gG]      binary
+*.[gG][iI][fF]          binary
+*.[tT][iI][fF]          binary
+*.[tT][iI][fF][fF]      binary
+*.[iI][cC][oO]          binary
+*.[sS][vV][gG]          text
+*.[eE][pP][sS]          binary
+*.[xX][cC][fF]          binary

-*.kar      binary
-*.m4a      binary
-*.mid      binary
-*.midi     binary
-*.mp3      binary
-*.ogg      binary
-*.ra       binary
+*.[kK][aA][rR]          binary
+*.[mM]4[aA]             binary
+*.[mM][iI][dD]          binary
+*.[mM][iI][dD][iI]      binary
+*.[mM][pP]3             binary
+*.[oO][gG][gG]          binary
+*.[rR][aA]              binary

-*.7z       binary
-*.gz       binary
-*.tar      binary
-*.tgz      binary
-*.zip      binary
+*.7[zZ]                 binary
+*.[gG][zZ]              binary
+*.[tT][aA][rR]          binary
+*.[tT][gG][zZ]          binary
+*.[zZ][iI][pP]          binary

-*.patch    -text
+*.[tT][cC][nN]          binary
+*.[sS][oO]              binary
+*.[dD][lL][lL]          binary
+*.[dD][yY][lL][iI][bB]  binary
+*.[pP][sS][dD]          binary
+*.[tT][tT][fF]          binary
+*.[oO][tT][fF]          binary

-*.bat      text eol=crlf
-*.cmd      text eol=crlf
-*.ps1      text eol=crlf
+*.[pP][aA][tT][cC][hH]  -text

-*autogenerated binary
+*.[bB][aA][tT]          text eol=crlf
+*.[cC][mM][dD]          text eol=crlf
+*.[pP][sS]1             text eol=crlf

-*.tcn binary
+*[aA][uU][tT][oO][gG][eE][nN][eE][rR][aA][tT][eE][dD]* binary
@@ -1,33 +0,0 @@
-#!/usr/bin/env bash
-
-RUNDIR="run"
-CRASH="crash-reports"
-SERVERLOG="server.log"
-
-if [[ -d $RUNDIR/$CRASH ]]; then
-  echo "Crash reports detected:"
-  cat $RUNDIR/$CRASH/crash*.txt
-  exit 1
-fi
-
-if grep --quiet "Fatal errors were detected" $SERVERLOG; then
-  echo "Fatal errors detected:"
-  cat server.log
-  exit 1
-fi
-
-if grep --quiet "The state engine was in incorrect state ERRORED and forced into state SERVER_STOPPED" $SERVERLOG; then
-  echo "Server force stopped:"
-  cat server.log
-  exit 1
-fi
-
-if ! grep --quiet -Po '.+Done \(.+\)\! For help, type "help" or "\?"' $SERVERLOG; then
-  echo "Server didn't finish startup:"
-  cat server.log
-  exit 1
-fi
-
-echo "No crash reports detected"
-exit 0
-
@@ -0,0 +1,17 @@
+name: Optimize images
+
+on:
+  pull_request:
+    branches: [ master, main, release/** ]
+    paths:
+      - "**/*.png"
+
+  push:
+    branches: [ master, main, release/** ]
+    paths:
+      - "**/*.png"
+
+jobs:
+  optimize-images:
+    uses: GTNewHorizons/GTNH-Actions-Workflows/.github/workflows/optimize-images.yml@master
+    secrets: inherit
@@ -30,3 +30,4 @@ src/main/resources/mixins.*.json
 *.bat
 *.DS_Store
 !gradlew.bat
+layout.json
@@ -1,29 +0,0 @@
-How to submit a bug report to Forestry
-====================================
-Please make sure the bug has not already been reported by [searching the issues](https://github.com/ForestryMC/ForestryMC/issues?q=is%3Aissue).
-
-If you can, see if the bug still happens with the latest unstable build.  
-[The latest unstable builds are available here](http://jenkins.ic2.player.to/job/Forestry_Dev/)
-
-For crashes, you must post a link to the full crash report.  
-[gist.github.com](gist.github.com) or [pastebin.com](www.pastebin.com) are good places to upload them.  
-Full crash reports are located in [the minecraft data folder](http://hopper.minecraft.net/help/finding-minecraft-data-folder/), in "crash-reports".
-
-Thank you for reporting bugs!
-
-How to contribute to Forestry
-====================================
-
-### Contributor License Agreement
-
-Before pull requests can be accepted, the contributor needs to sign a contributor license agreement. (Essentially giving a license for using his code and/or media and for re-licensing it, for details read the agreement linked below.) 
-
-### How do I sign?
-
-To keep the hassle for everyone involved to a minimum, Forestry uses CLAHub to manage the agreements. To get started, <a href="https://www.clahub.com/agreements/ForestryMC/ForestryMC">sign the Contributor License Agreement</a>.
-
-### Why is this needed?
-
-Without CLAs it at some point becomes essentially impossible to change the license of a project which accepts contributions from third parties. Without an explicit agreement every contributor would still own the copyright to his code. So as long as it (or parts of it) remain in the code base, he would have to agree to every license change. If enough time has passed, there may be dozens, perhaps even hundreds of contributors involved and it will be very hard to track down each and every one of them and get them to agree on a new license.
-
-This would make it impossible to change the license to a more permissive one at a later date, so the code would be locked into CC BY-NC-ND 3.0 until it passes into the public domain about a hundred years from now. This situation is to be avoided and that’s why you are being bothered with this CLA.
@@ -3,17 +3,9 @@ Forestry

 ### What is it?

+This is the GTNH fork of Forestry for 1.7.10.  Do not report any issues to the original Forestry team.  This fork is maintained by the GTNH team and is not supported by the original Forestry team.
 Forestry is a modification for the game Minecraft and known primarily for its farms and bees. 

-### Homepage
-
-[Wiki](http://forestry.sengir.net/)
-
-[Latest Builds for 1.7.10](http://jenkins.ic2.player.to/job/Forestry_Dev/)
-
-[IRC #forestry on esper.net](http://webchat.esper.net/?nick=ForestryGithub...&channels=forestry&prompt=1)
-
-For those interested in developement, you can also visit #forestry-dev.

 ### Building

@@ -31,8 +23,6 @@ Beware of ugly code.

 Bugfixes are generally welcome. If you want to contribute something which changes game mechanics, please talk to someone with commit privileges first. Nothing is more frustrating than putting a lot of work and effort into a new game mechanic and then having the PR rejected because it doesn’t fit gameplay-wise.

-**If you submit a PR you must accept the [Contributor License Agreement](https://cla-assistant.io/ForestryMC/ForestryMC). There is no way around that, since otherwise changing the license later - even to something more permissive! - , becomes close to impossible.**
-
 ### License & Copyright

-Forestry is (c) 2011 - 2014 SirSengir and licensed under LGPL v3. See the LICENSE.txt for all the gory details or go to http://www.gnu.org/licenses/lgpl-3.0.txt for more information. Forestry also contains code contributed by CovertJaguar, Player, MysteriousAges, Binnie, RichardG, cpw and others.
+Forestry is (c) 2011 - 2014 SirSengir and licensed under LGPL v3. See the LICENSE.txt for all the gory details or go to http://www.gnu.org/licenses/lgpl-3.0.txt for more information. Forestry also contains code contributed by CovertJaguar, Player, MysteriousAges, Binnie, RichardG, cpw, the GTNH Team, and others.
@@ -1,12 +1,14 @@
 // Add your dependencies here

 dependencies {
-    compile('com.github.GTNewHorizons:NotEnoughItems:2.2.7-GTNH:dev')
-    compile('com.github.GTNewHorizons:inventory-tweaks:1.5.14:api')
-    compile('com.github.GTNewHorizons:BuildCraft:7.1.27:api')
-    compile('net.industrial-craft:industrialcraft-2:2.2.828-experimental:dev')
-
-    compile('curse.maven:cofh-lib-220333:2388748')
-
+    api("com.github.GTNewHorizons:GTNHLib:0.9.54:dev")
+    api('curse.maven:cofh-lib-220333:2388748')
+    compileOnlyApi('com.github.GTNewHorizons:Angelica:2.1.19:api')
+    devOnlyNonPublishable('com.github.GTNewHorizons:NotEnoughItems:2.8.107-GTNH:dev')
+    compileOnly('com.github.GTNewHorizons:inventory-tweaks:1.7.1:api')
+    compileOnly('com.github.GTNewHorizons:BuildCraft:7.1.57:api')
+    compileOnly('net.industrial-craft:industrialcraft-2:2.2.828-experimental:dev')
    compileOnly('curse.maven:craftguide-75557:2459320')
+    compileOnly('com.github.GTNewHorizons:Postea:1.4.0-mu:dev')
+    devOnlyNonPublishable('net.xonich.mc:NoHotbarNeeded:0.0.3:dev')
 }
@@ -1,60 +1,238 @@
+# ExampleMod tag to use as Blowdryer (Spotless, etc.) settings version, leave empty to disable.
+# LOCAL to test local config updates.
+gtnh.settings.blowdryerTag = 0.2.0
+
+# Human-readable mod name, available for mcmod.info population.
 modName = Forestry

-# This is a case-sensitive string to identify your mod. Convention is to use lower case.
+# Case-sensitive identifier string, available for mcmod.info population and used for automatic mixin JSON generation.
+# Conventionally lowercase.
 modId = Forestry

+# Root package of the mod, used to find various classes in other properties,
+# mcmod.info substitution, enabling assertions in run tasks, etc.
 modGroup = forestry

-# WHY is there no version field?
-# The build script relies on git to provide a version via tags. It is super easy and will enable you to always know the
-# code base or your binary. Check out this tutorial: https://blog.mattclemente.com/2017/10/13/versioning-with-git-tags/
+# Whether to use modGroup as the maven publishing group.
+# When false, com.github.GTNewHorizons is used.
+useModGroupForPublishing = false

-# Will update your build.gradle automatically whenever an update is available
+# Updates your build.gradle and settings.gradle automatically whenever an update is available.
 autoUpdateBuildScript = false

+# Version of Minecraft to target
 minecraftVersion = 1.7.10
+
+# Version of Minecraft Forge to target
 forgeVersion = 10.13.4.1614

-# Select a username for testing your mod with breakpoints. You may leave this empty for a random username each time you
-# restart Minecraft in development. Choose this dependent on your mod:
-# Do you need consistent player progressing (for example Thaumcraft)? -> Select a name
-# Do you need to test how your custom blocks interacts with a player that is not the owner? -> leave name empty
+# Specify an MCP channel for dependency deobfuscation and the deobfParams task.
+channel = stable
+
+# Specify an MCP mappings version for dependency deobfuscation and the deobfParams task.
+mappingsVersion = 12
+
+# Defines other MCP mappings for dependency deobfuscation.
+remoteMappings = https\://raw.githubusercontent.com/MinecraftForge/FML/1.7.10/conf/
+
+# Select a default username for testing your mod. You can always override this per-run by running
+# `./gradlew runClient --username=AnotherPlayer`, or configuring this command in your IDE.
 developmentEnvironmentUserName = Developer

-# Define a source file of your project with:
+# Enables modern Java syntax support. Valid values:
+# - false: No modern syntax, Java 8 only
+# - jabel: Jabel syntax-only support, compiles to J8 bytecode
+# - jvmDowngrader: Full modern Java via JVM Downgrader (syntax + stdlib APIs)
+# - modern: Native modern Java bytecode, no downgrading
+enableModernJavaSyntax = jabel
+
+# If set, ignores the above setting and compiles with the given toolchain. This may cause unexpected issues,
+# and should *not* be used in most situations. -1 disables this.
+# forceToolchainVersion = -1
+
+# Target JVM version for JVM Downgrader bytecode downgrading.
+# Only used when enableModernJavaSyntax = jvmDowngrader
+# downgradeTargetVersion = 8
+
+# Comma-separated list of Java versions for multi-release jar support (JVM Downgrader only).
+# Classes will be available in META-INF/versions/N/ for each version N in this list.
+# Default: "21,25" (J25+ gets native classes, J21-24 gets partial downgrade, J8-20 gets full downgrade).
+# jvmDowngraderMultiReleaseVersions = 21,25
+
+# Specifies how JVM Downgrader API stubs are provided. Options:
+# - shade: Shade minimized stubs into the jar
+# - gtnhlib: GTNHLib provides stubs at runtime (adds version constraint)
+# - external: Another dependency provides stubs (no constraint, no warning)
+# - (empty): Warning reminding you to configure stubs
+# Note: 'shade' option requires you to verify license compliance, see: https://github.com/unimined/JvmDowngrader/blob/main/LICENSE.md
+# jvmDowngraderStubsProvider =
+
+# Enables injecting missing generics into the decompiled source code for a better coding experience.
+# Turns most publicly visible List, Map, etc. into proper List<E>, Map<K, V> types.
+enableGenericInjection = true
+
+# Generate a class with a String field for the mod version named as defined below.
+# If generateGradleTokenClass is empty or not missing, no such class will be generated.
+# If gradleTokenVersion is empty or missing, the field will not be present in the class.
+generateGradleTokenClass = forestry.Tags
+
+# Name of the token containing the project's current version to generate/replace.
+gradleTokenVersion = VERSION
+
+# [DEPRECATED] Mod ID replacement token.
+gradleTokenModId =
+
+# [DEPRECATED] Mod name replacement token.
+gradleTokenModName =
+
+# [DEPRECATED] Mod Group replacement token.
+gradleTokenGroupName =
+
+# [DEPRECATED]
+# Multiple source files can be defined here by providing a comma-separated list: Class1.java,Class2.java,Class3.java
 # public static final String VERSION = "GRADLETOKEN_VERSION";
 # The string's content will be replaced with your mod's version when compiled. You should use this to specify your mod's
-# version in @Mod([...], version = VERSION, [...])
-# Leave these properties empty to skip individual token replacements
-replaceGradleTokenInFile = Constants.java
-gradleTokenModId =
-gradleTokenModName =
-gradleTokenVersion = GRADLETOKEN_VERSION
-gradleTokenGroupName =
+# version in @Mod([...], version = VERSION, [...]).
+# Leave these properties empty to skip individual token replacements.
+replaceGradleTokenInFile =

 # In case your mod provides an API for other mods to implement you may declare its package here. Otherwise, you can
 # leave this property empty.
-# Example value: apiPackage = api + modGroup = com.myname.mymodid -> com.myname.mymodid.api
+# Example value: (apiPackage = api) + (modGroup = com.myname.mymodid) -> com.myname.mymodid.api
 apiPackage = api

 # Specify the configuration file for Forge's access transformers here. It must be placed into /src/main/resources/META-INF/
-# Example value: mymodid_at.cfg
-accessTransformersFile =
+# There can be multiple files in a space-separated list.
+# Example value: mymodid_at.cfg nei_at.cfg
+accessTransformersFile = forestry_at.cfg

 # Provides setup for Mixins if enabled. If you don't know what mixins are: Keep it disabled!
 usesMixins = false
+
+# Set to a non-empty string to configure mixins in a separate source set under src/VALUE, instead of src/main.
+# This can speed up compile times thanks to not running the mixin annotation processor on all input sources.
+# Mixin classes will have access to "main" classes, but not the other way around.
+separateMixinSourceSet =
+
+# Adds some debug arguments like verbose output and class export.
+usesMixinDebug = false
+
 # Specify the location of your implementation of IMixinConfigPlugin. Leave it empty otherwise.
 mixinPlugin =
-# Specify the package that contains all of your Mixins. You may only place Mixins in this package or the build will fail!
+
+# Specify the package that contains all of your Mixins. The package must exist or
+# the build will fail. If you have a package property defined in your mixins.<modid>.json,
+# it must match with this or the build will fail.
 mixinsPackage =
+
 # Specify the core mod entry class if you use a core mod. This class must implement IFMLLoadingPlugin!
 # This parameter is for legacy compatibility only
-# Example value: coreModClass = asm.FMLPlugin + modGroup = com.myname.mymodid -> com.myname.mymodid.asm.FMLPlugin
+# Example value: (coreModClass = asm.FMLPlugin) + (modGroup = com.myname.mymodid) -> com.myname.mymodid.asm.FMLPlugin
 coreModClass =
+
 # If your project is only a consolidation of mixins or a core mod and does NOT contain a 'normal' mod ( = some class
 # that is annotated with @Mod) you want this to be true. When in doubt: leave it on false!
 containsMixinsAndOrCoreModOnly = false

-# If enabled, you may use 'shadowImplementation' for dependencies. They will be integrated in your jar. It is your
-# responsibility check the licence and request permission for distribution, if required.
+# Enables Mixins even if this mod doesn't use them, useful if one of the dependencies uses mixins.
+forceEnableMixins = false
+
+# If enabled, you may use 'shadowCompile' for dependencies. They will be integrated into your jar. It is your
+# responsibility to check the license and request permission for distribution if required.
 usesShadowedDependencies = false
+
+# If disabled, won't remove unused classes from shadowed dependencies. Some libraries use reflection to access
+# their own classes, making the minimization unreliable.
+minimizeShadowedDependencies = true
+
+# If disabled, won't rename the shadowed classes.
+relocateShadowedDependencies = true
+
+# Adds CurseMaven, Modrinth, and some more well-known 1.7.10 repositories.
+includeWellKnownRepositories = true
+
+# A list of repositories to exclude from the includeWellKnownRepositories setting. Should be a space separated
+# list of strings, with the acceptable keys being(case does not matter):
+# cursemaven
+# modrinth
+excludeWellKnownRepositories =
+
+# Change these to your Maven coordinates if you want to publish to a custom Maven repository instead of the default GTNH Maven.
+# Authenticate with the MAVEN_USER and MAVEN_PASSWORD environment variables.
+# If you need a more complex setup disable maven publishing here and add a publishing repository to addon.gradle.
+usesMavenPublishing = true
+
+# Maven repository to publish the mod to.
+# mavenPublishUrl = https\://nexus.gtnewhorizons.com/repository/releases/
+
+# Publishing to Modrinth requires you to set the MODRINTH_TOKEN environment variable to your current Modrinth API token.
+#
+# The project's ID on Modrinth. Can be either the slug or the ID.
+# Leave this empty if you don't want to publish to Modrinth.
+modrinthProjectId =
+
+# The project's relations on Modrinth. You can use this to refer to other projects on Modrinth.
+# Syntax: scope1-type1:name1;scope2-type2:name2;...
+# Where scope can be one of [required, optional, incompatible, embedded],
+#       type can be one of [project, version],
+#       and the name is the Modrinth project or version slug/id of the other mod.
+# Example: required-project:fplib;optional-project:gasstation;incompatible-project:gregtech
+# Note: UniMixins is automatically set as a required dependency if usesMixins = true.
+modrinthRelations =
+
+# Publishing to CurseForge requires you to set the CURSEFORGE_TOKEN environment variable to one of your CurseForge API tokens.
+#
+# The project's numeric ID on CurseForge. You can find this in the About Project box.
+# Leave this empty if you don't want to publish on CurseForge.
+curseForgeProjectId =
+
+# The project's relations on CurseForge. You can use this to refer to other projects on CurseForge.
+# Syntax: type1:name1;type2:name2;...
+# Where type can be one of [requiredDependency, embeddedLibrary, optionalDependency, tool, incompatible],
+#       and the name is the CurseForge project slug of the other mod.
+# Example: requiredDependency:railcraft;embeddedLibrary:cofhlib;incompatible:buildcraft
+# Note: UniMixins is automatically set as a required dependency if usesMixins = true.
+curseForgeRelations =
+
+# Optional parameter to customize the produced artifacts. Use this to preserve artifact naming when migrating older
+# projects. New projects should not use this parameter.
+# customArchiveBaseName =
+
+# Optional parameter to customize the default working directory used by the runClient* tasks. Relative to the project directory.
+# runClientWorkingDirectory = run/client
+
+# Optional parameter to customize the default working directory used by the runServer* tasks. Relative to the project directory.
+# runServerWorkingDirectory = run/server
+
+# Optional parameter to have the build automatically fail if an illegal version is used.
+# This can be useful if you e.g. only want to allow versions in the form of '1.1.xxx'.
+# The check is ONLY performed if the version is a git tag.
+# Note: the specified string must be escaped, so e.g. 1\\.1\\.\\d+ instead of 1\.1\.\d+
+# versionPattern =
+
+# Uncomment to prevent the source code from being published.
+# noPublishedSources = true
+
+# Uncomment this to disable Spotless checks.
+# This should only be uncommented to keep it easier to sync with upstream/other forks.
+# That is, if there is no other active fork/upstream, NEVER change this.
+# disableSpotless = true
+
+# Uncomment this to disable Checkstyle checks (currently wildcard import check).
+# disableCheckstyle = true
+
+# Override the IDEA build type. Valid values are: "" (leave blank, do not override), "idea" (force use native IDEA build), "gradle"
+# (force use delegated build).
+# This is meant to be set in $HOME/.gradle/gradle.properties.
+# e.g. add "systemProp.org.gradle.project.ideaOverrideBuildType=idea" will override the build type to be native build.
+# WARNING: If you do use this option, it will overwrite whatever you have in your existing projects. This might not be what you want!
+# Usually there is no need to uncomment this here as other developers do not necessarily use the same build type as you.
+# ideaOverrideBuildType = idea
+
+# Whether IDEA should run spotless checks when pressing the Build button.
+# This is meant to be set in $HOME/.gradle/gradle.properties.
+# ideaCheckSpotlessOnBuild = true
+
+# Non-GTNH properties
+org.gradle.configuration-cache = true
+org.gradle.parallel = true
@@ -0,0 +1,12 @@
+#This file is generated by updateDaemonJvm
+toolchainUrl.FREE_BSD.AARCH64=https\://api.foojay.io/disco/v3.0/ids/1630f7ebef05444cb27a2709ea0249b3/redirect
+toolchainUrl.FREE_BSD.X86_64=https\://api.foojay.io/disco/v3.0/ids/fa1e318c287360478e3c83a9a3ef1007/redirect
+toolchainUrl.LINUX.AARCH64=https\://api.foojay.io/disco/v3.0/ids/1630f7ebef05444cb27a2709ea0249b3/redirect
+toolchainUrl.LINUX.X86_64=https\://api.foojay.io/disco/v3.0/ids/fa1e318c287360478e3c83a9a3ef1007/redirect
+toolchainUrl.MAC_OS.AARCH64=https\://api.foojay.io/disco/v3.0/ids/c2dd35c9d0aaf0ba6ad0791320f99dfc/redirect
+toolchainUrl.MAC_OS.X86_64=https\://api.foojay.io/disco/v3.0/ids/e5810bd7fd1f8a586644409d395a7e55/redirect
+toolchainUrl.UNIX.AARCH64=https\://api.foojay.io/disco/v3.0/ids/1630f7ebef05444cb27a2709ea0249b3/redirect
+toolchainUrl.UNIX.X86_64=https\://api.foojay.io/disco/v3.0/ids/fa1e318c287360478e3c83a9a3ef1007/redirect
+toolchainUrl.WINDOWS.AARCH64=https\://api.foojay.io/disco/v3.0/ids/7b3c4877c0749019e6805bb61e421497/redirect
+toolchainUrl.WINDOWS.X86_64=https\://api.foojay.io/disco/v3.0/ids/8e1d9ee5d0f13e442218f6884a306da1/redirect
+toolchainVersion=25
@@ -1,5 +1,7 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.9.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.4.0-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
@@ -1,7 +1,7 @@
-#!/usr/bin/env sh
+#!/bin/sh

 #
-# Copyright 2015 the original author or authors.
+# Copyright © 2015 the original authors.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,80 +15,114 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+# SPDX-License-Identifier: Apache-2.0
+#

 ##############################################################################
-##
-##  Gradle start up script for UN*X
-##
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/b631911858264c0b6e4d6603d677ff5218766cee/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
 ##############################################################################

 # Attempt to set APP_HOME
+
 # Resolve links: $0 may be a link
-PRG="$0"
-# Need this for relative symlinks.
-while [ -h "$PRG" ] ; do
-    ls=`ls -ld "$PRG"`
-    link=`expr "$ls" : '.*-> \(.*\)$'`
-    if expr "$link" : '/.*' > /dev/null; then
-        PRG="$link"
-    else
-        PRG=`dirname "$PRG"`"/$link"
-    fi
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
 done
-SAVED="`pwd`"
-cd "`dirname \"$PRG\"`/" >/dev/null
-APP_HOME="`pwd -P`"
-cd "$SAVED" >/dev/null

-APP_NAME="Gradle"
-APP_BASE_NAME=`basename "$0"`
-
-# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit

 # Use the maximum available, or set MAX_FD != -1 to use that value.
-MAX_FD="maximum"
+MAX_FD=maximum

 warn () {
    echo "$*"
-}
+} >&2

 die () {
    echo
    echo "$*"
    echo
    exit 1
-}
+} >&2

 # OS specific support (must be 'true' or 'false').
 cygwin=false
 msys=false
 darwin=false
 nonstop=false
-case "`uname`" in
-  CYGWIN* )
-    cygwin=true
-    ;;
-  Darwin* )
-    darwin=true
-    ;;
-  MINGW* )
-    msys=true
-    ;;
-  NONSTOP* )
-    nonstop=true
-    ;;
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
 esac

-CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+

 # Determine the Java command to use to start the JVM.
 if [ -n "$JAVA_HOME" ] ; then
    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
        # IBM's JDK on AIX uses strange locations for the executables
-        JAVACMD="$JAVA_HOME/jre/sh/java"
+        JAVACMD=$JAVA_HOME/jre/sh/java
    else
-        JAVACMD="$JAVA_HOME/bin/java"
+        JAVACMD=$JAVA_HOME/bin/java
    fi
    if [ ! -x "$JAVACMD" ] ; then
        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
@@ -97,92 +131,118 @@ Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
    fi
 else
-    JAVACMD="java"
-    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.

 Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
+    fi
 fi

 # Increase the maximum file descriptors if we can.
-if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
-    MAX_FD_LIMIT=`ulimit -H -n`
-    if [ $? -eq 0 ] ; then
-        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
-            MAX_FD="$MAX_FD_LIMIT"
-        fi
-        ulimit -n $MAX_FD
-        if [ $? -ne 0 ] ; then
-            warn "Could not set maximum file descriptor limit: $MAX_FD"
-        fi
-    else
-        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
-    fi
-fi
-
-# For Darwin, add options to specify how the application appears in the dock
-if $darwin; then
-    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
-fi
-
-# For Cygwin or MSYS, switch paths to Windows format before running java
-if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
-    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
-    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
-    JAVACMD=`cygpath --unix "$JAVACMD"`
-
-    # We build the pattern for arguments to be converted via cygpath
-    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
-    SEP=""
-    for dir in $ROOTDIRSRAW ; do
-        ROOTDIRS="$ROOTDIRS$SEP$dir"
-        SEP="|"
-    done
-    OURCYGPATTERN="(^($ROOTDIRS))"
-    # Add a user-defined pattern to the cygpath arguments
-    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
-        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
-    fi
-    # Now convert the arguments - kludge to limit ourselves to /bin/sh
-    i=0
-    for arg in "$@" ; do
-        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
-        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
-
-        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
-            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
-        else
-            eval `echo args$i`="\"$arg\""
-        fi
-        i=$((i+1))
-    done
-    case $i in
-        (0) set -- ;;
-        (1) set -- "$args0" ;;
-        (2) set -- "$args0" "$args1" ;;
-        (3) set -- "$args0" "$args1" "$args2" ;;
-        (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
-        (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
-        (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
-        (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
-        (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
-        (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
    esac
 fi

-# Escape application args
-save () {
-    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
-    echo " "
-}
-APP_ARGS=$(save "$@")
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.

-# Collect all arguments for the java command, following the shell quoting and substitution rules
-eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )

-# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
-if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
-  cd "$(dirname "$0")"
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
 fi

+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
 exec "$JAVACMD" "$@"
@@ -13,8 +13,10 @@
@rem See the License for the specific language governing permissions and
@rem limitations under the License.
@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem

-@if "%DEBUG%" == "" @echo off
+@if "%DEBUG%"=="" @echo off
@rem ##########################################################################
@rem
@rem  Gradle startup script for Windows
@@ -25,10 +27,14 @@
 if "%OS%"=="Windows_NT" setlocal

 set DIRNAME=%~dp0
-if "%DIRNAME%" == "" set DIRNAME=.
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
 set APP_BASE_NAME=%~n0
 set APP_HOME=%DIRNAME%

+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
 set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"

@@ -37,13 +43,13 @@ if defined JAVA_HOME goto findJavaFromJavaHome

 set JAVA_EXE=java.exe
 %JAVA_EXE% -version >NUL 2>&1
-if "%ERRORLEVEL%" == "0" goto init
+if %ERRORLEVEL% equ 0 goto execute

-echo.
-echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2

 goto fail

@@ -51,48 +57,35 @@ goto fail
 set JAVA_HOME=%JAVA_HOME:"=%
 set JAVA_EXE=%JAVA_HOME%/bin/java.exe

-if exist "%JAVA_EXE%" goto init
+if exist "%JAVA_EXE%" goto execute

-echo.
-echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2

 goto fail

-:init
-@rem Get command-line arguments, handling Windows variants
-
-if not "%OS%" == "Windows_NT" goto win9xME_args
-
-:win9xME_args
-@rem Slurp the command line arguments.
-set CMD_LINE_ARGS=
-set _SKIP=2
-
-:win9xME_args_slurp
-if "x%~1" == "x" goto execute
-
-set CMD_LINE_ARGS=%*
-
 :execute
@rem Setup the command line

-set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+

@rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*

 :end
@rem End local scope for the variables with windows NT shell
-if "%ERRORLEVEL%"=="0" goto mainEnd
+if %ERRORLEVEL% equ 0 goto mainEnd

 :fail
 rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
 rem the _cmd.exe /c_ return code!
-if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
-exit /b 1
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%

 :mainEnd
 if "%OS%"=="Windows_NT" endlocal
@@ -1,26 +1,5 @@
 // Add any additional repositiroes for your dependencies here

 repositories {
-    maven {
-        name 'GTNH Maven'
-        url 'http://jenkins.usrv.eu:8081/nexus/content/groups/public/'
-        allowInsecureProtocol
-    }
-    maven {
-        name 'ic2'
-        url 'http://maven.ic2.player.to/'
-        metadataSources {
-            mavenPom()
-            artifact()
-        }
-    }
-    maven {
-        url 'https://cursemaven.com'
-        content {
-            includeGroup 'curse.maven'
-        }
-    }
-    maven {
-        url 'https://jitpack.io'
-    }
+    mavenLocal()
 }
@@ -1,10 +1,23 @@
+
+pluginManagement {
+    repositories {
+        maven {
+            // RetroFuturaGradle
+            name "GTNH Maven"
+            url "https://nexus.gtnewhorizons.com/repository/public/"
+            mavenContent {
+                includeGroup("com.gtnewhorizons")
+                includeGroupByRegex("com\\.gtnewhorizons\\..+")
+            }
+        }
+        gradlePluginPortal()
+        mavenCentral()
+        mavenLocal()
+    }
+}
+
 plugins {
-    id 'com.diffplug.blowdryerSetup' version '1.6.0'
+    id 'com.gtnewhorizons.gtnhsettingsconvention' version '2.0.24'
 }

-apply plugin: 'com.diffplug.blowdryerSetup'

-blowdryerSetup {
-    github('GTNewHorizons/ExampleMod1.7.10', 'tag', '0.1.5')
-    //devLocal '.' // Use this when testing config updates locally
-}
@@ -1,16 +1,21 @@
 /*******************************************************************************
- * Copyright (c) 2011-2014 SirSengir.
- * All rights reserved. This program and the accompanying materials
- * are made available under the terms of the GNU Lesser Public License v3
- * which accompanies this distribution, and is available at
- * http://www.gnu.org/licenses/lgpl-3.0.txt
+ * Copyright (c) 2011-2014 SirSengir. All rights reserved. This program and the accompanying materials are made
+ * available under the terms of the GNU Lesser Public License v3 which accompanies this distribution, and is available
+ * at http://www.gnu.org/licenses/lgpl-3.0.txt
 *
- * Various Contributors including, but not limited to:
- * SirSengir (original work), CovertJaguar, Player, Binnie, MysteriousAges
+ * Various Contributors including, but not limited to: SirSengir (original work), CovertJaguar, Player, Binnie,
+ * MysteriousAges
 ******************************************************************************/
 package forestry;

+import java.io.File;
+
+import net.minecraft.block.Block;
+import net.minecraft.item.Item;
+import net.minecraftforge.common.MinecraftForge;
+
 import cpw.mods.fml.common.FMLCommonHandler;
+import cpw.mods.fml.common.Loader;
 import cpw.mods.fml.common.Mod;
 import cpw.mods.fml.common.Mod.EventHandler;
 import cpw.mods.fml.common.ModAPIManager;
@@ -41,10 +46,6 @@ import forestry.core.utils.Log;
 import forestry.core.utils.StringUtil;
 import forestry.core.worldgen.WorldGenerator;
 import forestry.plugins.PluginManager;
-import java.io.File;
-import net.minecraft.block.Block;
-import net.minecraft.item.Item;
-import net.minecraftforge.common.MinecraftForge;

 /**
 * Forestry Minecraft Mod
@@ -56,7 +57,7 @@ import net.minecraftforge.common.MinecraftForge;
        name = Constants.MOD,
        version = Constants.VERSION,
        guiFactory = "forestry.core.config.ForestryGuiConfigFactory",
-        dependencies = "required-after:Forge@[10.13.4.1566,);"
+        dependencies = "required-after:Forge@[10.13.4.1566,);" + "required-after:gtnhlib@[0.9.41,);"
                + "after:Buildcraft|Core@[6.1.7,);"
                + "after:ExtrabiomesXL;"
                + "after:BiomesOPlenty;"
@@ -80,11 +81,15 @@ public class Forestry {

    public static PacketHandler packetHandler;

+    public static boolean isDreamcraftLoaded;
+
    @EventHandler
    public void preInit(FMLPreInitializationEvent event) {
        checkForCoFHLib();
        packetHandler = new PacketHandler();

+        isDreamcraftLoaded = Loader.isModLoaded("dreamcraft");
+
        // Register event handler
        EventHandlerCore eventHandlerCore = new EventHandlerCore();
        MinecraftForge.EVENT_BUS.register(eventHandlerCore);
@@ -113,6 +118,9 @@ public class Forestry {
    public void postInit(FMLPostInitializationEvent event) {
        PluginManager.runPostInit();

+        // Parse Mail Blacklist
+        Config.parseMailBlacklist();
+
        // Register world generator
        WorldGenerator worldGenerator = new WorldGenerator();
        GameRegistry.registerWorldGenerator(worldGenerator, 0);
@@ -7,6 +7,7 @@ package forestry.api.apiculture;

 import java.util.ArrayList;
 import java.util.HashMap;
+
 import net.minecraft.item.ItemStack;

 /**
@@ -8,11 +8,11 @@ package forestry.api.apiculture;
 import forestry.api.genetics.IIndividual;

 /**
- * Easily extendable default IBeeListener.
- * By itself, this IBeeListener does nothing.
- * BeeListeners should inherit from this class unless they need to listen for everything.
+ * Easily extendable default IBeeListener. By itself, this IBeeListener does nothing. BeeListeners should inherit from
+ * this class unless they need to listen for everything.
 */
 public class DefaultBeeListener implements IBeeListener {
+
    @Override
    public void wearOutEquipment(int amount) {}

@@ -6,9 +6,8 @@
 package forestry.api.apiculture;

 /**
- * Easily extendable default IBeeModifier.
- * By itself, this IBeeModifier does nothing.
- * BeeModifiers should inherit from this class unless they modify everything.
+ * Easily extendable default IBeeModifier. By itself, this IBeeModifier does nothing. BeeModifiers should inherit from
+ * this class unless they modify everything.
 */
 public class DefaultBeeModifier implements IBeeModifier {

@@ -25,7 +24,7 @@ public class DefaultBeeModifier implements IBeeModifier {
    }

    public float getProductionModifier(IBeeGenome genome, float currentModifier) {
-        return 1.0f;
+        return 0.0f;
    }

    public float getFloweringModifier(IBeeGenome genome, float currentModifier) {
@@ -44,6 +43,10 @@ public class DefaultBeeModifier implements IBeeModifier {
        return false;
    }

+    public boolean isSelfUnlighted() {
+        return false;
+    }
+
    public boolean isSunlightSimulated() {
        return false;
    }
@@ -5,6 +5,8 @@
 ******************************************************************************/
 package forestry.api.apiculture;

+import java.util.Locale;
+
 import forestry.api.genetics.IAllele;
 import forestry.api.genetics.IAlleleArea;
 import forestry.api.genetics.IAlleleBoolean;
@@ -14,7 +16,6 @@ import forestry.api.genetics.IAlleleInteger;
 import forestry.api.genetics.IAlleleTolerance;
 import forestry.api.genetics.IChromosomeType;
 import forestry.api.genetics.ISpeciesRoot;
-import java.util.Locale;

 /**
 * Enum representing the order of chromosomes in a bee's genome and what they control.
@@ -22,6 +23,7 @@ import java.util.Locale;
 * @author SirSengir
 */
 public enum EnumBeeChromosome implements IChromosomeType {
+
    /**
     * Species of the bee. Alleles here must implement {@link IAlleleBeeSpecies}.
     */
@@ -43,11 +45,13 @@ public enum EnumBeeChromosome implements IChromosomeType {
     */
    TEMPERATURE_TOLERANCE(IAlleleTolerance.class),
    /**
-     * Slightly incorrectly named. If true, a naturally dirunal bee can work during the night. If true, a naturally nocturnal bee can work during the day.
+     * Slightly incorrectly named. If true, a naturally dirunal bee can work during the night. If true, a naturally
+     * nocturnal bee can work during the day.
     */
    NOCTURNAL(IAlleleBoolean.class),
    /**
-     * Not used / superseded by fixed values for the species. Probably going to be replaced with a boolean for FIRE_RESIST.
+     * Not used / superseded by fixed values for the species. Probably going to be replaced with a boolean for
+     * FIRE_RESIST.
     */
    @Deprecated
    HUMIDITY(IAllele.class),
@@ -80,7 +84,12 @@ public enum EnumBeeChromosome implements IChromosomeType {
     */
    EFFECT(IAlleleBeeEffect.class);

-    Class<? extends IAllele> clss;
+    final Class<? extends IAllele> clss;
+
+    /**
+     * Cached values() array for frequent read-only operations, the array should NOT be mutated.
+     */
+    public static final EnumBeeChromosome[] VALUES = values();

    EnumBeeChromosome(Class<? extends IAllele> clss) {
        this.clss = clss;
@@ -5,19 +5,24 @@
 ******************************************************************************/
 package forestry.api.apiculture;

-import forestry.api.genetics.ISpeciesType;
 import java.util.Locale;

+import forestry.api.genetics.ISpeciesType;
+
 public enum EnumBeeType implements ISpeciesType {
+
    DRONE,
    PRINCESS,
    QUEEN,
    LARVAE,
    NONE;

+    /**
+     * Cached values() array for frequent read-only operations, the array should NOT be mutated.
+     */
    public static final EnumBeeType[] VALUES = values();

-    String name;
+    private final String name;

    EnumBeeType() {
        this.name = this.toString().toLowerCase(Locale.ENGLISH);
@@ -26,4 +31,8 @@ public enum EnumBeeType implements ISpeciesType {
    public String getName() {
        return name;
    }
+
+    public static EnumBeeType fromOrdinal(int ordinal) {
+        return VALUES[ordinal];
+    }
 }
@@ -5,13 +5,26 @@
 ******************************************************************************/
 package forestry.api.apiculture;

-import forestry.api.genetics.IFlowerRegistry;
 import java.util.ArrayList;
+
 import net.minecraft.item.ItemStack;

+import forestry.api.genetics.IFlowerRegistry;
+
 public class FlowerManager {
+
    /**
-     * <blockquote><pre>e.g. FlowerManager.flowerRegister.registerPlantableFlower(new ItemStack(Blocks.red_flower), 1.0, FlowerManager.FlowerTypeVanilla, FlowerManager.FlowerTypeSnow);</pre></blockquote>
+     * <blockquote>
+     * 
+     * <pre>
+     * e.g.FlowerManager.flowerRegister.registerPlantableFlower(
+     *         new ItemStack(Blocks.red_flower),
+     *         1.0,
+     *         FlowerManager.FlowerTypeVanilla,
+     *         FlowerManager.FlowerTypeSnow);
+     * </pre>
+     * 
+     * </blockquote>
     */
    public static IFlowerRegistry flowerRegistry;

@@ -26,8 +39,8 @@ public class FlowerManager {
    public static final String FlowerTypeGourd = "flowersGourd";

    /**
-     * @deprecated since Forestry 3.4. Use IFlowerRegistry.registerPlantableFlower instead.
-     * Completely unused since Forestry 4.0, kept for backward compatibility with older mods.
+     * @deprecated since Forestry 3.4. Use IFlowerRegistry.registerPlantableFlower instead. Completely unused since
+     *             Forestry 4.0, kept for backward compatibility with older mods.
     */
    @Deprecated
    public static ArrayList<ItemStack> plainFlowers = new ArrayList<ItemStack>();
@@ -4,5 +4,6 @@ import forestry.api.genetics.IEffectData;

@SuppressWarnings("unused")
 public interface IAlleleBeeAcceleratableEffect {
+
    IEffectData doEffectAccelerated(IBeeGenome genome, IEffectData storedData, IBeeHousing housing, float did);
 }
@@ -13,11 +13,9 @@ public interface IAlleleBeeEffect extends IAlleleEffect {
    /**
     * Called by apiaries to cause an effect in the world.
     *
-     * @param genome
-     *            Genome of the bee queen causing this effect
-     * @param storedData
-     *            Object containing the stored effect data for the apiary/hive the bee is in.
-     * @param housing {@link IBeeHousing} the bee currently resides in.
+     * @param genome     Genome of the bee queen causing this effect
+     * @param storedData Object containing the stored effect data for the apiary/hive the bee is in.
+     * @param housing    {@link IBeeHousing} the bee currently resides in.
     * @return storedData, may have been manipulated.
     */
    IEffectData doEffect(IBeeGenome genome, IEffectData storedData, IBeeHousing housing);
@@ -26,9 +24,8 @@ public interface IAlleleBeeEffect extends IAlleleEffect {
     * Is called to produce bee effects.
     *
     * @param genome
-     * @param storedData
-     *            Object containing the stored effect data for the apiary/hive the bee is in.
-     * @param housing {@link IBeeHousing} the bee currently resides in.
+     * @param storedData Object containing the stored effect data for the apiary/hive the bee is in.
+     * @param housing    {@link IBeeHousing} the bee currently resides in.
     * @return storedData, may have been manipulated.
     */
    IEffectData doFX(IBeeGenome genome, IEffectData storedData, IBeeHousing housing);
@@ -5,12 +5,14 @@
 ******************************************************************************/
 package forestry.api.apiculture;

+import java.util.Map;
+
+import net.minecraft.item.ItemStack;
+import net.minecraft.util.IIcon;
+
 import cpw.mods.fml.relauncher.Side;
 import cpw.mods.fml.relauncher.SideOnly;
 import forestry.api.genetics.IAlleleSpecies;
-import java.util.Map;
-import net.minecraft.item.ItemStack;
-import net.minecraft.util.IIcon;

 public interface IAlleleBeeSpecies extends IAlleleSpecies {

@@ -36,6 +38,7 @@ public interface IAlleleBeeSpecies extends IAlleleSpecies {

    /**
     * Only jubilant bees produce specialities.
+     * 
     * @return true if the bee is jubilant, false otherwise.
     */
    boolean isJubilant(IBeeGenome genome, IBeeHousing housing);
@@ -5,30 +5,36 @@
 ******************************************************************************/
 package forestry.api.apiculture;

-import forestry.api.genetics.IAlleleSpeciesCustom;
 import net.minecraft.item.ItemStack;

+import forestry.api.genetics.IAlleleSpeciesCustom;
+
 public interface IAlleleBeeSpeciesCustom extends IAlleleBeeSpecies, IAlleleSpeciesCustom {

    /**
-     * Add a product for this bee species.
-     * Chance is between 0 and 1.
+     * Add a product for this bee species. Chance is between 0 and 1.
     */
    IAlleleBeeSpeciesCustom addProduct(ItemStack product, Float chance);

    /**
-     * Add a specialty product for this bee species.
-     * Bees only produce their specialty when they are Jubilant (see IJubilanceProvider)
-     * Chance is between 0 and 1.
+     * Add a specialty product for this bee species. Bees only produce their specialty when they are Jubilant (see
+     * IJubilanceProvider) Chance is between 0 and 1.
     */
    IAlleleBeeSpeciesCustom addSpecialty(ItemStack specialty, Float chance);

    /**
-     * Set the Jubilance Provider for this bee species.
-     * Bees only produce their specialty when they are Jubilant (see IJubilanceProvider)
+     * Set the Jubilance Provider for this bee species. Bees only produce their specialty when they are Jubilant (see
+     * IJubilanceProvider)
     */
    IAlleleBeeSpeciesCustom setJubilanceProvider(IJubilanceProvider provider);

+    /**
+     * Get the Jubilance Provider for this bee species.
+     */
+    default IJubilanceProvider getJubilanceProvider() {
+        return null;
+    }
+
    /**
     * Make this species only active at night.
     */
@@ -37,6 +43,8 @@ public interface IAlleleBeeSpeciesCustom extends IAlleleBeeSpecies, IAlleleSpeci
    /** Use this if you have custom icons for bees. */
    IAlleleBeeSpeciesCustom setCustomBeeIconProvider(IBeeIconProvider beeIconProvider);

-    /** Use this if you have custom icon colours for bees (other than the default static primary + secondary colours). */
+    /**
+     * Use this if you have custom icon colours for bees (other than the default static primary + secondary colours).
+     */
    IAlleleBeeSpeciesCustom setCustomBeeIconColourProvider(IBeeIconColourProvider beeIconColourProvider);
 }
@@ -9,7 +9,8 @@ import forestry.api.genetics.IBreedingTracker;
 import forestry.api.genetics.IIndividual;

 /**
- * Can be used to garner information on bee breeding. See {@link forestry.api.genetics.ISpeciesRoot} for retrieval functions.
+ * Can be used to garner information on bee breeding. See {@link forestry.api.genetics.ISpeciesRoot} for retrieval
+ * functions.
 *
 * @author SirSengir
 */
@@ -18,8 +19,7 @@ public interface IApiaristTracker extends IBreedingTracker {
    /**
     * Register the birth of a queen. Will mark species as discovered.
     *
-     * @param queen
-     *            Created queen.
+     * @param queen Created queen.
     */
    void registerQueen(IIndividual queen);

@@ -31,8 +31,7 @@ public interface IApiaristTracker extends IBreedingTracker {
    /**
     * Register the birth of a princess. Will mark species as discovered.
     *
-     * @param princess
-     *            Created princess.
+     * @param princess Created princess.
     */
    void registerPrincess(IIndividual princess);

@@ -44,8 +43,7 @@ public interface IApiaristTracker extends IBreedingTracker {
    /**
     * Register the birth of a drone. Will mark species as discovered.
     *
-     * @param drone
-     *            Created drone.
+     * @param drone Created drone.
     */
    void registerDrone(IIndividual drone);

@@ -13,12 +13,13 @@ import net.minecraft.item.ItemStack;
 * When implemented by armor piece items, allows them to act as apiarist's armor.
 */
 public interface IArmorApiarist {
+
    /**
     * Called when the apiarist's armor acts as protection against an attack.
     *
-     * @param entity Entity being attacked
-     * @param armor Armor item
-     * @param cause  Optional cause of attack, such as a bee effect identifier
+     * @param entity    Entity being attacked
+     * @param armor     Armor item
+     * @param cause     Optional cause of attack, such as a bee effect identifier
     * @param doProtect Whether or not to actually do the side effects of protection
     * @return Whether or not the armor should protect the player from that attack
     */
@@ -27,9 +28,9 @@ public interface IArmorApiarist {
    /**
     * Called when the apiarist's armor acts as protection against an attack.
     *
-     * @param player Player being attacked
-     * @param armor Armor item
-     * @param cause Optional cause of attack, such as a bee effect identifier
+     * @param player    Player being attacked
+     * @param armor     Armor item
+     * @param cause     Optional cause of attack, such as a bee effect identifier
     * @param doProtect Whether or not to actually do the side effects of protection
     * @return Whether or not the armor should protect the player from that attack
     * @deprecated since Forestry 4.2. Use protectEntity
@@ -18,9 +18,10 @@ public interface IArmorApiaristHelper {

    /**
     * Called when the apiarist's armor acts as protection against an attack.
-     * @param stack ItemStack to check
-     * @param entity Entity being attacked
-     * @param cause Optional cause of attack, such as a bee effect identifier
+     * 
+     * @param stack     ItemStack to check
+     * @param entity    Entity being attacked
+     * @param cause     Optional cause of attack, such as a bee effect identifier
     * @param doProtect Whether or not to actually do the side effects of protection
     * @return Whether or not the item is valid Apiarist Armor and should protect the player from that attack
     * @since Forestry 4.2
@@ -29,8 +30,9 @@ public interface IArmorApiaristHelper {

    /**
     * Called when the apiarist's armor acts as protection against an attack.
-     * @param entity Entity being attacked
-     * @param cause Optional cause of attack, such as a bee effect identifier
+     * 
+     * @param entity    Entity being attacked
+     * @param cause     Optional cause of attack, such as a bee effect identifier
     * @param doProtect Whether or not to actually do the side effects of protection
     * @return The number of valid Apiarist Armor pieces the player is wearing that are actually protecting
     * @since Forestry 4.2
@@ -39,9 +41,10 @@ public interface IArmorApiaristHelper {

    /**
     * Called when the apiarist's armor acts as protection against an attack.
-     * @param stack ItemStack to check
-     * @param player Player being attacked
-     * @param cause Optional cause of attack, such as a bee effect identifier
+     * 
+     * @param stack     ItemStack to check
+     * @param player    Player being attacked
+     * @param cause     Optional cause of attack, such as a bee effect identifier
     * @param doProtect Whether or not to actually do the side effects of protection
     * @return Whether or not the item is valid Apiarist Armor and should protect the player from that attack
     * @deprecated since Forestry 4.2. use the EntityLivingBase version
@@ -51,8 +54,9 @@ public interface IArmorApiaristHelper {

    /**
     * Called when the apiarist's armor acts as protection against an attack.
-     * @param player Player being attacked
-     * @param cause Optional cause of attack, such as a bee effect identifier
+     * 
+     * @param player    Player being attacked
+     * @param cause     Optional cause of attack, such as a bee effect identifier
     * @param doProtect Whether or not to actually do the side effects of protection
     * @return The number of valid Apiarist Armor pieces the player is wearing that are actually protecting
     * @deprecated since Forestry 4.2. use the EntityLivingBase version
@@ -0,0 +1,20 @@
+package forestry.api.apiculture;
+
+import net.minecraft.entity.EntityLivingBase;
+import net.minecraft.item.ItemStack;
+
+public interface IArmorApiaristMulti extends IArmorApiarist {
+
+    /**
+     * Called to determine how many pieces an armor "counts for". For instance, if this returns 4, the single piece will
+     * act as full protection.
+     *
+     * @param entity Entity being attacked
+     * @param armor  Armor item
+     * @param cause  Optional cause of attack, such as a bee effect identifier
+     * @return Amount of effective protected slots
+     */
+    default int getProtectionCount(EntityLivingBase entity, ItemStack armor, String cause) {
+        return 1;
+    }
+}
@@ -5,14 +5,16 @@
 ******************************************************************************/
 package forestry.api.apiculture;

+import java.util.List;
+import java.util.Set;
+
+import net.minecraft.item.ItemStack;
+import net.minecraft.world.biome.BiomeGenBase;
+
 import forestry.api.core.IErrorState;
 import forestry.api.genetics.IEffectData;
 import forestry.api.genetics.IIndividual;
 import forestry.api.genetics.IIndividualLiving;
-import java.util.List;
-import java.util.Set;
-import net.minecraft.item.ItemStack;
-import net.minecraft.world.biome.BiomeGenBase;

 /**
 * Other implementations than Forestry's default one are not supported.
@@ -43,6 +45,7 @@ public interface IBee extends IIndividualLiving {

    /**
     * Set the natural flag on this bee.
+     * 
     * @param flag
     */
    void setIsNatural(boolean flag);
@@ -58,6 +61,7 @@ public interface IBee extends IIndividualLiving {

    /**
     * Determines whether the queen can work.
+     * 
     * @param housing the {@link IBeeHousing} the bee currently resides in.
     * @return an empty set if the queen can work, a set of error states if the queen can not work
     */
@@ -10,37 +10,30 @@ import forestry.api.genetics.IClassification;
 public interface IBeeFactory {

    /**
-     * Creates a new bee species.
-     * Automatically registered with AlleleManager.alleleRegistry.registerAllele()
-     * See IAlleleBeeSpeciesCustom and IAlleleSpeciesCustom for adding additional properties to the returned species.
+     * Creates a new bee species. Automatically registered with AlleleManager.alleleRegistry.registerAllele() See
+     * IAlleleBeeSpeciesCustom and IAlleleSpeciesCustom for adding additional properties to the returned species.
     *
-     * @param uid Unique Identifier for this species
-     * @param dominant Whether this species is genetically dominant (false means it is recessive)
-     * @param authority Authority for the binomial name, e.g. "Sengir" on species of base Forestry.
-     * @param unlocalizedName Unlocalized name for this species
+     * @param uid                    Unique Identifier for this species
+     * @param dominant               Whether this species is genetically dominant (false means it is recessive)
+     * @param authority              Authority for the binomial name, e.g. "Sengir" on species of base Forestry.
+     * @param unlocalizedName        Unlocalized name for this species
     * @param unlocalizedDescription Unlocalized description for this species
-     * @param branch Classification of this species
-     * @param binomial Binomial name of the species sans genus ("Apis"). "humboldti" will have the bee species flavour name be "Apis humboldti". Feel free to use fun names or null.
-     * @param primaryColor The outline color of this species
-     * @param secondaryColor The body color of this species
+     * @param branch                 Classification of this species
+     * @param binomial               Binomial name of the species sans genus ("Apis"). "humboldti" will have the bee
+     *                               species flavour name be "Apis humboldti". Feel free to use fun names or null.
+     * @param primaryColor           The outline color of this species
+     * @param secondaryColor         The body color of this species
     * @return a new bee species allele.
     */
-    IAlleleBeeSpeciesCustom createSpecies(
-            String uid,
-            boolean dominant,
-            String authority,
-            String unlocalizedName,
-            String unlocalizedDescription,
-            IClassification branch,
-            String binomial,
-            int primaryColor,
+    IAlleleBeeSpeciesCustom createSpecies(String uid, boolean dominant, String authority, String unlocalizedName,
+            String unlocalizedDescription, IClassification branch, String binomial, int primaryColor,
            int secondaryColor);

    /**
-     * Creates a new bee branch.
-     * Must be registered with AlleleManager.alleleRegistry.getClassification("family.apidae").addMemberGroup();
+     * Creates a new bee branch. Must be registered with
+     * AlleleManager.alleleRegistry.getClassification("family.apidae").addMemberGroup();
     *
-     * @param uid Unique Identifier for this branch
+     * @param uid        Unique Identifier for this branch
     * @param scientific approximates a "genus" in real life. Real life examples: "Micrapis", "Megapis"
     * @return a new bee branch
     */
@@ -5,25 +5,29 @@
 ******************************************************************************/
 package forestry.api.apiculture;

+import net.minecraft.util.Vec3;
+import net.minecraft.world.World;
+
 import com.mojang.authlib.GameProfile;
+
 import forestry.api.core.IClimateProvider;
 import forestry.api.core.IErrorLogicSource;
 import forestry.api.genetics.IHousing;
-import net.minecraft.util.Vec3;
-import net.minecraft.world.World;

 public interface IBeeHousing extends IHousing, IClimateProvider, IErrorLogicSource {

    /**
-     * Used by BeeManager.beeRoot.createBeeHousingModifier(IBeeHousing housing)
-     * to combine bee modifiers from several sources that can change over time.
+     * Used by BeeManager.beeRoot.createBeeHousingModifier(IBeeHousing housing) to combine bee modifiers from several
+     * sources that can change over time.
+     * 
     * @return IBeeModifiers from the housing, frames, etc.
     */
    Iterable<IBeeModifier> getBeeModifiers();

    /**
-     * Used by BeeManager.beeRoot.createBeeHousingListener(IBeeHousing housing)
-     * to combine bee listeners from several sources that can change over time.
+     * Used by BeeManager.beeRoot.createBeeHousingListener(IBeeHousing housing) to combine bee listeners from several
+     * sources that can change over time.
+     * 
     * @return IBeeListeners from the housing, multiblock parts, etc.
     */
    Iterable<IBeeListener> getBeeListeners();
@@ -21,7 +21,7 @@ public interface IBeeHousingInventory {
     * Adds products to the housing's inventory.
     *
     * @param product ItemStack with the product to add.
-     * @param all if true, success requires that all products are added
+     * @param all     if true, success requires that all products are added
     * @return boolean indicating success or failure.
     */
    boolean addProduct(ItemStack product, boolean all);
@@ -9,5 +9,6 @@ package forestry.api.apiculture;
 * Custom colour provider for bees with complicated colors.
 */
 public interface IBeeIconColourProvider {
+
    int getIconColour(int renderPass);
 }
@@ -9,6 +9,7 @@ import net.minecraft.client.renderer.texture.IIconRegister;
 import net.minecraft.util.IIcon;

 public interface IBeeIconProvider {
+
    void registerIcons(IIconRegister register);

    IIcon getIcon(EnumBeeType type, int renderPass);
@@ -11,6 +11,7 @@ public interface IBeeListener {

    /**
     * Called when the bees wear out the housing's equipment.
+     * 
     * @param amount Integer indicating the amount worn out.
     */
    void wearOutEquipment(int amount);
@@ -22,6 +23,7 @@ public interface IBeeListener {

    /**
     * Called when the bees have retrieved some pollen.
+     * 
     * @return true if this bee listener handled the pollen.
     */
    boolean onPollenRetrieved(IIndividual pollen);
@@ -6,30 +6,31 @@
 package forestry.api.apiculture;

 public interface IBeeModifier {
+
    /**
-     * @param genome Genome of the bee this modifier is called for.
+     * @param genome          Genome of the bee this modifier is called for.
     * @param currentModifier Current modifier.
     * @return Float used to modify the base territory.
     */
    float getTerritoryModifier(IBeeGenome genome, float currentModifier);

    /**
-     * @param genome Genome of the bee this modifier is called for.
-     * @param mate Genome of the bee mate this modifier is called for.
+     * @param genome          Genome of the bee this modifier is called for.
+     * @param mate            Genome of the bee mate this modifier is called for.
     * @param currentModifier Current modifier.
     * @return Float used to modify the base mutation chance.
     */
    float getMutationModifier(IBeeGenome genome, IBeeGenome mate, float currentModifier);

    /**
-     * @param genome Genome of the bee this modifier is called for.
+     * @param genome          Genome of the bee this modifier is called for.
     * @param currentModifier Current modifier.
     * @return Float used to modify the life span of queens.
     */
    float getLifespanModifier(IBeeGenome genome, IBeeGenome mate, float currentModifier);

    /**
-     * @param genome Genome of the bee this modifier is called for.
+     * @param genome          Genome of the bee this modifier is called for.
     * @param currentModifier Current modifier.
     * @return Float modifying the production speed of queens.
     */
@@ -53,10 +54,17 @@ public interface IBeeModifier {
    boolean isSealed();

    /**
-     * @return Boolean indicating if housing can ignore darkness/night
+     * @return Boolean indicating if housing can ignore darkness/night. Cannot be used together with SelfUnlighted
     */
    boolean isSelfLighted();

+    /**
+     * @return Boolean indicating if housing can ignore lightness/day. Cannot be used together with SelfLighted
+     */
+    default boolean isSelfUnlighted() {
+        return false;
+    }
+
    /**
     * @return Boolean indicating if housing can ignore not seeing the sky
     */
@@ -12,12 +12,9 @@ public interface IBeeMutation extends IMutation {
    IBeeRoot getRoot();

    /**
-     * @return float representing the chance for mutation to occur. note that this is 0 - 100 based, since it was an integer previously!
+     * @return float representing the chance for mutation to occur. note that this is 0 - 100 based, since it was an
+     *         integer previously!
     */
-    float getChance(
-            IBeeHousing housing,
-            IAlleleBeeSpecies allele0,
-            IAlleleBeeSpecies allele1,
-            IBeeGenome genome0,
+    float getChance(IBeeHousing housing, IAlleleBeeSpecies allele0, IAlleleBeeSpecies allele1, IBeeGenome genome0,
            IBeeGenome genome1);
 }
@@ -7,4 +7,5 @@ package forestry.api.apiculture;

 import forestry.api.genetics.IMutationCustom;

-public interface IBeeMutationCustom extends IBeeMutation, IMutationCustom {}
+public interface IBeeMutationCustom extends IBeeMutation, IMutationCustom {
+}
@@ -8,17 +8,17 @@ package forestry.api.apiculture;
 import forestry.api.genetics.IAllele;

 public interface IBeeMutationFactory {
+
    /**
-     * Creates a new bee mutation.
-     * Automatically registered with BeeManager.beeRoot.registerMutation()
-     * See IBeeMutationCustom and IMutationCustom for adding additional properties to the returned mutation.
+     * Creates a new bee mutation. Automatically registered with BeeManager.beeRoot.registerMutation() See
+     * IBeeMutationCustom and IMutationCustom for adding additional properties to the returned mutation.
     *
     * @param parentBee0 A parent bee for this mutation
     * @param parentBee1 A parent bee for this mutation
-     * @param result The resulting alleles for this mutation
-     * @param chance The chance that breeding the two parent bees will result in this mutation
+     * @param result     The resulting alleles for this mutation
+     * @param chance     The chance that breeding the two parent bees will result in this mutation
     * @return a new bee mutation.
     */
-    IBeeMutationCustom createMutation(
-            IAlleleBeeSpecies parentBee0, IAlleleBeeSpecies parentBee1, IAllele[] result, int chance);
+    IBeeMutationCustom createMutation(IAlleleBeeSpecies parentBee0, IAlleleBeeSpecies parentBee1, IAllele[] result,
+            int chance);
 }
@@ -5,15 +5,18 @@
 ******************************************************************************/
 package forestry.api.apiculture;

-import com.mojang.authlib.GameProfile;
-import forestry.api.genetics.IAllele;
-import forestry.api.genetics.ISpeciesRoot;
 import java.util.ArrayList;
 import java.util.Collection;
+
 import net.minecraft.item.ItemStack;
 import net.minecraft.nbt.NBTTagCompound;
 import net.minecraft.world.World;

+import com.mojang.authlib.GameProfile;
+
+import forestry.api.genetics.IAllele;
+import forestry.api.genetics.ISpeciesRoot;
+
 public interface IBeeRoot extends ISpeciesRoot {

    /**
@@ -69,8 +72,7 @@ public interface IBeeRoot extends ISpeciesRoot {
    boolean isMated(ItemStack stack);

    /**
-     * @param genome
-     *            Valid {@link IBeeGenome}
+     * @param genome Valid {@link IBeeGenome}
     * @return {@link IBee} from the passed genome
     */
    IBee getBee(World world, IBeeGenome genome);
@@ -78,10 +80,8 @@ public interface IBeeRoot extends ISpeciesRoot {
    /**
     * Creates an IBee suitable for a queen containing the necessary second genome for the mate.
     *
-     * @param genome
-     *            Valid {@link IBeeGenome}
-     * @param mate
-     *            Valid {@link IBee} representing the mate.
+     * @param genome Valid {@link IBeeGenome}
+     * @param mate   Valid {@link IBee} representing the mate.
     * @return Mated {@link IBee} from the passed genomes.
     */
    IBee getBee(World world, IBeeGenome genome, IBee mate);
@@ -109,20 +109,19 @@ public interface IBeeRoot extends ISpeciesRoot {

    /* MISC */
    /**
-     * Creates beekeepingLogic for a housing.
-     * Should be used when the housing is created, see IBeekeepingLogic
+     * Creates beekeepingLogic for a housing. Should be used when the housing is created, see IBeekeepingLogic
     */
    IBeekeepingLogic createBeekeepingLogic(IBeeHousing housing);

    /**
-     * Combines multiple modifiers from an IBeeHousing into one.
-     * Stays up to date with changes to the housing's modifiers.
+     * Combines multiple modifiers from an IBeeHousing into one. Stays up to date with changes to the housing's
+     * modifiers.
     */
    IBeeModifier createBeeHousingModifier(IBeeHousing housing);

    /**
-     * Combines multiple listeners from an IBeeHousing into one.
-     * Stays up to date with changes to the housing's listeners.
+     * Combines multiple listeners from an IBeeHousing into one. Stays up to date with changes to the housing's
+     * listeners.
     */
    IBeeListener createBeeHousingListener(IBeeHousing housing);
 }
@@ -5,12 +5,12 @@
 ******************************************************************************/
 package forestry.api.apiculture;

-import forestry.api.core.INBTTagable;
 import net.minecraft.entity.player.EntityPlayerMP;

+import forestry.api.core.INBTTagable;
+
 /**
- * Stores beekeeping logic for bee housings.
- * Get one with BeeManager.beeRoot.createBeekeepingLogic(IBeeHousing housing)
+ * Stores beekeeping logic for bee housings. Get one with BeeManager.beeRoot.createBeekeepingLogic(IBeeHousing housing)
 * Save and load it to NBT using the INBTTagable methods.
 */
 public interface IBeekeepingLogic extends INBTTagable {
@@ -19,6 +19,7 @@ public interface IBeekeepingLogic extends INBTTagable {

    /**
     * Checks that the bees can work, setting error conditions on the housing where needed
+     * 
     * @return true if no errors are present and doWork should be called
     */
    boolean canWork();
@@ -31,29 +32,26 @@ public interface IBeekeepingLogic extends INBTTagable {
    /* CLIENT */

    /**
-     * Call this when the housing comes into view of the client.
-     * (i.e. when tile.getDescriptionPacket() is called)
+     * Call this when the housing comes into view of the client. (i.e. when tile.getDescriptionPacket() is called)
     */
    void syncToClient();

    void syncToClient(EntityPlayerMP player);

    /**
-     * Get the progress bar for breeding and production.
-     * To avoid network spam, this is only available server-side,
-     * and must be synced manually to the client when a GUI is open.
+     * Get the progress bar for breeding and production. To avoid network spam, this is only available server-side, and
+     * must be synced manually to the client when a GUI is open.
     */
    int getBeeProgressPercent();

    /**
-     * Whether bee fx should be active.
-     * Internally, this is automatically synced to the client.
+     * Whether bee fx should be active. Internally, this is automatically synced to the client.
     */
    boolean canDoBeeFX();

    /**
-     * Display bee fx. Calls IBee.doFX(IEffectData[] storedData, IBeeHousing housing) on the queen.
-     * Internally, the queen is automatically synced to the client for the fx.
+     * Display bee fx. Calls IBee.doFX(IEffectData[] storedData, IBeeHousing housing) on the queen. Internally, the
+     * queen is automatically synced to the client for the fx.
     */
    void doBeeFX();
 }
@@ -6,6 +6,7 @@
 package forestry.api.apiculture;

 import java.util.ArrayList;
+
 import net.minecraft.world.World;

 public interface IBeekeepingMode {
@@ -49,7 +50,8 @@ public interface IBeekeepingMode {
     * @param queen
     * @param offspring
     * @param housing
-     * @return true if the genetic structure of the queen is breaking down during spawning of the offspring (with chance). will trigger a negative effect.
+     * @return true if the genetic structure of the queen is breaking down during spawning of the offspring (with
+     *         chance). will trigger a negative effect.
     */
    boolean isDegenerating(IBee queen, IBee offspring, IBeeHousing housing);

@@ -6,6 +6,7 @@
 package forestry.api.apiculture;

 import java.util.Collection;
+
 import net.minecraft.item.ItemStack;
 import net.minecraft.world.World;

@@ -28,9 +29,9 @@ public interface IHiveDrop {
     * Chance to drop. Default drops have 80 (= 80 %).
     *
     * @param world Minecraft world this is called for.
-     * @param x x-Coordinate of the broken hive.
-     * @param y y-Coordinate of the broken hive.
-     * @param z z-Coordinate of the broken hive.
+     * @param x     x-Coordinate of the broken hive.
+     * @param y     y-Coordinate of the broken hive.
+     * @param z     z-Coordinate of the broken hive.
     * @return Chance for drop as an integer of 0 - 100.
     */
    int getChance(World world, int x, int y, int z);
@@ -5,7 +5,12 @@
 ******************************************************************************/
 package forestry.api.apiculture;

+import java.util.List;
+
+import javax.annotation.Nullable;
+
 import net.minecraft.item.ItemStack;
+import net.minecraftforge.event.entity.player.ItemTooltipEvent;

 public interface IHiveFrame {

@@ -13,12 +18,24 @@ public interface IHiveFrame {
     * Wears out a frame.
     *
     * @param housing IBeeHousing the frame is contained in.
-     * @param frame ItemStack containing the actual frame.
-     * @param queen Current queen in the caller.
-     * @param wear Integer denoting the amount worn out. The wear modifier of the current beekeeping mode has already been taken into account.
+     * @param frame   ItemStack containing the actual frame.
+     * @param queen   Current queen in the caller.
+     * @param wear    Integer denoting the amount worn out. The wear modifier of the current beekeeping mode has already
+     *                been taken into account.
     * @return ItemStack containing the actual frame with adjusted damage, or null if it has been broken.
     */
    ItemStack frameUsed(IBeeHousing housing, ItemStack frame, IBee queen, int wear);

    IBeeModifier getBeeModifier();
+
+    /**
+     * Provides an override for the "Hold Shift" tooltip info for a frame.<br>
+     * Called by {@link forestry.apiculture.EventHandlerApiculture#addFrameTooltip(ItemTooltipEvent)}.
+     *
+     * @return The info to display for this frame, or null if default generated info.
+     */
+    @Nullable
+    default List<String> getFrameTooltip() {
+        return null;
+    }
 }
@@ -8,6 +8,7 @@ package forestry.api.apiculture;
 import net.minecraft.block.Block;

 public interface IJubilanceFactory {
+
    /** The default Jubilance Provider is satisfied when the humidity and temperature are ideal for the bee. */
    IJubilanceProvider getDefault();

@@ -8,8 +8,12 @@ package forestry.api.apiculture;
 public interface IJubilanceProvider {

    /**
-     * Returns true when conditions are right to make this species Jubilant.
-     * Jubilant bees can produce their Specialty products.
+     * Returns true when conditions are right to make this species Jubilant. Jubilant bees can produce their Specialty
+     * products.
     */
    boolean isJubilant(IAlleleBeeSpecies species, IBeeGenome genome, IBeeHousing housing);
+
+    default String getDescription() {
+        return null;
+    }
 }
@@ -5,12 +5,13 @@
 ******************************************************************************/
 package forestry.api.apiculture.hives;

-import forestry.api.core.EnumHumidity;
-import forestry.api.core.EnumTemperature;
 import net.minecraft.block.Block;
 import net.minecraft.world.World;
 import net.minecraft.world.biome.BiomeGenBase;

+import forestry.api.core.EnumHumidity;
+import forestry.api.core.EnumTemperature;
+
 public interface IHiveDescription {

    /**
@@ -26,8 +27,8 @@ public interface IHiveDescription {
    int getMeta();

    /**
-     * returns true if the hive can be generated in these conditions.
-     * Used as a fast early-elimination check for hives that have no hope of spawning in the area.
+     * returns true if the hive can be generated in these conditions. Used as a fast early-elimination check for hives
+     * that have no hope of spawning in the area.
     */
    boolean isGoodBiome(BiomeGenBase biome);

@@ -36,15 +37,14 @@ public interface IHiveDescription {
    boolean isGoodTemperature(EnumTemperature temperature);

    /**
-     * float representing the relative chance a hive will generate in a chunk.
-     * Default is 1.0, higher numbers result in more hives, smaller will result in fewer.
-     * Tree hives want around 3.0 to 4.0 since there are less locations to generate on.
+     * float representing the relative chance a hive will generate in a chunk. Default is 1.0, higher numbers result in
+     * more hives, smaller will result in fewer. Tree hives want around 3.0 to 4.0 since there are less locations to
+     * generate on.
     */
    float getGenChance();

    /**
-     * Called after successful hive generation.
-     * world, x, y, z give the location of the new hive.
+     * Called after successful hive generation. world, x, y, z give the location of the new hive.
     **/
    void postGen(World world, int x, int y, int z);
 }
@@ -10,14 +10,13 @@ import net.minecraft.world.World;
 public interface IHiveGen {

    /**
-     * return a Y value that the hive should try to generate at.
-     * returns negative if the hive can't be placed anywhere.
+     * return a Y value that the hive should try to generate at. returns negative if the hive can't be placed anywhere.
     */
    int getYForHive(World world, int x, int z);

    /**
-     * returns true if the hive can be generated at this location.
-     * Used for advanced conditions, like checking that the ground below the hive is a certain type.
+     * returns true if the hive can be generated at this location. Used for advanced conditions, like checking that the
+     * ground below the hive is a certain type.
     */
    boolean isValidLocation(World world, int x, int y, int z);

@@ -10,8 +10,8 @@ import net.minecraft.block.Block;
 public interface IHiveGenHelper {

    /**
-     * Returns a hiveGen for a hive that spawns on the ground.
-     * validGroundBlocks specifies which block materials it can spawn on.
+     * Returns a hiveGen for a hive that spawns on the ground. validGroundBlocks specifies which block materials it can
+     * spawn on.
     */
    IHiveGen ground(Block... validGroundBlocks);

@@ -5,9 +5,10 @@
 ******************************************************************************/
 package forestry.api.apiculture.hives;

-import forestry.api.apiculture.IHiveDrop;
 import java.util.List;

+import forestry.api.apiculture.IHiveDrop;
+
 public interface IHiveRegistry {

    /* Forestry Hive Names */
@@ -5,11 +5,13 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

-import forestry.api.genetics.AlleleManager;
-import forestry.api.genetics.IFruitFamily;
 import net.minecraft.util.StatCollector;

+import forestry.api.genetics.AlleleManager;
+import forestry.api.genetics.IFruitFamily;
+
 public enum EnumFruitFamily implements IFruitFamily {
+
    PRUNES("prunes", "Prunus domestica"),
    POMES("pomes", "Pomum"),
    JUNGLE("jungle", "Tropicus"),
@@ -8,6 +8,7 @@ package forestry.api.arboriculture;
 import forestry.api.genetics.ISpeciesType;

 public enum EnumGermlingType implements ISpeciesType {
+
    SAPLING("sapling"),
    BLOSSOM("blossom"),
    POLLEN("pollen"),
@@ -5,6 +5,10 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

+import java.util.Locale;
+
+import net.minecraftforge.common.EnumPlantType;
+
 import forestry.api.genetics.IAllele;
 import forestry.api.genetics.IAlleleArea;
 import forestry.api.genetics.IAlleleBoolean;
@@ -14,14 +18,13 @@ import forestry.api.genetics.IAllelePlantType;
 import forestry.api.genetics.IChromosomeType;
 import forestry.api.genetics.IFruitFamily;
 import forestry.api.genetics.ISpeciesRoot;
-import java.util.Locale;
-import net.minecraftforge.common.EnumPlantType;

 public enum EnumTreeChromosome implements IChromosomeType {

    /**
-     * Determines the following: - WorldGen, including the used wood blocks - {@link IFruitFamily}s supported. Limits which {@link IFruitProvider}
-     * will actually yield fruit with this species. - Native {@link EnumPlantType} for this tree. Combines with the PLANT chromosome.
+     * Determines the following: - WorldGen, including the used wood blocks - {@link IFruitFamily}s supported. Limits
+     * which {@link IFruitProvider} will actually yield fruit with this species. - Native {@link EnumPlantType} for this
+     * tree. Combines with the PLANT chromosome.
     */
    SPECIES(IAlleleTreeSpecies.class),
    /**
@@ -37,7 +40,8 @@ public enum EnumTreeChromosome implements IChromosomeType {
     */
    FERTILITY(IAlleleFloat.class),
    /**
-     * {@link IFruitProvider}, determines if and what fruits are grown on the tree. Limited by the {@link IFruitFamily}s the species supports.
+     * {@link IFruitProvider}, determines if and what fruits are grown on the tree. Limited by the {@link IFruitFamily}s
+     * the species supports.
     */
    FRUITS(IAlleleFruit.class),
    /**
@@ -69,10 +73,14 @@ public enum EnumTreeChromosome implements IChromosomeType {
    /**
     * Determines if the tree can burn.
     */
-    FIREPROOF(IAlleleBoolean.class),
-    ;
+    FIREPROOF(IAlleleBoolean.class);

-    Class<? extends IAllele> clss;
+    final Class<? extends IAllele> clss;
+
+    /**
+     * Cached values() array for frequent read-only operations, the array should NOT be mutated.
+     */
+    public static final EnumTreeChromosome[] VALUES = values();

    EnumTreeChromosome(Class<? extends IAllele> clss) {
        this.clss = clss;
@@ -7,9 +7,11 @@ package forestry.api.arboriculture;

 import java.util.Locale;
 import java.util.Random;
+
 import net.minecraft.nbt.NBTTagCompound;

 public enum EnumWoodType {
+
    LARCH,
    TEAK,
    ACACIA,
@@ -5,9 +5,10 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

+import net.minecraft.world.World;
+
 import forestry.api.genetics.IAlleleEffect;
 import forestry.api.genetics.IEffectData;
-import net.minecraft.world.World;

 /**
 * Simple allele encapsulating a leaf effect. (Not implemented)
@@ -5,13 +5,15 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

+import java.util.Collection;
+
+import net.minecraft.util.IIcon;
+import net.minecraftforge.common.EnumPlantType;
+
 import cpw.mods.fml.relauncher.Side;
 import cpw.mods.fml.relauncher.SideOnly;
 import forestry.api.genetics.IAlleleSpecies;
 import forestry.api.genetics.IFruitFamily;
-import java.util.Collection;
-import net.minecraft.util.IIcon;
-import net.minecraftforge.common.EnumPlantType;

 public interface IAlleleTreeSpecies extends IAlleleSpecies {

@@ -5,9 +5,10 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

+import net.minecraftforge.common.EnumPlantType;
+
 import forestry.api.genetics.IAlleleSpeciesCustom;
 import forestry.api.genetics.IFruitFamily;
-import net.minecraftforge.common.EnumPlantType;

 public interface IAlleleTreeSpeciesCustom extends IAlleleSpeciesCustom, IAlleleTreeSpecies {

@@ -7,4 +7,5 @@ package forestry.api.arboriculture;

 import forestry.api.genetics.IBreedingTracker;

-public interface IArboristTracker extends IBreedingTracker {}
+public interface IArboristTracker extends IBreedingTracker {
+}
@@ -5,14 +5,15 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
-import forestry.api.genetics.IFruitFamily;
 import net.minecraft.client.renderer.texture.IIconRegister;
 import net.minecraft.item.ItemStack;
 import net.minecraft.world.IBlockAccess;
 import net.minecraft.world.World;

+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
+import forestry.api.genetics.IFruitFamily;
+
 public interface IFruitProvider {

    IFruitFamily getFamily();
@@ -43,8 +44,7 @@ public interface IFruitProvider {
     * @param x
     * @param y
     * @param z
-     * @param ripeningTime
-     *            Elapsed ripening time for the fruit.
+     * @param ripeningTime Elapsed ripening time for the fruit.
     * @param fancy
     * @return IIcon index of the texture to overlay on the leaf block.
     */
@@ -9,11 +9,11 @@ import net.minecraft.client.renderer.texture.IIconRegister;
 import net.minecraft.util.IIcon;

 /**
- * Provides icons for saplings, pollen, etc.
- * You must implement this yourself to use TreeManager.treeFactory.createSpecies()
- * There is no default implementation because every sapling has a unique icon.
+ * Provides icons for saplings, pollen, etc. You must implement this yourself to use
+ * TreeManager.treeFactory.createSpecies() There is no default implementation because every sapling has a unique icon.
 */
 public interface IGermlingIconProvider {
+
    void registerIcons(IIconRegister register);

    IIcon getIcon(EnumGermlingType type, int renderPass);
@@ -12,17 +12,17 @@ public interface IGrowthProvider {
    /**
     * Check to see whether a sapling at the given location with the given genome can grow into a tree.
     *
-     * @param genome Genome of the tree this is called for.
-     * @param world Minecraft world the tree will inhabit.
-     * @param xPos x-Coordinate to attempt growth at.
-     * @param yPos y-Coordinate to attempt growth at.
-     * @param zPos z-Coordinate to attempt growth at.
-     * @param expectedGirth Trunk size of the tree to generate.
+     * @param genome         Genome of the tree this is called for.
+     * @param world          Minecraft world the tree will inhabit.
+     * @param xPos           x-Coordinate to attempt growth at.
+     * @param yPos           y-Coordinate to attempt growth at.
+     * @param zPos           z-Coordinate to attempt growth at.
+     * @param expectedGirth  Trunk size of the tree to generate.
     * @param expectedHeight Height of the tree to generate.
     * @return true if the tree can grow at the given coordinates, false otherwise.
     */
-    boolean canGrow(
-            ITreeGenome genome, World world, int xPos, int yPos, int zPos, int expectedGirth, int expectedHeight);
+    boolean canGrow(ITreeGenome genome, World world, int xPos, int yPos, int zPos, int expectedGirth,
+            int expectedHeight);

    EnumGrowthConditions getGrowthConditions(ITreeGenome genome, World world, int xPos, int yPos, int zPos);

@@ -8,13 +8,14 @@ package forestry.api.arboriculture;
 import net.minecraft.util.IIcon;

 /**
- * Provides icons for leaves. Used by TreeManager.treeFactory.createSpecies()
- * Get a default Forestry implementation from TreeManager.treeFactory.getLeafIconProvider() or implement your own.
+ * Provides icons for leaves. Used by TreeManager.treeFactory.createSpecies() Get a default Forestry implementation from
+ * TreeManager.treeFactory.getLeafIconProvider() or implement your own.
 *
- * If you implement your own, be sure to register the icons.
- * Icon registration is not done here because these icons are heavily reused.
+ * If you implement your own, be sure to register the icons. Icon registration is not done here because these icons are
+ * heavily reused.
 */
 public interface ILeafIconProvider {
+
    IIcon getIcon(boolean pollinated, boolean fancy);

    int getColor(boolean pollinated);
@@ -8,5 +8,6 @@ package forestry.api.arboriculture;
 import net.minecraft.world.World;

 public interface ILeafTickHandler {
+
    boolean onRandomLeafTick(ITree tree, World world, int x, int y, int z, boolean isDestroyed);
 }
@@ -10,14 +10,15 @@ import net.minecraft.item.ItemStack;
 import net.minecraft.world.World;

 public interface IToolGrafter {
+
    /**
     * Called by leaves to determine the increase in sapling droprate.
     *
     * @param stack ItemStack containing the grafter.
     * @param world Minecraft world the player and the target block inhabit.
-     * @param x x-Coordinate of the broken leaf block.
-     * @param y y-Coordinate of the broken leaf block.
-     * @param z z-Coordinate of the broken leaf block.
+     * @param x     x-Coordinate of the broken leaf block.
+     * @param y     y-Coordinate of the broken leaf block.
+     * @param z     z-Coordinate of the broken leaf block.
     * @return Float representing the factor the usual drop chance is to be multiplied by.
     */
    float getSaplingModifier(ItemStack stack, World world, EntityPlayer player, int x, int y, int z);
@@ -5,16 +5,19 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

-import com.mojang.authlib.GameProfile;
-import forestry.api.genetics.IEffectData;
-import forestry.api.genetics.IIndividual;
-import forestry.api.world.ITreeGenData;
 import java.util.EnumSet;
+
 import net.minecraft.item.ItemStack;
 import net.minecraft.world.World;
 import net.minecraft.world.gen.feature.WorldGenerator;
 import net.minecraftforge.common.EnumPlantType;

+import com.mojang.authlib.GameProfile;
+
+import forestry.api.genetics.IEffectData;
+import forestry.api.genetics.IIndividual;
+import forestry.api.world.ITreeGenData;
+
 public interface ITree extends IIndividual, ITreeGenData {

    void mate(ITree other);
@@ -5,38 +5,32 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

-import forestry.api.genetics.IClassification;
 import java.awt.Color;

+import forestry.api.genetics.IClassification;
+
 public interface ITreeFactory {
+
    /**
-     * Creates a new tree species.
-     * Automatically registered with AlleleManager.alleleRegistry.registerAllele()
-     * See IAlleleTreeSpeciesCustom and IAlleleSpeciesCustom for adding additional properties to the returned species.
+     * Creates a new tree species. Automatically registered with AlleleManager.alleleRegistry.registerAllele() See
+     * IAlleleTreeSpeciesCustom and IAlleleSpeciesCustom for adding additional properties to the returned species.
     *
-     * @param uid Unique Identifier for this species
-     * @param unlocalizedName Unlocalized name for this species
-     * @param authority Authority for the binomial name, e.g. "Sengir" on species of base Forestry.
+     * @param uid                    Unique Identifier for this species
+     * @param unlocalizedName        Unlocalized name for this species
+     * @param authority              Authority for the binomial name, e.g. "Sengir" on species of base Forestry.
     * @param unlocalizedDescription Unlocalized description for this species
-     * @param dominant Whether this species is genetically dominant (false means it is recessive)
-     * @param branch Classification of this species
-     * @param binomial Binomial name of the species sans genus. "humboldti" will have the bee species flavour name be "Apis humboldti". Feel free to use fun names or null.
-     * @param leafIconProvider The leaf icon provider for this species
-     * @param germlingIconProvider The germling icon provider for this species
-     * @param generator The tree generator
+     * @param dominant               Whether this species is genetically dominant (false means it is recessive)
+     * @param branch                 Classification of this species
+     * @param binomial               Binomial name of the species sans genus. "humboldti" will have the bee species
+     *                               flavour name be "Apis humboldti". Feel free to use fun names or null.
+     * @param leafIconProvider       The leaf icon provider for this species
+     * @param germlingIconProvider   The germling icon provider for this species
+     * @param generator              The tree generator
     * @return a new tree species allele.
     */
-    IAlleleTreeSpeciesCustom createSpecies(
-            String uid,
-            String unlocalizedName,
-            String authority,
-            String unlocalizedDescription,
-            boolean dominant,
-            IClassification branch,
-            String binomial,
-            ILeafIconProvider leafIconProvider,
-            IGermlingIconProvider germlingIconProvider,
-            ITreeGenerator generator);
+    IAlleleTreeSpeciesCustom createSpecies(String uid, String unlocalizedName, String authority,
+            String unlocalizedDescription, boolean dominant, IClassification branch, String binomial,
+            ILeafIconProvider leafIconProvider, IGermlingIconProvider germlingIconProvider, ITreeGenerator generator);

    /** Get one of the built-in Forestry leaf types. Default type is deciduous. */
    ILeafIconProvider getLeafIconProvider(EnumLeafType enumLeafType, Color color, Color colorPollinated);
@@ -5,16 +5,19 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

-import com.mojang.authlib.GameProfile;
-import forestry.api.world.ITreeGenData;
 import net.minecraft.world.World;
 import net.minecraft.world.gen.feature.WorldGenerator;
 import net.minecraftforge.common.util.ForgeDirection;

+import com.mojang.authlib.GameProfile;
+
+import forestry.api.world.ITreeGenData;
+
 /**
 * Implements the tree generation for a tree species.
 */
 public interface ITreeGenerator {
+
    WorldGenerator getWorldGenerator(ITreeGenData tree);

    void setLogBlock(ITreeGenome genome, World world, int x, int y, int z, ForgeDirection facing);
@@ -5,10 +5,12 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

-import forestry.api.genetics.IGenome;
 import java.util.EnumSet;
+
 import net.minecraftforge.common.EnumPlantType;

+import forestry.api.genetics.IGenome;
+
 public interface ITreeGenome extends IGenome {

    IAlleleTreeSpecies getPrimary();
@@ -24,8 +26,8 @@ public interface ITreeGenome extends IGenome {
    float getFertility();

    /**
-     * @return Determines either a) how many fruit leaves there are or b) the chance for any fruit leave to drop a sapling. Exact usage determined by the
-     *         IFruitProvider
+     * @return Determines either a) how many fruit leaves there are or b) the chance for any fruit leave to drop a
+     *         sapling. Exact usage determined by the IFruitProvider
     */
    float getYield();

@@ -5,9 +5,10 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

+import net.minecraft.world.World;
+
 import forestry.api.genetics.IMutation;
 import forestry.api.genetics.ISpeciesRoot;
-import net.minecraft.world.World;

 public interface ITreeMutation extends IMutation {

@@ -20,13 +21,6 @@ public interface ITreeMutation extends IMutation {
     * @return float representing the percent chance for mutation to occur, from 0.0 to 100.0.
     * @since Forestry 4.0
     */
-    float getChance(
-            World world,
-            int x,
-            int y,
-            int z,
-            IAlleleTreeSpecies allele0,
-            IAlleleTreeSpecies allele1,
-            ITreeGenome genome0,
-            ITreeGenome genome1);
+    float getChance(World world, int x, int y, int z, IAlleleTreeSpecies allele0, IAlleleTreeSpecies allele1,
+            ITreeGenome genome0, ITreeGenome genome1);
 }
@@ -7,4 +7,5 @@ package forestry.api.arboriculture;

 import forestry.api.genetics.IMutationCustom;

-public interface ITreeMutationCustom extends ITreeMutation, IMutationCustom {}
+public interface ITreeMutationCustom extends ITreeMutation, IMutationCustom {
+}
@@ -8,17 +8,17 @@ package forestry.api.arboriculture;
 import forestry.api.genetics.IAllele;

 public interface ITreeMutationFactory {
+
    /**
-     * Creates a new tree mutation.
-     * Automatically registered with TreeManager.treeRoot.registerMutation()
-     * See ITreeMutationCustom and IMutationCustom for adding additional properties to the returned mutation.
+     * Creates a new tree mutation. Automatically registered with TreeManager.treeRoot.registerMutation() See
+     * ITreeMutationCustom and IMutationCustom for adding additional properties to the returned mutation.
     *
     * @param parentTree0 A parent tree for this mutation
     * @param parentTree1 A parent tree for this mutation
-     * @param result The resulting alleles for this mutation
-     * @param chance The chance that breeding the two parent trees will result in this mutation
+     * @param result      The resulting alleles for this mutation
+     * @param chance      The chance that breeding the two parent trees will result in this mutation
     * @return a new tree mutation.
     */
-    ITreeMutationCustom createMutation(
-            IAlleleTreeSpecies parentTree0, IAlleleTreeSpecies parentTree1, IAllele[] result, int chance);
+    ITreeMutationCustom createMutation(IAlleleTreeSpecies parentTree0, IAlleleTreeSpecies parentTree1, IAllele[] result,
+            int chance);
 }
@@ -5,16 +5,19 @@
 ******************************************************************************/
 package forestry.api.arboriculture;

-import com.mojang.authlib.GameProfile;
-import forestry.api.genetics.IAllele;
-import forestry.api.genetics.IChromosome;
-import forestry.api.genetics.ISpeciesRoot;
 import java.util.ArrayList;
 import java.util.Collection;
+
 import net.minecraft.item.ItemStack;
 import net.minecraft.nbt.NBTTagCompound;
 import net.minecraft.world.World;

+import com.mojang.authlib.GameProfile;
+
+import forestry.api.genetics.IAllele;
+import forestry.api.genetics.IChromosome;
+import forestry.api.genetics.ISpeciesRoot;
+
 public interface ITreeRoot extends ISpeciesRoot {

    @Override
@@ -48,6 +51,7 @@ public interface ITreeRoot extends ISpeciesRoot {
    /* TREE SPECIFIC */
    /**
     * Register a leaf tick handler.
+     * 
     * @param handler the {@link ILeafTickHandler} to register.
     */
    void registerLeafTickHandler(ILeafTickHandler handler);
@@ -8,6 +8,7 @@ package forestry.api.arboriculture;
 import net.minecraft.item.ItemStack;

 public interface IWoodItemAccess {
+
    ItemStack getLog(EnumWoodType woodType, boolean fireproof);

    ItemStack getPlanks(EnumWoodType woodType, boolean fireproof);
@@ -6,6 +6,7 @@
 package forestry.api.circuits;

 public enum CircuitSocketType implements ICircuitSocketType {
+
    NONE("none"),
    FARM("forestry.farm"),
    ELECTRIC_ENGINE("forestry.electric.engine"),
@@ -8,6 +8,7 @@ package forestry.api.circuits;
 import java.util.List;

 public interface ICircuit {
+
    String getUID();

    boolean requiresDiscovery();
@@ -5,9 +5,10 @@
 ******************************************************************************/
 package forestry.api.circuits;

-import forestry.api.core.INBTTagable;
 import java.util.List;

+import forestry.api.core.INBTTagable;
+
 public interface ICircuitBoard extends INBTTagable {

    int getPrimaryColor();
@@ -28,6 +29,7 @@ public interface ICircuitBoard extends INBTTagable {

    /**
     * Specifies where a circuit can be used.
+     * 
     * @since Forestry 4.0
     */
    ICircuitSocketType getSocketType();
@@ -18,6 +18,7 @@ public interface ICircuitLayout {

    /**
     * Specifies where a circuit layout is used.
+     * 
     * @since Forestry 4.0
     */
    ICircuitSocketType getSocketType();
@@ -5,4 +5,5 @@
 ******************************************************************************/
 package forestry.api.circuits;

-public interface ICircuitLibrary {}
+public interface ICircuitLibrary {
+}
@@ -6,6 +6,7 @@
 package forestry.api.circuits;

 import java.util.Map;
+
 import net.minecraft.item.ItemStack;
 import net.minecraft.world.World;

@@ -6,10 +6,11 @@
 package forestry.api.circuits;

 /**
- * Specifies where a circuit layout can be used. (i.e. farm, machine, engine, etc)
- * See CircuitSocketType for Forestry's uses.
+ * Specifies where a circuit layout can be used. (i.e. farm, machine, engine, etc) See CircuitSocketType for Forestry's
+ * uses.
 */
 public interface ICircuitSocketType {
+
    /** unique identifier for this socket type */
    String getUid();

@@ -2,6 +2,7 @@ package forestry.api.core;

 import java.util.HashMap;
 import java.util.Map;
+
 import net.minecraft.world.biome.BiomeGenBase;
 import net.minecraftforge.common.BiomeDictionary;

@@ -17,8 +18,9 @@ public class BiomeHelper {
    }

    /**
-     * Determines if a given BiomeGenBase is of HELLISH temperature, since it is treated separately from actual temperature values.
-     * Uses the BiomeDictionary.
+     * Determines if a given BiomeGenBase is of HELLISH temperature, since it is treated separately from actual
+     * temperature values. Uses the BiomeDictionary.
+     * 
     * @param biomeGen BiomeGenBase of the biome in question
     * @return true, if the BiomeGenBase is a Nether-type biome; false otherwise.
     */
@@ -6,18 +6,25 @@
 package forestry.api.core;

 /**
- *  Many things Forestry use temperature and humidity of a biome to determine whether they can or how they can work or spawn at a given location.
+ * Many things Forestry use temperature and humidity of a biome to determine whether they can or how they can work or
+ * spawn at a given location.
 *
- *  This enum concerns humidity.
+ * This enum concerns humidity.
 */
 public enum EnumHumidity {
+
    ARID("Arid"),
    NORMAL("Normal"),
    DAMP("Damp");

+    /**
+     * Cached values() array for frequent read-only operations, the array should NOT be mutated.
+     */
+    public static final EnumHumidity[] VALUES = values();
+
    public final String name;

-    private EnumHumidity(String name) {
+    EnumHumidity(String name) {
        this.name = name;
    }

@@ -26,8 +33,9 @@ public enum EnumHumidity {
    }

    /**
-     * Determines the EnumHumidity given a floating point representation of Minecraft Rainfall.
-     * To check if rainfall is possible in a biome, use BiomeHelper.canRainOrSnow().
+     * Determines the EnumHumidity given a floating point representation of Minecraft Rainfall. To check if rainfall is
+     * possible in a biome, use BiomeHelper.canRainOrSnow().
+     * 
     * @param rawHumidity raw rainfall value
     * @return EnumHumidity corresponding to rainfall value
     */
@@ -5,17 +5,20 @@
 ******************************************************************************/
 package forestry.api.core;

-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
 import net.minecraft.util.IIcon;
 import net.minecraft.world.biome.BiomeGenBase;

+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
+
 /**
- *  Many things Forestry use temperature and humidity of a biome to determine whether they can or how they can work or spawn at a given location.
+ * Many things Forestry use temperature and humidity of a biome to determine whether they can or how they can work or
+ * spawn at a given location.
 *
- *  This enum concerns temperature.
+ * This enum concerns temperature.
 */
 public enum EnumTemperature {
+
    NONE("None", "habitats/ocean"),
    ICY("Icy", "habitats/snow"),
    COLD("Cold", "habitats/taiga"),
@@ -24,10 +27,15 @@ public enum EnumTemperature {
    HOT("Hot", "habitats/desert"),
    HELLISH("Hellish", "habitats/nether");

+    /**
+     * Cached values() array for frequent read-only operations, the array should NOT be mutated.
+     */
+    public static final EnumTemperature[] VALUES = values();
+
    public final String name;
    public final String iconIndex;

-    private EnumTemperature(String name, String iconIndex) {
+    EnumTemperature(String name, String iconIndex) {
        this.name = name;
        this.iconIndex = iconIndex;
    }
@@ -42,9 +50,9 @@ public enum EnumTemperature {
    }

    /**
-     * Determines the EnumTemperature given a floating point representation of
-     * Minecraft temperature. Hellish biomes are handled based on their biome
-     * type - check BiomeHelper.isBiomeHellish.
+     * Determines the EnumTemperature given a floating point representation of Minecraft temperature. Hellish biomes are
+     * handled based on their biome type - check BiomeHelper.isBiomeHellish.
+     * 
     * @param rawTemp raw temperature value
     * @return EnumTemperature corresponding to value of rawTemp
     */
@@ -5,27 +5,25 @@
 ******************************************************************************/
 package forestry.api.core;

+import java.util.Set;
+
 import cpw.mods.fml.relauncher.Side;
 import cpw.mods.fml.relauncher.SideOnly;
-import java.util.Set;

 /**
 * Forestry's API is divided into several subcategories to make it easier to understand.
 *
- * If you need to distribute API files, try to only include the parts you are actually
- * using to minimize conflicts due to API changes.
+ * If you need to distribute API files, try to only include the parts you are actually using to minimize conflicts due
+ * to API changes.
 *
- *  .core     - Miscallenous base classes and interfaces as well as some basics for tools, armor, game modes and stuff needed by biome mods.
- *  .fuels    - Managers and classes to facilitate adding fuels to various engines and machines.
- *  .recipes  - Managers and helpers to facilitate adding new recipes to various machines.
- *  .storage  - Managers, events and interfaces for defining new backpacks and handling backpack behaviour.
- *  .mail     - Anything related to handling letters and adding new mail carrier systems.
- *  .genetics - Shared code for all genetic subclasses.
- *  			\ .apiculture       - Bees.
- *  			\ .arboriculture    - Trees.
- *  			\ .lepidopterology  - Butterflies.
+ * .core - Miscallenous base classes and interfaces as well as some basics for tools, armor, game modes and stuff needed
+ * by biome mods. .fuels - Managers and classes to facilitate adding fuels to various engines and machines. .recipes -
+ * Managers and helpers to facilitate adding new recipes to various machines. .storage - Managers, events and interfaces
+ * for defining new backpacks and handling backpack behaviour. .mail - Anything related to handling letters and adding
+ * new mail carrier systems. .genetics - Shared code for all genetic subclasses. \ .apiculture - Bees. \ .arboriculture
+ * - Trees. \ .lepidopterology - Butterflies.
 *
- *  Note that if Forestry is not present, all these references will be null.
+ * Note that if Forestry is not present, all these references will be null.
 */
 public class ForestryAPI {

@@ -53,15 +51,13 @@ public class ForestryAPI {
    public static IForestryConstants forestryConstants;

    /**
-     * The currently enabled Forestry plugins.
-     * Can be used to check if certain features are available, for example:
+     * The currently enabled Forestry plugins. Can be used to check if certain features are available, for example:
     * ForestryAPI.enabledPlugins.contains("APICULTURE")
     */
    public static Set<String> enabledPlugins;

    /**
-     * Instance of the errorStateRegistry for registering errors.
-     * Also creates new instances of IErrorLogic.
+     * Instance of the errorStateRegistry for registering errors. Also creates new instances of IErrorLogic.
     */
    public static IErrorStateRegistry errorStateRegistry;
 }
@@ -5,17 +5,20 @@
 ******************************************************************************/
 package forestry.api.core;

+import net.minecraft.entity.player.EntityPlayer;
+
 import com.mojang.authlib.GameProfile;
+
 import cpw.mods.fml.common.eventhandler.Event;
 import forestry.api.genetics.IAlleleSpecies;
 import forestry.api.genetics.IBreedingTracker;
 import forestry.api.genetics.IMutation;
 import forestry.api.genetics.ISpeciesRoot;
-import net.minecraft.entity.player.EntityPlayer;

 public abstract class ForestryEvent extends Event {

    private abstract static class BreedingEvent extends ForestryEvent {
+
        public final ISpeciesRoot root;
        public final IBreedingTracker tracker;
        public final GameProfile username;
@@ -29,16 +32,18 @@ public abstract class ForestryEvent extends Event {
    }

    public static class SpeciesDiscovered extends BreedingEvent {
+
        public final IAlleleSpecies species;

-        public SpeciesDiscovered(
-                ISpeciesRoot root, GameProfile username, IAlleleSpecies species, IBreedingTracker tracker) {
+        public SpeciesDiscovered(ISpeciesRoot root, GameProfile username, IAlleleSpecies species,
+                IBreedingTracker tracker) {
            super(root, username, tracker);
            this.species = species;
        }
    }

    public static class MutationDiscovered extends BreedingEvent {
+
        public final IMutation allele;

        public MutationDiscovered(ISpeciesRoot root, GameProfile username, IMutation allele, IBreedingTracker tracker) {
@@ -48,6 +53,7 @@ public abstract class ForestryEvent extends Event {
    }

    public static class SyncedBreedingTracker extends ForestryEvent {
+
        public final IBreedingTracker tracker;
        public final EntityPlayer player;

@@ -13,12 +13,9 @@ public interface IArmorNaturalist {
    /**
     * Called when the naturalist's armor acts as spectacles for seeing pollinated tree leaves/flowers.
     *
-     * @param player
-     *            Player doing the viewing
-     * @param armor
-     *            Armor item
-     * @param doSee
-     *            Whether or not to actually do the side effects of viewing
+     * @param player Player doing the viewing
+     * @param armor  Armor item
+     * @param doSee  Whether or not to actually do the side effects of viewing
     * @return true if the armor actually allows the player to see pollination.
     */
    public boolean canSeePollination(EntityPlayer player, ItemStack armor, boolean doSee);
@@ -1,23 +1,26 @@
 /*******************************************************************************
- * Copyright (c) 2011-2014 SirSengir.
- * All rights reserved. This program and the accompanying materials
- * are made available under the terms of the GNU Lesser Public License v3
- * which accompanies this distribution, and is available at
- * http://www.gnu.org/licenses/lgpl-3.0.txt
+ * Copyright (c) 2011-2014 SirSengir. All rights reserved. This program and the accompanying materials are made
+ * available under the terms of the GNU Lesser Public License v3 which accompanies this distribution, and is available
+ * at http://www.gnu.org/licenses/lgpl-3.0.txt
 *
- * Various Contributors including, but not limited to:
- * SirSengir (original work), CovertJaguar, Player, Binnie, MysteriousAges
+ * Various Contributors including, but not limited to: SirSengir (original work), CovertJaguar, Player, Binnie,
+ * MysteriousAges
 ******************************************************************************/
 package forestry.api.core;

 public interface IClimateControlled {
+
    /**
     * Change the temperature, but not lower than boundaryDown or higher than boundaryUp.
+     *
+     * When used in an alveary the change applies a 20x stronger effect
     */
    void addTemperatureChange(float change, float boundaryDown, float boundaryUp);

    /**
     * Change the humidity, but not lower than boundaryDown or higher than boundaryUp.
+     *
+     * When used in an alveary the change applies a 20x stronger effect
     */
    void addHumidityChange(float change, float boundaryDown, float boundaryUp);
 }
@@ -3,6 +3,7 @@ package forestry.api.core;
 import net.minecraft.world.biome.BiomeGenBase;

 public interface IClimateProvider {
+
    BiomeGenBase getBiome();

    EnumTemperature getTemperature();
@@ -10,13 +10,14 @@ import java.io.DataOutputStream;
 import java.io.IOException;

 /**
- * Keeps track of all the IErrorStates for an object.
- * Create a new IErrorLogic instance for your object with ForestryAPI.errorStateRegistry.createErrorLogic().
+ * Keeps track of all the IErrorStates for an object. Create a new IErrorLogic instance for your object with
+ * ForestryAPI.errorStateRegistry.createErrorLogic().
 */
 public interface IErrorLogic extends IErrorSource {

    /**
     * Sets the errorState when condition is true, and unsets it when condition is false.
+     * 
     * @return condition
     */
    boolean setCondition(boolean condition, IErrorState errorState);
@@ -9,5 +9,6 @@ package forestry.api.core;
 * An IErrorLogicSource uses an instance of IErrorLogic to deal with its errors.
 */
 public interface IErrorLogicSource {
+
    IErrorLogic getErrorLogic();
 }
@@ -8,6 +8,7 @@ package forestry.api.core;
 import com.google.common.collect.ImmutableSet;

 public interface IErrorSource {
+
    /**
     * @return the active error states. An empty Set indicates no errors.
     */
@@ -5,11 +5,12 @@
 ******************************************************************************/
 package forestry.api.core;

-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
 import net.minecraft.client.renderer.texture.IIconRegister;
 import net.minecraft.util.IIcon;

+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
+
 /**
 *
 * @author CovertJaguar <http://www.railcraft.info/>
@@ -8,6 +8,7 @@ package forestry.api.core;
 import java.util.Set;

 public interface IErrorStateRegistry {
+
    void registerErrorState(IErrorState state);

    void addAlias(IErrorState state, String name);
@@ -5,11 +5,12 @@
 ******************************************************************************/
 package forestry.api.core;

-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
 import net.minecraft.client.renderer.texture.IIconRegister;
 import net.minecraft.util.IIcon;

+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
+
 /**
 * Provides icons, needed in some interfaces, most notably for bees and trees.
 */
@@ -8,6 +8,7 @@ package forestry.api.core;
 import net.minecraft.nbt.NBTTagCompound;

 public interface INBTTagable {
+
    void readFromNBT(NBTTagCompound nbttagcompound);

    void writeToNBT(NBTTagCompound nbttagcompound);
@@ -5,9 +5,10 @@
 ******************************************************************************/
 package forestry.api.core;

+import net.minecraft.util.IIcon;
+
 import cpw.mods.fml.relauncher.Side;
 import cpw.mods.fml.relauncher.SideOnly;
-import net.minecraft.util.IIcon;

@SideOnly(Side.CLIENT)
 public interface ITextureManager {
Author	SHA1	Message	Date
Ruling-0	2c057d4854	Doc pass	2026-10-12 15:32:44 -05:00
Ruling-0	96b8f60f87	Remove full-name invocations	2026-10-12 15:23:44 -05:00
Ruling-0	a2a1f8eca9	Transform mail boxes through Postea's custom data API	2026-10-12 15:23:44 -05:00
Worive	f2e85073d3	Fix alveary inventory drops on chunk unload (#134 )	2026-10-03 12:46:01 -05:00
ABKQPO	0bd9a7978a	Expose mutation resource condition values (#135 )	2026-09-15 21:06:15 +02:00
boubou19	e47fc90433	reduce allocations of arrays to once per call (#133 )	2026-08-25 19:19:42 -04:00
boubou19	452064ef1d	More enum `.values()` caching (#131 )	2026-08-14 01:10:34 +02:00
boubou19	59c8c36520	Cache enum `.values()` (#130 )	2026-08-10 20:56:48 +02:00
Ryan Nasers	ea1c4edae4	Fixes the display of blocks in NEI for the double slab blocks (#129 )	2026-08-10 08:22:57 +07:00
Firewooddoge	4c46626cdb	Fix Japanese block names showing as unlocalized .name keys (#128 )	2026-08-08 14:30:36 +07:00
Alex VermetteandAlex Vermette	d6fa8d8b74	fix: implement stacked block slab (#127 ) Co-authored-by: Alex Vermette <[email protected]>	2026-07-27 13:20:40 -04:00
UltraProdigy	704861b666	Delete Forestry CONTRIBUTING.md (#126 )	2026-07-04 19:02:06 +00:00
Algent	db25dcce48	Dupe Fix - Make bag logic more lag resistant (#121 )	2026-07-04 18:57:41 +00:00
FourIsTheNumber	4b364a93db	Use extended interface (#125 )	2026-07-01 18:27:50 -04:00
Yannick Marcotte-Gourde	a217884480	Fix Worktable NEI fill regression (#124 )	2026-06-28 15:19:53 -04:00
tiffit	90f7c36a1e	Add NEI overlays for the carpenter and fabricator (#123 )	2026-06-19 21:58:09 +02:00
FourIsTheNumber	974e44f5cd	Add API method for protection amount on IArmorApiarist (#122 )	2026-06-15 01:19:34 -04:00
Ed Rakhmankulov	bbb374cd5e	added ability to open backpacks enabled by NoHotbarNeeded (#105 )	2026-05-24 14:59:08 +02:00
Eldrinn-Elantey	3470c6c7d1	Add OreDictionary entry for fertile tree pollen (#120 )	2026-05-09 14:26:25 +02:00
Alexdoru	b1377d5642	return the correct butterfly when rendering (#119 )	2026-05-01 17:36:27 +02:00
Yoshy	b50910496e	Fix crash when rendering creative tab (#118 )	2026-05-01 00:39:25 -04:00
AlexdoruandUltraProdigy	cc4b16e2a5	fix crash if block is null in TileWood#getPickBlock (#114 ) Co-authored-by: UltraProdigy <[email protected]>	2026-04-28 22:19:46 +00:00
Faltsolph	3b63133790	change an integer to a float in a division to avoid possible rounding error in apiary comb production formula (#117 )	2026-04-28 21:29:29 +00:00
Alexdoruandboubou19	6d8d7110e1	Fix world client leaks in butterfly and analyzer renderer (#116 ) Co-authored-by: boubou19 <[email protected]>	2026-04-27 23:43:29 +02:00
Martin Robertz	98fa57844e	update	2026-04-27 12:42:21 +02:00
Ranzu	adbb300523	Added color localization for the missing items inside the worktable gui (#115 )	2026-04-25 16:16:40 +02:00
Alexdoru	839882b783	Fix WorldClient memory leak in butterfly renderer (#113 )	2026-04-09 21:49:41 +02:00
Martin Robertz	2635d036aa	update+gradle+deps+bs	2026-04-03 16:23:52 +02:00
Guillaume Mercier	cf8f2f54c5	Add fertilizer registry (#112 )	2026-04-01 20:02:06 +02:00
TweksTY Martin Robertz UltraProdigy	4844bc937b	Fix alveary climate change calculations (#109 ) Co-authored-by: Martin Robertz <[email protected]> Co-authored-by: UltraProdigy <[email protected]>	2026-03-14 08:12:51 +00:00
Alexdoru	88f50d91e1	BFS leaf decay (#111 )	2026-03-13 16:50:52 +01:00
Alexdoru	3bc6720dec	Prevent loading chunks while ticking blocks (#110 )	2026-03-12 21:33:00 +01:00
UltraProdigy	1083f52a30	Optimize Image & Workflow (#108 )	2026-03-07 10:30:44 +01:00
Alexdoru	3fb58ad6a5	Cache frequent Enum#values() calls (#107 )	2026-03-03 21:22:36 +01:00
Martin Robertz	7e1398438d	update	2026-02-21 23:38:35 +01:00
Ranzu	a02df943ed	Work on localization and color properties (#106 )	2026-02-21 23:33:53 +01:00
CN_132DAS	f88742e7ab	Allow bees use EFR flowers (#104 )	2025-12-14 19:54:18 +01:00
Martin Robertz	fb2ff8aef3	update	2025-11-04 22:38:13 +01:00
Teteros Teteros Martin Robertz	3f41c5e8f8	Add null guards to BlockUtil reflections to prevent NullPointerExceptions (#103 ) Co-authored-by: Teteros <[email protected]> Co-authored-by: Martin Robertz <[email protected]>	2025-11-04 21:39:04 +01:00
Martin Robertz	81b1de6925	update	2025-10-25 15:59:10 +02:00
DarkShadow44andMartin Robertz	278d091b08	Drop contents of Alveary when it's broken (#102 ) Co-authored-by: Martin Robertz <[email protected]>	2025-10-25 15:58:35 +02:00
querns	1552ad1b68	Adds configurable display of backpack fullness (#101 )	2025-10-25 15:45:46 +02:00
Alexdoru	bf94b22345	add public getters to use in gt5u (#100 )	2025-08-08 17:15:06 +00:00
Alexdoru	c89b61682a	use EnumChatFormatting and not Realms enum to avoid crash (#99 )	2025-07-21 11:00:21 +02:00
Dream Master	43fc136fe3	update	2025-07-18 10:15:39 +07:00
boubou19	ea52fa0d55	Speed up forge event registration (#98 )	2025-07-17 18:49:32 +00:00
Martin Robertz	725d556718	update	2025-07-10 11:11:16 +02:00
Yoshy	d88c007fbb	Add missing = in Localisation (#97 )	2025-07-09 22:28:25 +00:00
Martin Robertz	485333c6aa	update	2025-06-20 23:40:15 +02:00
slprime	240802082e	Change NEIHandler Tooltip Position (#96 )	2025-06-16 07:46:05 +02:00
Martin Robertz	6f182e932d	update	2025-06-03 20:22:19 +02:00
Yurii Martin Robertz boubou19 Maya	d08b42f18c	Protect some calls that lead to loadChunk with blockExists (#91 ) Co-authored-by: Martin Robertz <[email protected]> Co-authored-by: boubou19 <[email protected]> Co-authored-by: Maya <[email protected]>	2025-06-01 21:05:22 +00:00
Martin Robertz	57cc915a1e	update	2025-05-25 15:29:38 +02:00
DrParadox7	d7c5940596	Disable flowers that cannot be planted (#94 )	2025-05-25 15:28:01 +02:00
Martin Robertz	79a6af701b	update	2025-05-17 12:17:12 +02:00
dibbydoda	4c0b503b8b	Add thunder substrate for rainmaker (#95 )	2025-05-17 11:39:34 +02:00
thedarkcolour	2a6f3771a3	Fix multiblock components to drop inventory contents when broken (#93 )	2025-04-20 05:39:48 +00:00
Maya	04a7c96b4d	update	2025-04-19 09:19:48 -05:00
dibbydoda	6d0a001b9e	Habitat locator mouse hover shows Hellish temperature in the Nether (#92 )	2025-04-19 09:19:35 -05:00
Maya	e2c2ff8d30	update	2025-03-10 16:18:15 -05:00
Demiu	586f5bf093	Fix alveary climate logic (#90 )	2025-03-10 16:16:16 -05:00
Maya	755301d313	update	2025-02-22 22:50:41 -06:00
Discreater	33f3389b84	Add missing localization (#89 )	2025-02-22 22:50:30 -06:00
Maya	c9167b8316	update	2025-02-14 00:22:07 -06:00
Yannick Marcotte-Gourde	1ed646b147	Don't crash if someone tries to color number values stored in lang files (#88 )	2025-02-14 00:21:59 -06:00
Martin Robertz	7a7930d7eb	update	2024-12-31 14:25:14 +01:00
glowredman	3dccc7e06d	Add Localizations (#87 )	2024-12-30 18:18:18 -06:00
Martin Robertz	18e26956ef	update	2024-12-18 17:51:39 +01:00
combusterfandMarcel Sondaar	713b0f9d9e	fix: Use GT ash instead of letting unification screw everything up. (#86 ) Co-authored-by: Marcel Sondaar <[email protected]>	2024-12-18 07:23:38 +01:00
Martin Robertz	c6f2e3c7b3	update	2024-11-22 21:37:18 +01:00
chochem	c6d8518d82	fix apatite ore crash (#85 )	2024-11-21 17:11:44 +00:00
Dream Master	98711e5d34	update	2024-11-18 12:00:06 +01:00
Glease	5caab59507	close item inventory if parent item is gone (#84 )	2024-11-18 11:38:20 +01:00
Martin Robertz	41d47d99ca	update	2024-11-16 15:40:01 +01:00
Alexander Anishin	3c6d5d04d0	Fix NPE in logic of radioactive effect (#83 )	2024-11-16 12:04:33 +01:00
Martin Robertz	137927b3e6	update	2024-09-12 08:20:39 +02:00
Nico SpiskeandMartin Robertz	8aa7e05bbe	Add ability to display bee lore and add Discoverd by tag (#79 ) * [minor] add ability to display bee lore and add Discoverd by tag * [minor] better formatting, logic for bees, trees and butterflies. * [minor] changes according to review --------- Co-authored-by: Martin Robertz <[email protected]>	2024-09-12 07:34:49 +02:00
chochem	16414da3f2	Remove duplicate items (#82 ) * remove some items if dreamcraft is loaded * sa	2024-09-11 19:27:41 +02:00
NotAPenguinGitHub GTNH Actionsgithub-actions[bot]	11eb4b62df	Fix broken reflection into GT post-renaming (#80 ) * fix reflection * spotlessApply (#81) Co-authored-by: GitHub GTNH Actions <> --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2024-09-08 22:50:17 +02:00
Martin Robertz	a172cb379f	update	2024-08-31 11:27:01 +02:00
Connor-Colenso	c979d1fa79	Fix Alveary Mutation Overflow (#76 )	2024-08-30 15:09:10 +01:00
Astatine5985	ef5825edcf	Bee Mutation Logic Fix (#75 )	2024-08-29 21:55:11 +02:00
Connor-ColensoGitHub GTNH ActionsGTNH-Colen github-actions[bot]	9570cb2982	Change Radioactive Bee Effect (#72 ) * Change up how the radioactive bee works to make it a bit more reasonable. * Remove debug code * Fix the range of bees being off by one block. nextInt is [0,n), so we need to do n+1 to get our boundary included. * Remove unnecessary check, fix alveary block under not using correct y and unprotect other blocks under. Also fix canMineBlock being the wrong way round. * Fix under block protection for non-alvearies * spotlessApply (#73) Co-authored-by: GitHub GTNH Actions <> * Fix condition --------- Co-authored-by: GTNH-Colen <[email protected]> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2024-06-26 16:49:46 +02:00
Martin Robertz	f89a074393	update	2024-06-22 22:09:49 +02:00
chochem	19457080bf	dont extend the filter to any meta while optimizing (#74 )	2024-06-22 17:30:54 +01:00
Oleg Ivanov	d6ec27209b	Add ingredients search setting to the worktable (#70 )	2024-05-26 16:03:16 +02:00
Martin Robertz	a0435886ab	update	2024-05-26 12:52:39 +02:00
Ethryan	2ab8613bec	Adding a Coin Bag for all those coins. (#71 )	2024-05-26 12:48:21 +02:00
Martin Robertz	9d31dedd35	update	2024-05-04 11:43:39 +02:00
slprime	2dd539c3df	NEI incorrect tooltip with search	2024-05-04 11:38:09 +02:00
Martin Robertz	fd2ac7d172	update	2024-04-16 22:22:28 +02:00
NotAPenguin	466110d461	Fix wrong length check (#68 )	2024-04-15 17:47:49 +01:00
Martin Robertz	ecf0d7165c	update	2024-03-27 09:49:21 +01:00
DrParadox7	dde3514dce	Add Butterfly Leaf Spawn Config (#67 ) Added `butterfly.entities.disable.leaf.spawns` config to Lepidopterology.cfg. When set to _True_, it will stop any butterfly from spontaneously spawning from Forestry's leaves [_False_ by default]. Pregnant butterflies remain unaffected for fans of the hobby.	2024-03-26 18:14:34 -07:00
Martin Robertz	0f24a4e043	update	2024-03-04 20:29:49 +01:00
leumasme	3ed2ecfdd0	Fix multifarm not harvesting coffee and tea Also fixes fermenter recipes for these crops	2024-03-04 16:50:39 +01:00
Martin Robertz	be548b06cc	update	2024-03-03 09:42:06 +01:00
Jason Mitchell	7db0dc7767	Thread safe (#64 ) * update readme and bs * Thread safe	2024-03-02 21:43:31 +01:00
Jason Mitchell	2e20b14e06	Allocation reduction (#62 ) * Allocation reduction	2024-02-18 08:30:15 -08:00
Raven Szewczyk	576afde7b7	[ci skip] upgraded build system	2024-02-04 19:58:32 +00:00
bombcar	7f133a5e2a	[bs] fix buildscripts for jenkins (#61 )	2024-01-09 12:11:19 -06:00
Raven Szewczyk	0135b39309	[ci skip] upgraded build system	2024-01-08 21:25:44 +00:00
glowredman	2bcd3bb46c	Misc cleanup - add missing `serialVersionUID` fields - addess vararg warnings	2023-12-29 13:26:43 +01:00
glowredman	646988aae8	Addess some deprecation warnings	2023-12-29 13:26:43 +01:00
glowredman	331c8a8c7b	Fix generics	2023-12-29 13:26:43 +01:00
glowredman	68ab1b98bd	Add default cases to switch statements	2023-12-29 13:26:43 +01:00
glowredman	9140f84d57	Remove VersionChecker	2023-12-29 13:26:43 +01:00
glowredman	bf23ca2317	Update gradle.properties	2023-12-29 13:26:43 +01:00
bombcar	0e4f38b3d1	update buildscript	2023-12-20 19:29:15 +01:00
bombcar	eeb29cd7f0	add a name for butterflyGE	2023-12-20 19:29:15 +01:00
DrParadox7	103cd87cbe	Mail blacklist implements Set	2023-11-12 18:14:46 +01:00
DrParadox7	1da67c79f3	Rework wildcard imports	2023-11-12 18:14:46 +01:00
DrParadox7	3023b12d83	Update BS	2023-11-12 18:14:46 +01:00
DrParadox7	05c4914c79	Mails are now checked for prohibited items Added blacklist for Mail envelopes. It's mainly there to prevent players bypassing the stamp cost by sending out inventories rather than items.	2023-11-12 18:14:46 +01:00
miozune	bf6bf6846a	Update dependency types (#56 )	2023-08-12 10:37:19 +02:00
Martin Robertz	ba6f1d6249	sa	2023-07-18 20:31:15 +02:00
Martin Robertz	64e861af85	deps	2023-07-18 20:31:06 +02:00
Martin Robertz	27a4d86108	bs	2023-07-18 20:30:42 +02:00
hacatuandJakub	afc859c6e9	Fix Additive Production (#55 ) * Fixed Secondary Species Primary Production Calling Math.round on probabilities is a logical error * gradle spotlessApply * Fixed computation of BeeModifiers to be consistent with additive modifiers Needs work in other mods (Binnie and MagicBees) * Fixed doubled base production modifier, fixed tooltips for frames with negative modifiers * Fixed floating point bug if productionModifier is negative * Fixed floating point bug if productionModifier + tier is negative * Float constant suffix * Actually fix base production modifier * Improve tooltip coloring, correct production modifier self capping, add float suffixes * More tooltip improvments * Nerf base production (apiaries in shambles) * Halve forestry frame production boost Co-authored-by: Jakub <[email protected]> * Added flowering modifier to tooltips I believe one of the blood magic frames has a non-default flowering modifier * Fixed flowering modifier in tooltip and made default values visible --------- Co-authored-by: Jakub <[email protected]>	2023-07-18 20:28:03 +02:00
初夏同学	6292b4569f	Fix a bug when NBTString does not exist. (#54 )	2023-07-02 09:48:59 +09:00
Runakai1GitHub GTNH Actionsgithub-actions[bot]	99ebd8efe0	Fix Alveary Simulation of Temperatures (#52 ) * Fix Alveary Simulation of Temperatures * Spottless * spotlessApply (#53) Co-authored-by: GitHub GTNH Actions <> --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2023-06-18 14:56:09 +02:00
Dane Strandboge	29df6ceb1b	Auto-apply stats tooltips to all IHiveFrame items (#51 ) * Auto-apply stats tooltips to all IHiveFrame items * allow generated tooltip to be overridden * link event in api, update production tooltip	2023-04-28 18:54:35 +02:00
AlastorsandJason Mitchell	39c822df8a	Fixes the incompatability with the newest NEI Thanks Mitchbama Co-Authored-By: Jason Mitchell <[email protected]>	2023-04-26 17:49:04 -07:00
Jakub	9e9ae6bcad	Support GT_Block_Machines in mutation requirements (#48 )	2023-04-07 17:50:43 +02:00
Jakub	661a5598ea	New bees formula (#45 ) * New formula * Make production modifier globally additive	2023-03-29 17:26:15 +02:00
Jakub	d96669f5f7	Add a way to simulate night (#46 ) * Add a way to simulate night * Add default value to avoid crashes * Delighted -> Unlighted	2023-03-27 21:01:10 +02:00
Quetz4l	ca9ebbc0ed	add setting to config-> disable butterflies spawn (#44 ) * bs * add setting to config-> disable butterflies spawn + default disable is false * changed name DISABLE_BUTTERFLY to disableButterfly * changed Boolean to boolean (for disableButterfly)	2023-03-20 21:48:43 +01:00
Ethryan	7e60669620	Fix typo (#43 )	2023-02-19 22:32:10 +01:00
Martin RobertzGitHub GTNH Actionsgithub-actions[bot]	f2b402955a	Update Forestry.java (#41 ) * Update Forestry.java * spotlessApply (#42) Co-authored-by: GitHub GTNH Actions <> * Update Forestry.java --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2023-02-16 11:14:18 +01:00
hacatu	983b5bc8dd	Fixed Secondary Species Primary Production (#40 ) Calling Math.round on probabilities is a logical error	2023-02-16 10:17:58 +01:00
Raven Szewczyk	7817587067	[ci skip] upgraded build system	2023-01-31 09:52:49 +00:00
Jason Mitchell	79fb06bca6	[ci skip] Add git-blame-ignore-revs for spotlessApply	2023-01-29 12:03:50 -08:00
Jason Mitchell	94aa9346b1	[ci skip] spotlessApply with the new settings	2023-01-29 12:03:50 -08:00
Jason Mitchell	4711be8028	[ci skip] Update buildscript to RetroFuturaGradle	2023-01-29 12:03:12 -08:00
miozune	10df035419	Fix BOP Turnip Seeds extracted into 0mB of Seed Oil (#39 ) * Fix BOP Turnip Seeds extracted into 0mB of Seed Oil * Use `GameRegistry#findItemStack`	2022-10-25 19:54:42 +02:00
Jakub	5f622686f3	Fix typo (#38 )	2022-10-21 22:57:06 +02:00
Glease	fce7efd59a	fix potential memory leak (#36 )	2022-10-19 08:50:23 +01:00
Jakub	6158afeb86	Add Jubiliance description (#35 ) * Add Jubilance description * Update GuiBeealyzer.java * Translatable strings	2022-10-16 13:45:10 +02:00