diff --git a/src/api/java/appeng/api/AEAddon.java b/src/api/java/appeng/api/AEAddon.java
index 6722e75ac..f900fcaed 100644
--- a/src/api/java/appeng/api/AEAddon.java
+++ b/src/api/java/appeng/api/AEAddon.java
@@ -18,20 +18,16 @@
package appeng.api;
-import java.lang.annotation.Documented;
-import java.lang.annotation.ElementType;
-import java.lang.annotation.Retention;
-import java.lang.annotation.RetentionPolicy;
-import java.lang.annotation.Target;
+import java.lang.annotation.*;
/**
* Use this annotation on a class in your Mod to have it instantiated during the
* initialization phase of Applied Energistics.
- *
+ *
* The class also needs to implement {@link IAEAddon}.
- *
+ *
* AE expects your class to have a single constructor without any parameters.
- *
+ *
* This is the only way to get access to the public {@link IAppEngApi} instance.
*/
@Target(ElementType.TYPE)
diff --git a/src/api/java/appeng/api/IAEAddon.java b/src/api/java/appeng/api/IAEAddon.java
index 15299e48e..d4cd5549b 100644
--- a/src/api/java/appeng/api/IAEAddon.java
+++ b/src/api/java/appeng/api/IAEAddon.java
@@ -26,19 +26,18 @@ package appeng.api;
/**
* Every AE2 addon requiring access to {@link IAppEngApi}, needs to provide at
* least one class implementing this interface.
- *
+ *
* Further it requires the class to be annotated with {@link AEAddon}.
- *
*/
public interface IAEAddon {
/**
* This gets called once the API is successfully constructed and ready to be
* used.
- *
+ *
* Each addon is responsible to maintain a reference to {@link IAppEngApi} for
* future use. Otherwise there is no alternative to access it later.
- *
+ *
* @param api The API instance when ready.
*/
void onAPIAvailable(IAppEngApi api);
diff --git a/src/api/java/appeng/api/client/ICellModelRegistry.java b/src/api/java/appeng/api/client/ICellModelRegistry.java
index bcd5f35d9..32e52016f 100644
--- a/src/api/java/appeng/api/client/ICellModelRegistry.java
+++ b/src/api/java/appeng/api/client/ICellModelRegistry.java
@@ -39,21 +39,21 @@ public interface ICellModelRegistry {
/**
* Register a new model for a storage cell item.
- *
+ *
*
* You are responsible for ensuring that the given model is actually loaded by
* the game. See
* {@see net.minecraftforge.client.model.ModelLoader#addSpecialModel}.
- *
+ *
* This method only maps an {@link Item} to a {@link Identifier} which can be
* looked up from the
* {@link net.minecraft.client.render.model.BakedModelManager}. No validation
* about missing models will be done.
- *
+ *
* Will throw an exception in case a model is already registered for an item.
- *
+ *
* For examples look at our cell part models within the drive model directory.
- *
+ *
* @param item The cell item
* @param model The {@link net.minecraft.util.Identifier} representing the
* model.
@@ -64,7 +64,7 @@ public interface ICellModelRegistry {
/**
* The {@link Identifier} of the model used to render the given storage cell
* {@link Item} when inserted into a drive or similar.
- *
+ *
* @param item
* @return null, if no model is registered.
*/
@@ -73,7 +73,7 @@ public interface ICellModelRegistry {
/**
* An unmodifiable map of all registered mappings.
- *
+ *
* @return
*/
@Nonnull
diff --git a/src/api/java/appeng/api/client/IClientHelper.java b/src/api/java/appeng/api/client/IClientHelper.java
index 63f4c5205..cc705bac1 100644
--- a/src/api/java/appeng/api/client/IClientHelper.java
+++ b/src/api/java/appeng/api/client/IClientHelper.java
@@ -41,7 +41,7 @@ public interface IClientHelper {
/**
* A helper to work with clientside related tasks for cells.
- *
+ *
* @return
*/
ICellModelRegistry cells();
diff --git a/src/api/java/appeng/api/config/PowerUnits.java b/src/api/java/appeng/api/config/PowerUnits.java
index de515e4af..de760b110 100644
--- a/src/api/java/appeng/api/config/PowerUnits.java
+++ b/src/api/java/appeng/api/config/PowerUnits.java
@@ -46,15 +46,14 @@ public enum PowerUnits {
/**
* do power conversion using AE's conversion rates.
- *
+ *
* will normally returns 64, as it will convert the EU, to AE with AE's power
* settings.
*
* @param target target power unit
* @param value value
- *
* @return value converted to target units, from this units.
*/
public double convertTo(final PowerUnits target, final double value) {
diff --git a/src/api/java/appeng/api/config/Upgrades.java b/src/api/java/appeng/api/config/Upgrades.java
index 458d89bfc..a373836c0 100644
--- a/src/api/java/appeng/api/config/Upgrades.java
+++ b/src/api/java/appeng/api/config/Upgrades.java
@@ -23,11 +23,7 @@
package appeng.api.config;
-import java.util.ArrayList;
-import java.util.Comparator;
-import java.util.HashSet;
-import java.util.List;
-import java.util.Set;
+import java.util.*;
import javax.annotation.Nullable;
diff --git a/src/api/java/appeng/api/definitions/IBlockDefinition.java b/src/api/java/appeng/api/definitions/IBlockDefinition.java
index cf225cef3..74f480369 100644
--- a/src/api/java/appeng/api/definitions/IBlockDefinition.java
+++ b/src/api/java/appeng/api/definitions/IBlockDefinition.java
@@ -49,7 +49,6 @@ public interface IBlockDefinition extends IItemDefinition {
*
* @param world world of block
* @param pos location
- *
* @return if the block is placed in the world at the specific location.
*/
boolean isSameAs(BlockView world, BlockPos pos);
diff --git a/src/api/java/appeng/api/definitions/IComparableDefinition.java b/src/api/java/appeng/api/definitions/IComparableDefinition.java
index cceb460a9..1e197b742 100644
--- a/src/api/java/appeng/api/definitions/IComparableDefinition.java
+++ b/src/api/java/appeng/api/definitions/IComparableDefinition.java
@@ -32,7 +32,6 @@ public interface IComparableDefinition {
* Compare {@link ItemStack} with this
*
* @param comparableStack compared item
- *
* @return true if the item stack is a matching item.
*/
boolean isSameAs(ItemStack comparableStack);
diff --git a/src/api/java/appeng/api/exceptions/ExistingConnectionException.java b/src/api/java/appeng/api/exceptions/ExistingConnectionException.java
index 6115832de..a18b15f2e 100644
--- a/src/api/java/appeng/api/exceptions/ExistingConnectionException.java
+++ b/src/api/java/appeng/api/exceptions/ExistingConnectionException.java
@@ -28,7 +28,7 @@ import appeng.api.networking.IGridNode;
/**
* Exception occurred because of an already existing connection between the two
* {@link IGridNode}s
- *
+ *
* Intended to signal an internal exception and not intended to be thrown by any
* 3rd party module.
*
diff --git a/src/api/java/appeng/api/exceptions/FailedConnectionException.java b/src/api/java/appeng/api/exceptions/FailedConnectionException.java
index 8370c6229..861e18114 100644
--- a/src/api/java/appeng/api/exceptions/FailedConnectionException.java
+++ b/src/api/java/appeng/api/exceptions/FailedConnectionException.java
@@ -27,10 +27,10 @@ import appeng.api.networking.IGridNode;
/**
* Exception indicating a failed connection between two {@link IGridNode}s.
- *
+ *
* Intended to signal an internal exception and not intended to be thrown by any
* 3rd party module.
- *
+ *
* See any subclass for a more specific reason.
*
* @author AlgorithmX2
diff --git a/src/api/java/appeng/api/exceptions/NullNodeConnectionException.java b/src/api/java/appeng/api/exceptions/NullNodeConnectionException.java
index b768c459c..7df1fb3fc 100644
--- a/src/api/java/appeng/api/exceptions/NullNodeConnectionException.java
+++ b/src/api/java/appeng/api/exceptions/NullNodeConnectionException.java
@@ -25,7 +25,7 @@ package appeng.api.exceptions;
/**
* Exception due to trying to connect one or more null values.
- *
+ *
* Intended to signal an internal exception and not intended to be thrown by any
* 3rd party module.
*
diff --git a/src/api/java/appeng/api/exceptions/SecurityConnectionException.java b/src/api/java/appeng/api/exceptions/SecurityConnectionException.java
index ec079e24e..10cbba7fc 100644
--- a/src/api/java/appeng/api/exceptions/SecurityConnectionException.java
+++ b/src/api/java/appeng/api/exceptions/SecurityConnectionException.java
@@ -25,7 +25,7 @@ package appeng.api.exceptions;
/**
* Exception due to trying to connect different security realms.
- *
+ *
* Intended to signal an internal exception and not intended to be thrown by any
* 3rd party module.
*
diff --git a/src/api/java/appeng/api/features/IChargerRegistry.java b/src/api/java/appeng/api/features/IChargerRegistry.java
index 286eea5df..754f5d8eb 100644
--- a/src/api/java/appeng/api/features/IChargerRegistry.java
+++ b/src/api/java/appeng/api/features/IChargerRegistry.java
@@ -33,12 +33,12 @@ import appeng.api.implementations.items.IAEItemPowerStorage;
/**
* A registry to allow mapping {@link Item}s to a specific charge rate when
* being placed inside a charger.
- *
+ *
* The registry is used in favor of an additional method for
* {@link IAEItemPowerStorage} with a fixed value per item. This allows more
* flexibility for other charger like machines to choose their own values when
* needed.
- *
+ *
* There is no guarantee that this is charged per tick, it only represents the
* value per operation. By default this is one charging operation every 10 ticks
* in case of an AE2 charger.
@@ -51,7 +51,7 @@ public interface IChargerRegistry {
/**
* Fetch a charge rate for a specific item.
- *
+ *
* The specific item does not need to have a mapping registered at all. In this
* case it will use a default value of 160 AE.
*
@@ -63,7 +63,7 @@ public interface IChargerRegistry {
/**
* Register a custom charge rate for a specific item.
- *
+ *
* Capped at 16000 to avoid extracting too much energy from a network for each
* operation. This is done silently without any feedback or exception. Further
* the cap is not fixed, it can change at any time in the future should power
@@ -76,7 +76,7 @@ public interface IChargerRegistry {
/**
* Remove the custom rate for a specific item.
- *
+ *
* It will revert to the default value afterwards.
*
* @param item A {@link Item} implementing {@link IAEItemPowerStorage}.
diff --git a/src/api/java/appeng/api/features/IItemComparisonProvider.java b/src/api/java/appeng/api/features/IItemComparisonProvider.java
index f7ab3b0de..d8a315880 100644
--- a/src/api/java/appeng/api/features/IItemComparisonProvider.java
+++ b/src/api/java/appeng/api/features/IItemComparisonProvider.java
@@ -37,7 +37,6 @@ public interface IItemComparisonProvider {
* supplied item.
*
* @param is item
- *
* @return IItemComparison, or null
*/
IItemComparison getComparison(ItemStack is);
@@ -47,7 +46,6 @@ public interface IItemComparisonProvider {
* function. )
*
* @param stack item
- *
* @return true, if getComparison will return a valid IItemComparison Object
*/
boolean canHandle(ItemStack stack);
diff --git a/src/api/java/appeng/api/features/ILocatableRegistry.java b/src/api/java/appeng/api/features/ILocatableRegistry.java
index f87f891d4..cd51c4e58 100644
--- a/src/api/java/appeng/api/features/ILocatableRegistry.java
+++ b/src/api/java/appeng/api/features/ILocatableRegistry.java
@@ -32,7 +32,6 @@ public interface ILocatableRegistry {
* Gets the {@link ILocatable} with the registered serial, if available
*
* @param serial serial
- *
* @return requestedObject, or null, if the object does not exist anymore
*/
ILocatable getLocatableBy(long serial);
diff --git a/src/api/java/appeng/api/features/IMatterCannonAmmoRegistry.java b/src/api/java/appeng/api/features/IMatterCannonAmmoRegistry.java
index cd0406367..1e023c935 100644
--- a/src/api/java/appeng/api/features/IMatterCannonAmmoRegistry.java
+++ b/src/api/java/appeng/api/features/IMatterCannonAmmoRegistry.java
@@ -51,7 +51,6 @@ public interface IMatterCannonAmmoRegistry {
* get the penetration value for a particular ammo, 0 indicates a non-ammo.
*
* @param is ammo
- *
* @return 0 or a valid penetration value.
*/
float getPenetration(ItemStack is);
diff --git a/src/api/java/appeng/api/features/INetworkEncodable.java b/src/api/java/appeng/api/features/INetworkEncodable.java
index 53e9c6463..62d675113 100644
--- a/src/api/java/appeng/api/features/INetworkEncodable.java
+++ b/src/api/java/appeng/api/features/INetworkEncodable.java
@@ -31,7 +31,6 @@ public interface INetworkEncodable {
* Used to get the current key from the item.
*
* @param item item
- *
* @return string key of item
*/
String getEncryptionKey(ItemStack item);
diff --git a/src/api/java/appeng/api/features/IP2PTunnelRegistry.java b/src/api/java/appeng/api/features/IP2PTunnelRegistry.java
index 061e36a86..baca77902 100644
--- a/src/api/java/appeng/api/features/IP2PTunnelRegistry.java
+++ b/src/api/java/appeng/api/features/IP2PTunnelRegistry.java
@@ -55,7 +55,6 @@ public interface IP2PTunnelRegistry {
* returns null if no attunement can be found.
*
* @param trigger attunement trigger
- *
* @return null if no attunement can be found or attunement
*/
@Nonnull
diff --git a/src/api/java/appeng/api/features/IPlayerRegistry.java b/src/api/java/appeng/api/features/IPlayerRegistry.java
index 7bac6ef2b..653828170 100644
--- a/src/api/java/appeng/api/features/IPlayerRegistry.java
+++ b/src/api/java/appeng/api/features/IPlayerRegistry.java
@@ -38,21 +38,18 @@ public interface IPlayerRegistry {
/**
* @param gameProfile user game profile
- *
* @return user id of a username.
*/
int getID(GameProfile gameProfile);
/**
* @param player player
- *
* @return user id of a player entity.
*/
int getID(PlayerEntity player);
/**
* @param playerID to be found player id
- *
* @return PlayerEntity, or null if the player could not be found.
*/
@Nullable
diff --git a/src/api/java/appeng/api/features/IWirelessTermHandler.java b/src/api/java/appeng/api/features/IWirelessTermHandler.java
index 033f239d5..b4083fba8 100644
--- a/src/api/java/appeng/api/features/IWirelessTermHandler.java
+++ b/src/api/java/appeng/api/features/IWirelessTermHandler.java
@@ -35,7 +35,6 @@ public interface IWirelessTermHandler extends INetworkEncodable {
/**
* @param is wireless terminal
- *
* @return true, if usePower, hasPower, etc... can be called for the provided
* item
*/
@@ -47,7 +46,6 @@ public interface IWirelessTermHandler extends INetworkEncodable {
* @param amount is in AE units ( 5 per MJ ), if you return false, the item
* should be dead and return false for hasPower
* @param is wireless terminal
- *
* @return true if wireless terminal uses power
*/
boolean usePower(PlayerEntity player, double amount, ItemStack is);
@@ -56,7 +54,6 @@ public interface IWirelessTermHandler extends INetworkEncodable {
* gets the power status of the item.
*
* @param is wireless terminal
- *
* @return returns true if there is any power left.
*/
boolean hasPower(PlayerEntity player, double amount, ItemStack is);
@@ -65,7 +62,6 @@ public interface IWirelessTermHandler extends INetworkEncodable {
* Return the config manager for the wireless terminal.
*
* @param is wireless terminal
- *
* @return config manager of wireless terminal
*/
IConfigManager getConfigManager(ItemStack is);
diff --git a/src/api/java/appeng/api/features/IWirelessTermRegistry.java b/src/api/java/appeng/api/features/IWirelessTermRegistry.java
index 10f3fba1d..a69cae322 100644
--- a/src/api/java/appeng/api/features/IWirelessTermRegistry.java
+++ b/src/api/java/appeng/api/features/IWirelessTermRegistry.java
@@ -42,7 +42,6 @@ public interface IWirelessTermRegistry {
/**
* @param is item which might have a handler
- *
* @return true if there is a handler for this item
*/
boolean isWirelessTerminal(ItemStack is);
diff --git a/src/api/java/appeng/api/features/IWorldGen.java b/src/api/java/appeng/api/features/IWorldGen.java
index 512b64a0b..ced2d43ea 100644
--- a/src/api/java/appeng/api/features/IWorldGen.java
+++ b/src/api/java/appeng/api/features/IWorldGen.java
@@ -25,7 +25,6 @@ package appeng.api.features;
import net.minecraft.server.world.ServerWorld;
import net.minecraft.util.Identifier;
-import net.minecraft.world.ServerWorldAccess;
public interface IWorldGen {
diff --git a/src/api/java/appeng/api/implementations/guiobjects/IGuiItem.java b/src/api/java/appeng/api/implementations/guiobjects/IGuiItem.java
index 711285f58..cb411601e 100644
--- a/src/api/java/appeng/api/implementations/guiobjects/IGuiItem.java
+++ b/src/api/java/appeng/api/implementations/guiobjects/IGuiItem.java
@@ -35,7 +35,6 @@ import net.minecraft.world.World;
*/
public interface IGuiItem {
/**
- *
* @param is The item used to open the container.
* @param playerInventorySlot The slot in the player's inventory the item is in.
* @param world The world the player is in.
diff --git a/src/api/java/appeng/api/implementations/items/IAEItemPowerStorage.java b/src/api/java/appeng/api/implementations/items/IAEItemPowerStorage.java
index cfc3f62f4..fd8239819 100644
--- a/src/api/java/appeng/api/implementations/items/IAEItemPowerStorage.java
+++ b/src/api/java/appeng/api/implementations/items/IAEItemPowerStorage.java
@@ -46,7 +46,6 @@ public interface IAEItemPowerStorage {
* return it.
*
* @param amount to be extracted power from device
- *
* @return what it could extract
*/
double extractAEPower(ItemStack stack, double amount, Actionable mode);
diff --git a/src/api/java/appeng/api/implementations/items/IAEWrench.java b/src/api/java/appeng/api/implementations/items/IAEWrench.java
index dc49c7654..fa4049336 100644
--- a/src/api/java/appeng/api/implementations/items/IAEWrench.java
+++ b/src/api/java/appeng/api/implementations/items/IAEWrench.java
@@ -38,7 +38,6 @@ public interface IAEWrench {
*
* @param player wrenching player
* @param pos of block.
- *
* @return true if wrench can be used
*/
boolean canWrench(ItemStack wrench, PlayerEntity player, BlockPos pos);
diff --git a/src/api/java/appeng/api/implementations/items/IBiometricCard.java b/src/api/java/appeng/api/implementations/items/IBiometricCard.java
index 481f798a7..567a34ad6 100644
--- a/src/api/java/appeng/api/implementations/items/IBiometricCard.java
+++ b/src/api/java/appeng/api/implementations/items/IBiometricCard.java
@@ -48,7 +48,6 @@ public interface IBiometricCard {
/**
* @param itemStack card
- *
* @return the full list of permissions encoded on the card.
*/
EnumSet getPermissions(ItemStack itemStack);
@@ -57,7 +56,6 @@ public interface IBiometricCard {
* Check if a permission is encoded on the card.
*
* @param permission card
- *
* @return true if this permission is set on the card.
*/
boolean hasPermission(ItemStack is, SecurityPermissions permission);
diff --git a/src/api/java/appeng/api/implementations/items/IMemoryCard.java b/src/api/java/appeng/api/implementations/items/IMemoryCard.java
index ed1529716..1e5d50f22 100644
--- a/src/api/java/appeng/api/implementations/items/IMemoryCard.java
+++ b/src/api/java/appeng/api/implementations/items/IMemoryCard.java
@@ -31,7 +31,7 @@ import appeng.api.util.AEColor;
/**
* Memory Card API
- *
+ *
* AE's Memory Card Item Class implements this interface.
*/
public interface IMemoryCard {
@@ -39,10 +39,10 @@ public interface IMemoryCard {
/**
* Configures the data stored on the memory card, the SettingsName, will be
* localized when displayed.
- *
+ *
* The data can contain an optional string with the key "tooltip", which will be
* used as unlocalized string to display it after the settings name.
- *
+ *
* The data can contain an optional intArray using "colorCode" to be displayed
* on the model itself. It needs to have exactly 8 elements representing the
* ordinal of the matching {@link AEColor}. The first 4 values represent the top
@@ -61,14 +61,12 @@ public interface IMemoryCard {
* call to setMemoryCardContents.
*
* @param is item
- *
* @return setting name
*/
String getSettingsName(ItemStack is);
/**
* @param is item
- *
* @return the NBT Data previously saved by setMemoryCardContents, or an empty
* NBTCompound
*/
@@ -77,11 +75,10 @@ public interface IMemoryCard {
/**
* This represent as 4x2 grid of {@link AEColor} without transparent/fluix
* color.
- *
+ *
* First 4 colors are used for the top row, second for the bottom one.
*
* @param is item
- *
* @return a hash representation of the memory card content
*/
AEColor[] getColorCode(ItemStack is);
diff --git a/src/api/java/appeng/api/implementations/items/ISpatialStorageCell.java b/src/api/java/appeng/api/implementations/items/ISpatialStorageCell.java
index f2bf77893..26d774339 100644
--- a/src/api/java/appeng/api/implementations/items/ISpatialStorageCell.java
+++ b/src/api/java/appeng/api/implementations/items/ISpatialStorageCell.java
@@ -26,9 +26,6 @@ package appeng.api.implementations.items;
import net.minecraft.item.Item;
import net.minecraft.item.ItemStack;
import net.minecraft.server.world.ServerWorld;
-import net.minecraft.util.registry.RegistryKey;
-import net.minecraft.world.World;
-import net.minecraft.world.dimension.DimensionType;
import appeng.api.util.WorldCoord;
@@ -39,14 +36,12 @@ public interface ISpatialStorageCell {
/**
* @param is spatial storage cell
- *
* @return true if this item is a spatial storage cell
*/
boolean isSpatialStorage(ItemStack is);
/**
* @param is spatial storage cell
- *
* @return the maximum size of the spatial storage cell along any given axis
*/
int getMaxStoredDim(ItemStack is);
@@ -55,7 +50,6 @@ public interface ISpatialStorageCell {
* get the currently stored spatial storage plot id.
*
* @param is spatial storage cell
- *
* @return plot id or -1
*/
int getAllocatedPlotId(ItemStack is);
@@ -68,7 +62,6 @@ public interface ISpatialStorageCell {
* @param min min coord
* @param max max coord
* @param playerId owner of current grid or -1
- *
* @return success of transition
*/
boolean doSpatialTransition(ItemStack is, ServerWorld w, WorldCoord min, WorldCoord max, int playerId);
diff --git a/src/api/java/appeng/api/implementations/items/IStorageCell.java b/src/api/java/appeng/api/implementations/items/IStorageCell.java
index 560d032fa..5a70e467f 100644
--- a/src/api/java/appeng/api/implementations/items/IStorageCell.java
+++ b/src/api/java/appeng/api/implementations/items/IStorageCell.java
@@ -38,14 +38,14 @@ import appeng.api.storage.data.IAEStack;
* {@link ICellHandler#getCellInventory(ItemStack, appeng.api.storage.cells.ISaveProvider, IStorageChannel)}
* or {@link ICellHandler#isCell(ItemStack)}. It automatically handles the
* internals and NBT data, which is both nice, and bad for you!
- *
+ *
* Good cause it means you don't have to do anything, bad because you have
* little to no control over it.
- *
+ *
* Limited to {@link Integer} internally for most calculations. E.g. if the used
* or remaining bytes would overflow {@link Integer#MAX_VALUE} the behaviour is
* no longer specified. Even if {@link ICellInventory} is using {@link Long}.
- *
+ *
* The standard AE implementation also only provides 1-63 Types.
*/
public interface IStorageCell> extends ICellWorkbenchItem {
@@ -55,7 +55,6 @@ public interface IStorageCell> extends ICellWorkbenchItem
* ({@link Integer#MAX_VALUE} + 1) / 8.
*
* @param cellItem item
- *
* @return number of bytes
*/
int getBytes(@Nonnull ItemStack cellItem);
@@ -64,7 +63,6 @@ public interface IStorageCell> extends ICellWorkbenchItem
* Determines the number of bytes used for any type included on the cell.
*
* @param cellItem item
- *
* @return number of bytes
*/
int getBytesPerType(@Nonnull ItemStack cellItem);
@@ -74,7 +72,6 @@ public interface IStorageCell> extends ICellWorkbenchItem
* item.
*
* @param cellItem item
- *
* @return number of types
*/
int getTotalTypes(@Nonnull ItemStack cellItem);
@@ -86,7 +83,6 @@ public interface IStorageCell> extends ICellWorkbenchItem
*
* @param cellItem item
* @param requestedAddition requested addition
- *
* @return true to preventAdditionOfItem
*/
boolean isBlackListed(@Nonnull ItemStack cellItem, @Nonnull T requestedAddition);
@@ -106,7 +102,6 @@ public interface IStorageCell> extends ICellWorkbenchItem
* Allows an item to selectively enable or disable its status as a storage cell.
*
* @param i item
- *
* @return if the ItemStack should behavior as a storage cell.
*/
boolean isStorageCell(@Nonnull ItemStack i);
diff --git a/src/api/java/appeng/api/implementations/items/IStorageComponent.java b/src/api/java/appeng/api/implementations/items/IStorageComponent.java
index a790e86d6..b09bee4e9 100644
--- a/src/api/java/appeng/api/implementations/items/IStorageComponent.java
+++ b/src/api/java/appeng/api/implementations/items/IStorageComponent.java
@@ -37,7 +37,6 @@ public interface IStorageComponent {
* condenser.
*
* @param is item
- *
* @return number of bytes
*/
int getBytes(ItemStack is);
@@ -46,7 +45,6 @@ public interface IStorageComponent {
* Just true or false for the item stack.
*
* @param is item
- *
* @return true if item is a storage component
*/
boolean isStorageComponent(ItemStack is);
diff --git a/src/api/java/appeng/api/implementations/items/IUpgradeModule.java b/src/api/java/appeng/api/implementations/items/IUpgradeModule.java
index afc90572e..51e95e6e5 100644
--- a/src/api/java/appeng/api/implementations/items/IUpgradeModule.java
+++ b/src/api/java/appeng/api/implementations/items/IUpgradeModule.java
@@ -31,7 +31,6 @@ public interface IUpgradeModule {
/**
* @param itemstack item with potential upgrades
- *
* @return null, or a valid upgrade type.
*/
Upgrades getType(ItemStack itemstack);
diff --git a/src/api/java/appeng/api/implementations/parts/ICablePart.java b/src/api/java/appeng/api/implementations/parts/ICablePart.java
index ec5c70d8d..98fe74ded 100644
--- a/src/api/java/appeng/api/implementations/parts/ICablePart.java
+++ b/src/api/java/appeng/api/implementations/parts/ICablePart.java
@@ -62,14 +62,13 @@ public interface ICablePart extends IPart, IGridHost {
* something.
*
* @param newColor new color
- *
* @return if the color change was successful.
*/
boolean changeColor(AEColor newColor, PlayerEntity who);
/**
* Change sides on the cables node.
- *
+ *
* Called by AE, do not invoke.
*
* @param sides sides of cable
@@ -80,7 +79,6 @@ public interface ICablePart extends IPart, IGridHost {
* used to tests if a cable connects to neighbors visually.
*
* @param side neighbor side
- *
* @return true if this side is currently connects to an external block.
*/
boolean isConnected(Direction side);
diff --git a/src/api/java/appeng/api/implementations/tiles/IChestOrDrive.java b/src/api/java/appeng/api/implementations/tiles/IChestOrDrive.java
index d9555c1c4..f0868935f 100644
--- a/src/api/java/appeng/api/implementations/tiles/IChestOrDrive.java
+++ b/src/api/java/appeng/api/implementations/tiles/IChestOrDrive.java
@@ -41,7 +41,6 @@ public interface IChestOrDrive extends ICellContainer, IGridHost, IOrientable {
/**
* @param slot slot index
- *
* @return status of the slot, one of the above indices.
*/
CellState getCellStatus(int slot);
@@ -54,7 +53,6 @@ public interface IChestOrDrive extends ICellContainer, IGridHost, IOrientable {
/**
* @param slot slot index
- *
* @return is the cell currently blinking to show activity.
*/
boolean isCellBlinking(int slot);
diff --git a/src/api/java/appeng/api/implementations/tiles/ICraftingMachine.java b/src/api/java/appeng/api/implementations/tiles/ICraftingMachine.java
index 881b9db02..fdbd972c7 100644
--- a/src/api/java/appeng/api/implementations/tiles/ICraftingMachine.java
+++ b/src/api/java/appeng/api/implementations/tiles/ICraftingMachine.java
@@ -36,7 +36,6 @@ public interface ICraftingMachine {
* @param patternDetails details of pattern
* @param table crafting table
* @param ejectionDirection ejection direction
- *
* @return if it was accepted, all or nothing.
*/
boolean pushPattern(ICraftingPatternDetails patternDetails, CraftingInventory table, Direction ejectionDirection);
diff --git a/src/api/java/appeng/api/implementations/tiles/ICrankable.java b/src/api/java/appeng/api/implementations/tiles/ICrankable.java
index f3390f1b4..30336fac1 100644
--- a/src/api/java/appeng/api/implementations/tiles/ICrankable.java
+++ b/src/api/java/appeng/api/implementations/tiles/ICrankable.java
@@ -27,12 +27,12 @@ import net.minecraft.util.math.Direction;
/**
* Crank/Crankable API,
- *
+ *
* Tiles that Implement this can receive power, from the crank, and have the
* crank placed on them.
- *
+ *
* Tiles that access other tiles that implement this method can act as Cranks.
- *
+ *
* This interface must be implemented by a block entity.
*/
public interface ICrankable {
diff --git a/src/api/java/appeng/api/implementations/tiles/ISegmentedInventory.java b/src/api/java/appeng/api/implementations/tiles/ISegmentedInventory.java
index 2acafd03f..d9355c5cc 100644
--- a/src/api/java/appeng/api/implementations/tiles/ISegmentedInventory.java
+++ b/src/api/java/appeng/api/implementations/tiles/ISegmentedInventory.java
@@ -33,7 +33,6 @@ public interface ISegmentedInventory {
* duplication.
*
* @param name inventory name
- *
* @return inventory with inventory name
*/
FixedItemInv getInventoryByName(String name);
diff --git a/src/api/java/appeng/api/movable/IMovableHandler.java b/src/api/java/appeng/api/movable/IMovableHandler.java
index 95876184b..c21d8b7ee 100644
--- a/src/api/java/appeng/api/movable/IMovableHandler.java
+++ b/src/api/java/appeng/api/movable/IMovableHandler.java
@@ -35,7 +35,6 @@ public interface IMovableHandler {
*
* @param myClass block entity class
* @param tile block entity
- *
* @return true if it can handle moving
*/
boolean canHandle(Class myClass, BlockEntity tile);
@@ -44,7 +43,7 @@ public interface IMovableHandler {
* request that the handler move the the tile from its current location to the
* new one. the tile has already been invalidated, and the blocks have already
* been fully moved.
- *
+ *
* Potential Example:
*
*
diff --git a/src/api/java/appeng/api/movable/IMovableRegistry.java b/src/api/java/appeng/api/movable/IMovableRegistry.java
index f6acdb70a..c08f84054 100644
--- a/src/api/java/appeng/api/movable/IMovableRegistry.java
+++ b/src/api/java/appeng/api/movable/IMovableRegistry.java
@@ -29,32 +29,32 @@ import net.minecraft.block.entity.BlockEntity;
/**
* Used to determine if a tile is marked as movable, a block will be considered
* movable, if...
- *
+ *
* 1. The Tile or its super classes have been white listed with
* whiteListTileEntity.
- *
+ *
* 2. The Tile implements IMovableTile
- *
+ *
* 3. A IMovableHandler is register that returns canHandle = true for the
* {@link BlockEntity} subclass
- *
- *
+ *
+ *
* The movement process is as follows,
- *
+ *
* 1. IMovableTile.prepareToMove() or TileEntity.invalidate() depending on your
* opt-in method. 2. The tile will be removed from the world. 3. Its world,
* coordinates will be changed. *** this can be overridden with a
* IMovableHandler *** 4. It will then be re-added to the world, or a new world.
* 5. TileEntity.cancelRemoval() 6. IMovableTile.doneMoving ( if you implemented
* IMovableTile )
- *
+ *
* Please note, this is a 100% white list only feature, I will never opt in any
* non-vanilla, non-AE blocks. If you do not want to support your tiles being
* moved, you don't have to do anything.
- *
+ *
* I appreciate anyone that takes the effort to get their tiles to work with
* this system to create a better use experience.
- *
+ *
* If you need a build of deobf build of AE for testing, do not hesitate to ask.
*/
public interface IMovableRegistry {
@@ -68,7 +68,7 @@ public interface IMovableRegistry {
/**
* White list your block entity with the registry.
- *
+ *
* If you tile is handled with IMovableHandler or IMovableTile you do not need
* to white list it.
*/
@@ -76,7 +76,6 @@ public interface IMovableRegistry {
/**
* @param te to be moved block entity
- *
* @return true if the tile has accepted your request to move it
*/
boolean askToMove(BlockEntity te);
@@ -98,11 +97,10 @@ public interface IMovableRegistry {
/**
* handlers are used to perform movement, this allows you to override AE's
* internal version.
- *
+ *
* only valid after askToMove(...) = true
*
* @param te block entity
- *
* @return moving handler of block entity
*/
IMovableHandler getHandler(BlockEntity te);
@@ -114,7 +112,6 @@ public interface IMovableRegistry {
/**
* @param blk block
- *
* @return true if this block is blacklisted
*/
boolean isBlacklisted(Block blk);
diff --git a/src/api/java/appeng/api/networking/IGrid.java b/src/api/java/appeng/api/networking/IGrid.java
index 744bdca20..b3af57a82 100644
--- a/src/api/java/appeng/api/networking/IGrid.java
+++ b/src/api/java/appeng/api/networking/IGrid.java
@@ -30,7 +30,7 @@ import appeng.api.util.IReadOnlyCollection;
/**
* Gives you access to Grid based information.
- *
+ *
* Don't Implement.
*/
public interface IGrid {
@@ -39,7 +39,6 @@ public interface IGrid {
* Get Access to various grid modules
*
* @param iface face
- *
* @return the IGridCache you requested.
*/
@Nonnull
@@ -49,7 +48,6 @@ public interface IGrid {
* Post an event into the network event bus.
*
* @param ev - event to post
- *
* @return returns ev back to original poster
*/
@Nonnull
@@ -59,7 +57,6 @@ public interface IGrid {
* Post an event into the network event bus, but direct it at a single node.
*
* @param ev event to post
- *
* @return returns ev back to original poster
*/
@Nonnull
@@ -79,7 +76,6 @@ public interface IGrid {
* Get machines on the network.
*
* @param gridHostClass class of the grid host
- *
* @return IMachineSet of all nodes belonging to hosts of specified class.
*/
@Nonnull
diff --git a/src/api/java/appeng/api/networking/IGridBlock.java b/src/api/java/appeng/api/networking/IGridBlock.java
index 2a500847b..ab352a290 100644
--- a/src/api/java/appeng/api/networking/IGridBlock.java
+++ b/src/api/java/appeng/api/networking/IGridBlock.java
@@ -37,14 +37,14 @@ import appeng.api.util.DimensionalCoord;
/**
* An Implementation is required to create your node for IGridHost
- *
+ *
* Implement for use with IGridHost
*/
public interface IGridBlock {
/**
* how much power to drain per tick as part of idle network usage.
- *
+ *
* if the value of this changes, you must post a MENetworkPowerIdleChange
*
* @return ae/t to use.
diff --git a/src/api/java/appeng/api/networking/IGridCache.java b/src/api/java/appeng/api/networking/IGridCache.java
index 4020fa726..ac786289b 100644
--- a/src/api/java/appeng/api/networking/IGridCache.java
+++ b/src/api/java/appeng/api/networking/IGridCache.java
@@ -28,7 +28,7 @@ import javax.annotation.Nonnull;
/**
* Allows you to create a network wide service, AE2 uses these for providing
* item, spatial, and tunnel services.
- *
+ *
* Any Class that implements this, should have a public default constructor that
* takes a single argument of type IGrid.
*/
@@ -42,7 +42,7 @@ public interface IGridCache {
/**
* inform your cache, that a machine was removed from the grid.
- *
+ *
* Important: Do not trust the grids state in this method, interact only with
* the node you are passed, if you need to manage other grid information, do it
* on the next updateTick.
@@ -54,7 +54,7 @@ public interface IGridCache {
/**
* informs you cache that a machine was added to the grid.
- *
+ *
* Important: Do not trust the grids state in this method, interact only with
* the node you are passed, if you need to manage other grid information, do it
* on the next updateTick.
diff --git a/src/api/java/appeng/api/networking/IGridCacheRegistry.java b/src/api/java/appeng/api/networking/IGridCacheRegistry.java
index 6c6cadb8a..fd5ea311d 100644
--- a/src/api/java/appeng/api/networking/IGridCacheRegistry.java
+++ b/src/api/java/appeng/api/networking/IGridCacheRegistry.java
@@ -45,7 +45,6 @@ public interface IGridCacheRegistry {
* requests a new INSTANCE of a grid cache for use, used internally
*
* @param grid grid
- *
* @return a new Map of IGridCaches from the registry, called from IGrid when
* constructing a new grid.
*/
diff --git a/src/api/java/appeng/api/networking/IGridConnection.java b/src/api/java/appeng/api/networking/IGridConnection.java
index 892412e4c..f75fc7ed9 100644
--- a/src/api/java/appeng/api/networking/IGridConnection.java
+++ b/src/api/java/appeng/api/networking/IGridConnection.java
@@ -29,10 +29,10 @@ import appeng.api.util.AEPartLocation;
/**
* Access to AE's internal grid connections.
- *
+ *
* Messing with connection is generally completely unnecessary, you should be
* able to just use IGridNode.updateState() to have AE manage them for you.
- *
+ *
* Don't Implement.
*/
public interface IGridConnection {
@@ -41,7 +41,6 @@ public interface IGridConnection {
* lets you get the opposing node of the connection by passing your own node.
*
* @param gridNode current grid node
- *
* @return the IGridNode which represents the opposite side of the connection.
*/
@Nonnull
@@ -51,7 +50,6 @@ public interface IGridConnection {
* determine the direction of the connection based on your node.
*
* @param gridNode current grid node
- *
* @return the direction of the connection, only valid for in world connections.
*/
@Nonnull
diff --git a/src/api/java/appeng/api/networking/IGridHelper.java b/src/api/java/appeng/api/networking/IGridHelper.java
index 31e9aacd0..50bd00ba8 100644
--- a/src/api/java/appeng/api/networking/IGridHelper.java
+++ b/src/api/java/appeng/api/networking/IGridHelper.java
@@ -39,12 +39,11 @@ public interface IGridHelper {
/**
* Create a grid node for your {@link IGridHost}
- *
+ *
* The passed {@link IGridBlock} represents the definition for properties like
* connectable sides. Refer to its documentation for further details.
*
* @param block grid block
- *
* @return grid node of block
*/
@Nonnull
@@ -52,13 +51,12 @@ public interface IGridHelper {
/**
* Create a direct connection between two {@link IGridNode}.
- *
+ *
* This will be considered as having a distance of 1, regardless of the location
* of both nodes.
*
* @param a to be connected gridnode
* @param b to be connected gridnode
- *
* @throws appeng.api.exceptions.FailedConnectionException
*/
@Nonnull
diff --git a/src/api/java/appeng/api/networking/IGridHost.java b/src/api/java/appeng/api/networking/IGridHost.java
index 441f50882..615ad3e9f 100644
--- a/src/api/java/appeng/api/networking/IGridHost.java
+++ b/src/api/java/appeng/api/networking/IGridHost.java
@@ -45,7 +45,6 @@ public interface IGridHost {
*
* @param dir feel free to ignore this, most blocks will use the same node for
* every side.
- *
* @return a new IGridNode, create these with AEApi.INSTANCE().createGridNode(
* MyIGridBlock )
*/
diff --git a/src/api/java/appeng/api/networking/IGridNode.java b/src/api/java/appeng/api/networking/IGridNode.java
index 986384a9a..28caeda7e 100644
--- a/src/api/java/appeng/api/networking/IGridNode.java
+++ b/src/api/java/appeng/api/networking/IGridNode.java
@@ -36,9 +36,9 @@ import appeng.api.util.IReadOnlyCollection;
/**
* Gives you a view into your Nodes connections and information.
- *
+ *
* updateState, getGrid, destroy are required to implement a proper IGridHost.
- *
+ *
* Don't Implement; Acquire from {@link IAppEngApi}.createGridNode
*/
public interface IGridNode {
@@ -54,10 +54,10 @@ public interface IGridNode {
/**
* inform the node that your IGridBlock has changed its internal state, and
* force the node to update.
- *
+ *
* ALWAYS make sure that your block entity is in the world, and has its node
* properly saved to be returned from the host before updating state,
- *
+ *
* If your entity is not in the world, or if you IGridHost returns a different
* node for the same side you will likely crash the game.
*/
@@ -124,7 +124,7 @@ public interface IGridNode {
* this should be called for each node you create, if you have a nodeData
* compound to load from, you can store all your nods on a single compound using
* name.
- *
+ *
* Important: You must call this before updateState.
*
* @param name nbt name
@@ -152,7 +152,6 @@ public interface IGridNode {
* see if this node has a certain flag
*
* @param flag flags
- *
* @return true if has flag
*/
boolean hasFlag(@Nonnull GridFlags flag);
diff --git a/src/api/java/appeng/api/networking/IGridVisitor.java b/src/api/java/appeng/api/networking/IGridVisitor.java
index 37d887ced..1f058fc9e 100644
--- a/src/api/java/appeng/api/networking/IGridVisitor.java
+++ b/src/api/java/appeng/api/networking/IGridVisitor.java
@@ -32,12 +32,11 @@ public interface IGridVisitor {
/**
* Called for each node on the network.
- *
+ *
* By returning false your informing the host to stop visiting nodes beyond the
* current node.
*
* @param n the current node.
- *
* @return true to continue visiting nodes beyond this node.
*/
boolean visitNode(@Nonnull IGridNode n);
diff --git a/src/api/java/appeng/api/networking/crafting/ICraftingGrid.java b/src/api/java/appeng/api/networking/crafting/ICraftingGrid.java
index 16198f1ce..36c1467ce 100644
--- a/src/api/java/appeng/api/networking/crafting/ICraftingGrid.java
+++ b/src/api/java/appeng/api/networking/crafting/ICraftingGrid.java
@@ -42,7 +42,6 @@ public interface ICraftingGrid extends IGridCache {
* @param world crafting world
* @param slot slot index
* @param details pattern details
- *
* @return a collection of crafting patterns for the item in question.
*/
ImmutableCollection getCraftingFor(IAEItemStack whatToCraft,
@@ -56,7 +55,6 @@ public interface ICraftingGrid extends IGridCache {
* @param actionSrc source
* @param craftWhat result
* @param callback callback -- optional
- *
* @return a future which will at an undetermined point in the future get you
* the {@link ICraftingJob} do not wait on this, your be waiting
* forever.
@@ -79,7 +77,6 @@ public interface ICraftingGrid extends IGridCache {
* this will be used for extracting items, should
* usually be the same as the one provided to
* beginCraftingJob.
- *
* @return null ( if failed ) or an {@link ICraftingLink} other wise, if you
* send requestingMachine you need to properly keep track of this and
* handle the nbt saving and loading of the object as well as the
@@ -96,7 +93,6 @@ public interface ICraftingGrid extends IGridCache {
/**
* @param what to be requested item
- *
* @return true if the item can be requested via a crafting emitter.
*/
boolean canEmitFor(IAEItemStack what);
@@ -105,7 +101,6 @@ public interface ICraftingGrid extends IGridCache {
* is this item being crafted?
*
* @param what item being crafted
- *
* @return true if it is being crafting
*/
boolean isRequesting(IAEItemStack what);
@@ -114,7 +109,6 @@ public interface ICraftingGrid extends IGridCache {
* The total amount being requested across all crafting cpus of a grid.
*
* @param what item being requested, ignores stacksize
- *
* @return The total amount being requested.
*/
long requesting(IAEItemStack what);
diff --git a/src/api/java/appeng/api/networking/crafting/ICraftingMedium.java b/src/api/java/appeng/api/networking/crafting/ICraftingMedium.java
index d6bd9ecec..6c6cc5056 100644
--- a/src/api/java/appeng/api/networking/crafting/ICraftingMedium.java
+++ b/src/api/java/appeng/api/networking/crafting/ICraftingMedium.java
@@ -37,7 +37,6 @@ public interface ICraftingMedium {
*
* @param patternDetails details
* @param table crafting table
- *
* @return if the pattern was successfully pushed.
*/
boolean pushPattern(ICraftingPatternDetails patternDetails, CraftingInventory table);
diff --git a/src/api/java/appeng/api/networking/crafting/ICraftingPatternDetails.java b/src/api/java/appeng/api/networking/crafting/ICraftingPatternDetails.java
index 8a82fa609..c63bb8d0d 100644
--- a/src/api/java/appeng/api/networking/crafting/ICraftingPatternDetails.java
+++ b/src/api/java/appeng/api/networking/crafting/ICraftingPatternDetails.java
@@ -49,7 +49,6 @@ public interface ICraftingPatternDetails {
* @param slotIndex specific slot index
* @param itemStack item in slot
* @param world crafting world
- *
* @return if an item can be used in the specific slot for this pattern.
*/
boolean isValidItemForSlot(int slotIndex, ItemStack itemStack, World world);
@@ -70,7 +69,7 @@ public interface ICraftingPatternDetails {
* The list will be sorted in descending order by stack size. However there is
* no guarantee about maintaining the placement order of the inputs in case of
* equal values.
- *
+ *
* @return an immutable list of inputs without nulls
*/
List getInputs();
@@ -81,11 +80,11 @@ public interface ICraftingPatternDetails {
*
* This should be the preferred way to deal with the list of outputs.
*
- *
+ *
* The list will be sorted in descending order by stack size. However there is
* no guarantee about maintaining the placement order of the outputs in case of
* equal values.
- *
+ *
* @return an immutable list of outputs without nulls
*/
List getOutputs();
@@ -101,7 +100,7 @@ public interface ICraftingPatternDetails {
*
* This can return a copy from the internal structure, so there are no
* guarantees about modifications.
- *
+ *
* @return a list of the inputs, will include nulls.
*/
IAEItemStack[] getSparseInputs();
@@ -117,7 +116,7 @@ public interface ICraftingPatternDetails {
*
* This can return a copy from the internal structure, so there are no
* guarantees about modifications.
- *
+ *
* @return a list of the outputs, will include nulls.
*/
IAEItemStack[] getSparseOutputs();
@@ -133,7 +132,6 @@ public interface ICraftingPatternDetails {
*
* @param craftingInv inventory
* @param world crafting world
- *
* @return the crafted ( work bench ) item.
*/
ItemStack getOutput(CraftingInventory craftingInv, World world);
diff --git a/src/api/java/appeng/api/networking/crafting/ICraftingProviderHelper.java b/src/api/java/appeng/api/networking/crafting/ICraftingProviderHelper.java
index 1c7e6c4cc..ea73a9d53 100644
--- a/src/api/java/appeng/api/networking/crafting/ICraftingProviderHelper.java
+++ b/src/api/java/appeng/api/networking/crafting/ICraftingProviderHelper.java
@@ -34,7 +34,7 @@ public interface ICraftingProviderHelper {
/**
* Add new Pattern to AE's crafting cache.
- *
+ *
* This will only accept instances created by
* {@link ICraftingHelper#decodePattern(net.minecraft.item.ItemStack, net.minecraft.world.World)}
*/
diff --git a/src/api/java/appeng/api/networking/crafting/ICraftingRequester.java b/src/api/java/appeng/api/networking/crafting/ICraftingRequester.java
index f970161ad..ffb3542bc 100644
--- a/src/api/java/appeng/api/networking/crafting/ICraftingRequester.java
+++ b/src/api/java/appeng/api/networking/crafting/ICraftingRequester.java
@@ -45,7 +45,6 @@ public interface ICraftingRequester extends IActionHost {
*
* @param items item
* @param mode action mode
- *
* @return unwanted item
*/
IAEItemStack injectCraftedItems(ICraftingLink link, IAEItemStack items, Actionable mode);
@@ -53,7 +52,7 @@ public interface ICraftingRequester extends IActionHost {
/**
* called when the job changes from in progress, to either complete, or
* canceled.
- *
+ *
* after this call the crafting link is "dead" and should be discarded.
*/
void jobStateChange(ICraftingLink link);
diff --git a/src/api/java/appeng/api/networking/crafting/ICraftingWatcher.java b/src/api/java/appeng/api/networking/crafting/ICraftingWatcher.java
index b4c6c680d..2837d3e41 100644
--- a/src/api/java/appeng/api/networking/crafting/ICraftingWatcher.java
+++ b/src/api/java/appeng/api/networking/crafting/ICraftingWatcher.java
@@ -27,13 +27,13 @@ import appeng.api.storage.data.IAEStack;
/**
* DO NOT IMPLEMENT.
- *
+ *
* Will be injected when adding an {@link ICraftingWatcherHost} to a grid.
*/
public interface ICraftingWatcher {
/**
* Add a specific {@link IAEStack} to watch.
- *
+ *
* Supports multiple values, duplicate ones will not be added.
*
* @param stack
diff --git a/src/api/java/appeng/api/networking/energy/IAEPowerStorage.java b/src/api/java/appeng/api/networking/energy/IAEPowerStorage.java
index 8917516bf..3a5c6b0f3 100644
--- a/src/api/java/appeng/api/networking/energy/IAEPowerStorage.java
+++ b/src/api/java/appeng/api/networking/energy/IAEPowerStorage.java
@@ -41,7 +41,6 @@ public interface IAEPowerStorage extends IEnergySource {
*
* @param amt to be injected amount
* @param mode action mode
- *
* @return amount of power which was unable to be stored
*/
double injectAEPower(double amt, @Nonnull Actionable mode);
@@ -75,16 +74,16 @@ public interface IAEPowerStorage extends IEnergySource {
/**
* The priority to use this energy storage.
- *
+ *
* A higher value means it is more likely to be extracted from first, and less
* likely to be inserted into first.
- *
+ *
* The value needs to be constant once added to a {@link IGrid}. Should it ever
* need to be changed, it has to be removed from the grid, then update the
* value, and finally added back to the grid.
- *
+ *
* This should never use {@link Integer#MIN_VALUE} or {@link Integer#MAX_VALUE}.
- *
+ *
* @return the priority for this storage
*/
default int getPriority() {
diff --git a/src/api/java/appeng/api/networking/energy/IEnergyGrid.java b/src/api/java/appeng/api/networking/energy/IEnergyGrid.java
index 0e2eca969..074207931 100644
--- a/src/api/java/appeng/api/networking/energy/IEnergyGrid.java
+++ b/src/api/java/appeng/api/networking/energy/IEnergyGrid.java
@@ -61,7 +61,7 @@ public interface IEnergyGrid extends IGridCache, IEnergySource, IEnergyGridProvi
* condenses this into a single operation that determines the networks "powered
* state" if the network is considered off-line, your machines should not
* function.
- *
+ *
* {@link MENetworkPowerStatusChange} events are posted when this value changes
* if you need to be notified of the change, most machines can simply test the
* value when they operate.
@@ -73,21 +73,20 @@ public interface IEnergyGrid extends IGridCache, IEnergySource, IEnergyGridProvi
/**
* AE will accept any power, and store it, to maintain sanity please don't send
* more then 10,000 at a time.
- *
+ *
* IMPORTANT: Network power knows no bounds, for less spamy power flow, networks
* can store more then their allotted storage, however, it should be kept to a
* minimum, to help with this, this method returns the networks current
* OVERFLOW, this is not energy you can store some where else, its already
* stored in the network, you can extract it if you want, however it it owned by
* the network, this is different then IAEEnergyStore
- *
+ *
* Another important note, is that if a network that had overflow is deleted,
* its power is gone, this is one of the reasons why keeping overflow to a
* minimum is important.
*
* @param amt power to inject into the network
* @param mode should the action be simulated or performed?
- *
* @return the amount of power that the network has OVER the limit.
*/
@Nonnegative
diff --git a/src/api/java/appeng/api/networking/energy/IEnergyGridProvider.java b/src/api/java/appeng/api/networking/energy/IEnergyGridProvider.java
index ada5c4e42..bd6a49781 100644
--- a/src/api/java/appeng/api/networking/energy/IEnergyGridProvider.java
+++ b/src/api/java/appeng/api/networking/energy/IEnergyGridProvider.java
@@ -36,15 +36,15 @@ import appeng.api.config.Actionable;
public interface IEnergyGridProvider {
/**
* internal use only
- *
+ *
* Can return a list of providers behind the current.
- *
+ *
* An example would be something acting as proxy between different
* {@link IEnergyGrid}s.
- *
+ *
* This can contain duplicate entries, AE will ensure that each provider is only
* visited once.
- *
+ *
* internal use only
*/
@Nonnull
@@ -52,9 +52,9 @@ public interface IEnergyGridProvider {
/**
* internal use only
- *
+ *
* Extracts the requested amount from the provider.
- *
+ *
* This should never forward a call to another {@link IEnergyGridProvider},
* instead return them via {@link IEnergyGridProvider#providers()}
*
@@ -65,10 +65,10 @@ public interface IEnergyGridProvider {
/**
* Injects the offered amount into the provider.
- *
+ *
* This should never forward a call to another {@link IEnergyGridProvider},
* instead return them via {@link IEnergyGridProvider#providers()}
- *
+ *
* internal use only
*
* @return the leftover amount
@@ -78,13 +78,12 @@ public interface IEnergyGridProvider {
/**
* internal use only
- *
+ *
* Returns the current demand of an provider.
- *
+ *
* This should never forward a call to another {@link IEnergyGridProvider},
* instead return them via {@link IEnergyGridProvider#providers()}
*
- *
* @param d the max amount offered, the demand should never exceed it.
* @return the total amount demanded
*/
@@ -93,31 +92,29 @@ public interface IEnergyGridProvider {
/**
* internal use only
- *
+ *
* AE currently uses this to enqueue the next visited provider.
- *
+ *
* There is no guarantee that this works on in a perfect way. It can be limited
* to the returns of the past {@link IEnergyGridProvider#providers()}, but not
* any future one discovered by visiting further providers.
- *
+ *
* E.g. inject into the the lowest one first or extract from the highest one.
*
* @return the current stored amount.
- *
- *
*/
@Nonnegative
double getProviderStoredEnergy();
/**
* internal use only
- *
+ *
* AE currently uses this to enqueue the next visited provider.
- *
+ *
* There is no guarantee that this works on in a perfect way. It can be limited
* to the returns of the past {@link IEnergyGridProvider#providers()}, but not
* any future one discovered by visiting further providers.
- *
+ *
* E.g. inject into the the lowest one first or extract from the highest one.
*
* @return the maximum amount stored.
diff --git a/src/api/java/appeng/api/networking/energy/IEnergySource.java b/src/api/java/appeng/api/networking/energy/IEnergySource.java
index 16c219a19..4651b7a02 100644
--- a/src/api/java/appeng/api/networking/energy/IEnergySource.java
+++ b/src/api/java/appeng/api/networking/energy/IEnergySource.java
@@ -36,7 +36,6 @@ public interface IEnergySource {
*
* @param amt extracted power
* @param mode should the action be simulated or performed?
- *
* @return returns extracted power.
*/
@Nonnegative
diff --git a/src/api/java/appeng/api/networking/energy/IEnergyWatcher.java b/src/api/java/appeng/api/networking/energy/IEnergyWatcher.java
index c196f4981..bd652db90 100644
--- a/src/api/java/appeng/api/networking/energy/IEnergyWatcher.java
+++ b/src/api/java/appeng/api/networking/energy/IEnergyWatcher.java
@@ -27,13 +27,13 @@ import javax.annotation.Nonnegative;
/**
* DO NOT IMPLEMENT.
- *
+ *
* Will be injected when adding an {@link IEnergyWatcherHost} to a grid.
*/
public interface IEnergyWatcher {
/**
* Add a specific threshold to watch.
- *
+ *
* Supports multiple values, duplicate ones will not be added.
*
* @param amount
diff --git a/src/api/java/appeng/api/networking/events/MENetworkBootingStatusChange.java b/src/api/java/appeng/api/networking/events/MENetworkBootingStatusChange.java
index 1ef9ef16c..5785e0519 100644
--- a/src/api/java/appeng/api/networking/events/MENetworkBootingStatusChange.java
+++ b/src/api/java/appeng/api/networking/events/MENetworkBootingStatusChange.java
@@ -28,7 +28,7 @@ import appeng.api.networking.IGridNode;
/**
* Posted by the network when the booting status of the network goes up or down,
* the change is reflected via {@link IGridNode}.isActive()
- *
+ *
* Note: Most machines just need to check {@link IGridNode}.isActive()
*/
public class MENetworkBootingStatusChange extends MENetworkEvent {
diff --git a/src/api/java/appeng/api/networking/events/MENetworkCellArrayUpdate.java b/src/api/java/appeng/api/networking/events/MENetworkCellArrayUpdate.java
index 434106c1c..aaf399233 100644
--- a/src/api/java/appeng/api/networking/events/MENetworkCellArrayUpdate.java
+++ b/src/api/java/appeng/api/networking/events/MENetworkCellArrayUpdate.java
@@ -25,10 +25,10 @@ package appeng.api.networking.events;
/**
* Posted by storage devices to inform AE to refresh its storage structure.
- *
+ *
* This is done in cases such as a storage cell being removed or added to a
* drive.
- *
+ *
* you do not need to send this event when your node is added / removed from the
* grid.
*/
diff --git a/src/api/java/appeng/api/networking/events/MENetworkChannelsChanged.java b/src/api/java/appeng/api/networking/events/MENetworkChannelsChanged.java
index 1a9232c1f..b87a0f611 100644
--- a/src/api/java/appeng/api/networking/events/MENetworkChannelsChanged.java
+++ b/src/api/java/appeng/api/networking/events/MENetworkChannelsChanged.java
@@ -28,7 +28,7 @@ import appeng.api.networking.IGridHost;
/**
* Posted to the {@link IGridHost} when the channels on the node connections are
* altered.
- *
+ *
* Never posted IGridCaches.
*/
public class MENetworkChannelsChanged extends MENetworkEvent {
diff --git a/src/api/java/appeng/api/networking/events/MENetworkEvent.java b/src/api/java/appeng/api/networking/events/MENetworkEvent.java
index 5b11f1229..f37224e24 100644
--- a/src/api/java/appeng/api/networking/events/MENetworkEvent.java
+++ b/src/api/java/appeng/api/networking/events/MENetworkEvent.java
@@ -27,7 +27,7 @@ import appeng.api.networking.IGrid;
/**
* Part of AE's Event Bus.
- *
+ *
* Posted via {@link IGrid}.postEvent or {@link IGrid}.postEventTo
*/
public class MENetworkEvent {
diff --git a/src/api/java/appeng/api/networking/events/MENetworkPowerIdleChange.java b/src/api/java/appeng/api/networking/events/MENetworkPowerIdleChange.java
index 3ca050b3d..5ee7b8992 100644
--- a/src/api/java/appeng/api/networking/events/MENetworkPowerIdleChange.java
+++ b/src/api/java/appeng/api/networking/events/MENetworkPowerIdleChange.java
@@ -29,7 +29,7 @@ import appeng.api.networking.IGridNode;
* Implementers of a IGridBlock must post this event when your getIdlePowerUsage
* starts returning a new value, if you do not post this event the network will
* not change the idle draw.
- *
+ *
* you do not need to send this event when your node is added / removed from the
* grid.
*/
diff --git a/src/api/java/appeng/api/networking/events/MENetworkPowerStatusChange.java b/src/api/java/appeng/api/networking/events/MENetworkPowerStatusChange.java
index f36813903..efaaedf27 100644
--- a/src/api/java/appeng/api/networking/events/MENetworkPowerStatusChange.java
+++ b/src/api/java/appeng/api/networking/events/MENetworkPowerStatusChange.java
@@ -30,7 +30,7 @@ import appeng.api.networking.energy.IEnergyGrid;
* Posted by the network when the power status of the network goes up or down,
* the change is reflected via the {@link IEnergyGrid}.isNetworkPowered() or via
* {@link IGridNode}.isActive()
- *
+ *
* Note: Most machines just need to check {@link IGridNode}.isActive()
*/
public class MENetworkPowerStatusChange extends MENetworkEvent {
diff --git a/src/api/java/appeng/api/networking/events/MENetworkPowerStorage.java b/src/api/java/appeng/api/networking/events/MENetworkPowerStorage.java
index efb580e6c..0661e5c3b 100644
--- a/src/api/java/appeng/api/networking/events/MENetworkPowerStorage.java
+++ b/src/api/java/appeng/api/networking/events/MENetworkPowerStorage.java
@@ -28,10 +28,10 @@ import appeng.api.networking.energy.IAEPowerStorage;
/**
* informs the network, that a {@link IAEPowerStorage} block that had either
* run, out of power, or was full, is no longer in that state.
- *
+ *
* failure to post this event when your {@link IAEPowerStorage} changes state
* will result in your block not charging, or not-discharging.
- *
+ *
* you do not need to send this event when your node is added / removed from the
* grid.
*/
diff --git a/src/api/java/appeng/api/networking/events/MENetworkStorageEvent.java b/src/api/java/appeng/api/networking/events/MENetworkStorageEvent.java
index 3e491279e..500e3c672 100644
--- a/src/api/java/appeng/api/networking/events/MENetworkStorageEvent.java
+++ b/src/api/java/appeng/api/networking/events/MENetworkStorageEvent.java
@@ -29,9 +29,9 @@ import appeng.api.storage.IStorageChannel;
/**
* posted by the network when the networks Storage Changes, you can use the
* currentItems list to check levels, and update status.
- *
+ *
* this is the least useful method of getting info about changes in the network.
- *
+ *
* Do not modify the list or its contents in anyway.
*/
public class MENetworkStorageEvent extends MENetworkEvent {
diff --git a/src/api/java/appeng/api/networking/security/IActionSource.java b/src/api/java/appeng/api/networking/security/IActionSource.java
index c9b68be98..2c20445f6 100644
--- a/src/api/java/appeng/api/networking/security/IActionSource.java
+++ b/src/api/java/appeng/api/networking/security/IActionSource.java
@@ -31,18 +31,17 @@ import net.minecraft.entity.player.PlayerEntity;
/**
* The source of any action.
- *
+ *
* This can either be a {@link PlayerEntity} or an {@link IActionHost}.
- *
+ *
* In most cases this is used for security checks, but can be used to validate
* the source itself.
- *
*/
public interface IActionSource {
/**
* If present, AE will consider the player being the source for the action.
- *
+ *
* This will take precedence over {@link IActionSource#machine()} in any case.
*
* @return An optional player issuing the action.
@@ -52,10 +51,10 @@ public interface IActionSource {
/**
* If present, it indicates the {@link IActionHost} of the source.
- *
+ *
* Should {@link IActionSource#player()} be absent, it will consider a machine
* as source.
- *
+ *
* It is recommended to include the machine even when a player is present.
*
* @return An optional machine issuing the action or acting as proxy for a
@@ -66,9 +65,9 @@ public interface IActionSource {
/**
* An {@link IActionSource} can have multiple optional contexts.
- *
+ *
* It is strongly recommended to limit the uses for absolutely necessary cases.
- *
+ *
* Currently there are no public contexts made available by AE. An example would
* be the context interfaces use internally to avoid looping items between each
* other.
diff --git a/src/api/java/appeng/api/networking/security/ISecurityGrid.java b/src/api/java/appeng/api/networking/security/ISecurityGrid.java
index 4e59cf657..fb49ce831 100644
--- a/src/api/java/appeng/api/networking/security/ISecurityGrid.java
+++ b/src/api/java/appeng/api/networking/security/ISecurityGrid.java
@@ -43,7 +43,6 @@ public interface ISecurityGrid extends IGridCache {
*
* @param player to be checked player
* @param perm checked permissions
- *
* @return true if the player has permissions.
*/
boolean hasPermission(@Nonnull PlayerEntity player, @Nonnull SecurityPermissions perm);
@@ -53,7 +52,6 @@ public interface ISecurityGrid extends IGridCache {
*
* @param playerID id of player
* @param perm checked permissions
- *
* @return true if the player has permissions.
*/
boolean hasPermission(@Nonnegative int playerID, @Nonnull SecurityPermissions perm);
diff --git a/src/api/java/appeng/api/networking/storage/IStackWatcher.java b/src/api/java/appeng/api/networking/storage/IStackWatcher.java
index 086149af9..3a9fa2fd8 100644
--- a/src/api/java/appeng/api/networking/storage/IStackWatcher.java
+++ b/src/api/java/appeng/api/networking/storage/IStackWatcher.java
@@ -27,13 +27,13 @@ import appeng.api.storage.data.IAEStack;
/**
* DO NOT IMPLEMENT.
- *
+ *
* Will be injected when adding an {@link IStackWatcherHost} to a grid.
*/
public interface IStackWatcher {
/**
* Add a specific {@link IAEStack} to watch.
- *
+ *
* Supports multiple values, duplicate ones will not be added.
*
* @param stack
diff --git a/src/api/java/appeng/api/networking/storage/IStorageGrid.java b/src/api/java/appeng/api/networking/storage/IStorageGrid.java
index 7392982ed..124f97aad 100644
--- a/src/api/java/appeng/api/networking/storage/IStorageGrid.java
+++ b/src/api/java/appeng/api/networking/storage/IStorageGrid.java
@@ -42,7 +42,7 @@ public interface IStorageGrid extends IGridCache, IStorageMonitorable {
* outside of the standard Network operations, Examples, ME Chest inputs from
* the world, or a Storage Bus detecting modifications made to the chest by an
* outside force.
- *
+ *
* Expects the input to have either a negative or a positive stack size to
* correspond to the injection, or extraction operation.
*
@@ -52,7 +52,7 @@ public interface IStorageGrid extends IGridCache, IStorageMonitorable {
/**
* Used to add a cell provider to the storage system
- *
+ *
* THIS IT NOT FOR USE {@link IGridHost} THAT PROVIDE {@link ICellContainer} -
* those are automatically handled by the storage system.
*
diff --git a/src/api/java/appeng/api/networking/ticking/IGridTickable.java b/src/api/java/appeng/api/networking/ticking/IGridTickable.java
index 973fcf996..aa11c5f7b 100644
--- a/src/api/java/appeng/api/networking/ticking/IGridTickable.java
+++ b/src/api/java/appeng/api/networking/ticking/IGridTickable.java
@@ -46,7 +46,7 @@ public interface IGridTickable {
/**
* Return a valid TickingRequest to tell AE a guide for which type of
* responsiveness your device wants.
- *
+ *
* This will be called for your tile any time your tile changes grids, this can
* happen at any time, so if your using the sleep feature you may wish to
* preserve your sleep, in the result of this method. or you can simply reset
@@ -61,15 +61,14 @@ public interface IGridTickable {
* AE lets you adjust your tick rate based on the results of your tick, if your
* block as accomplished work you may wish to increase the ticking speed, if
* your block is idle you may wish to slow it down.
- *
+ *
* Its up to you.
- *
+ *
* Note: this is never called if you return null from getTickingRequest.
*
* @param ticksSinceLastCall the number of world ticks that were skipped since
* your last tick, you can use this to adjust speed of
* processing or adjust your tick rate.
- *
* @return tick rate adjustment.
*/
@Nonnull
diff --git a/src/api/java/appeng/api/networking/ticking/ITickManager.java b/src/api/java/appeng/api/networking/ticking/ITickManager.java
index 8684a6dab..0b6b44180 100644
--- a/src/api/java/appeng/api/networking/ticking/ITickManager.java
+++ b/src/api/java/appeng/api/networking/ticking/ITickManager.java
@@ -36,7 +36,7 @@ public interface ITickManager extends IGridCache {
/**
* immediately sets the node to tick, only valid if your node is marked as
* "Alertable" in its TickingRequest
- *
+ *
* Sleeping Devices Still Alertable, when your tile is alerted its new status is
* determined by the result of its tick.
*
@@ -48,7 +48,6 @@ public interface ITickManager extends IGridCache {
* disables ticking for your device.
*
* @param node gridnode
- *
* @return if the call was successful.
*/
boolean sleepDevice(@Nonnull IGridNode node);
@@ -57,7 +56,6 @@ public interface ITickManager extends IGridCache {
* enables ticking for your device, undoes a sleepDevice call.
*
* @param node gridnode
- *
* @return if the call was successful.
*/
boolean wakeDevice(@Nonnull IGridNode node);
diff --git a/src/api/java/appeng/api/networking/ticking/TickingRequest.java b/src/api/java/appeng/api/networking/ticking/TickingRequest.java
index 68429e8a7..2992aabf0 100644
--- a/src/api/java/appeng/api/networking/ticking/TickingRequest.java
+++ b/src/api/java/appeng/api/networking/ticking/TickingRequest.java
@@ -30,9 +30,9 @@ public class TickingRequest {
/**
* the minimum number of ticks that must pass between ticks.
- *
+ *
* Valid Values are : 1+
- *
+ *
* Suggested is 5-20
*/
public final int minTickRate;
@@ -40,9 +40,9 @@ public class TickingRequest {
/**
* the maximum number of ticks that can pass between ticks, if this value is
* exceeded the tile must tick.
- *
+ *
* Valid Values are 1+
- *
+ *
* Suggested is 20-40
*/
public final int maxTickRate;
diff --git a/src/api/java/appeng/api/parts/IAlphaPassItem.java b/src/api/java/appeng/api/parts/IAlphaPassItem.java
index e3b1daa78..6a7bfddb0 100644
--- a/src/api/java/appeng/api/parts/IAlphaPassItem.java
+++ b/src/api/java/appeng/api/parts/IAlphaPassItem.java
@@ -32,7 +32,6 @@ public interface IAlphaPassItem {
* rendering pipe line.
*
* @param is item
- *
* @return true to enable a second pass for your parts in the bus rendering pipe
* line.
*/
diff --git a/src/api/java/appeng/api/parts/IDynamicPartBakedModel.java b/src/api/java/appeng/api/parts/IDynamicPartBakedModel.java
index d388bfc5b..c1a4315ab 100644
--- a/src/api/java/appeng/api/parts/IDynamicPartBakedModel.java
+++ b/src/api/java/appeng/api/parts/IDynamicPartBakedModel.java
@@ -11,15 +11,10 @@ import net.fabricmc.fabric.api.renderer.v1.render.RenderContext;
import net.minecraft.block.BlockState;
import net.minecraft.client.render.model.BakedModel;
import net.minecraft.client.render.model.BakedQuad;
-import net.minecraft.client.render.model.json.ModelOverrideList;
-import net.minecraft.client.render.model.json.ModelTransformation;
-import net.minecraft.client.texture.Sprite;
import net.minecraft.util.math.BlockPos;
import net.minecraft.util.math.Direction;
import net.minecraft.world.BlockRenderView;
-import appeng.api.util.AEPartLocation;
-
/**
* This interface can be implemented by baked models returned by
* {@link IPart#getStaticModels()} to indicate that they would like to use the
diff --git a/src/api/java/appeng/api/parts/IFacadeContainer.java b/src/api/java/appeng/api/parts/IFacadeContainer.java
index 67ae95a1a..f26272c2d 100644
--- a/src/api/java/appeng/api/parts/IFacadeContainer.java
+++ b/src/api/java/appeng/api/parts/IFacadeContainer.java
@@ -32,7 +32,7 @@ import appeng.api.util.AEPartLocation;
/**
* Used Internally.
- *
+ *
* not intended for implementation.
*/
public interface IFacadeContainer {
@@ -70,9 +70,7 @@ public interface IFacadeContainer {
* read from stream
*
* @param data to be read data
- *
* @return true if it was readable
- *
* @throws IOException
*/
boolean readFromStream(PacketByteBuf data) throws IOException;
@@ -88,7 +86,6 @@ public interface IFacadeContainer {
* write to stream
*
* @param data to be written data
- *
* @throws IOException
*/
void writeToStream(PacketByteBuf data) throws IOException;
diff --git a/src/api/java/appeng/api/parts/IFacadePart.java b/src/api/java/appeng/api/parts/IFacadePart.java
index a3c60c113..1ed6cf493 100644
--- a/src/api/java/appeng/api/parts/IFacadePart.java
+++ b/src/api/java/appeng/api/parts/IFacadePart.java
@@ -31,7 +31,7 @@ import appeng.api.util.AEPartLocation;
/**
* Used Internally.
- *
+ *
* not intended for implementation.
*/
public interface IFacadePart {
diff --git a/src/api/java/appeng/api/parts/IPart.java b/src/api/java/appeng/api/parts/IPart.java
index 68f40168f..ebe06ff3f 100644
--- a/src/api/java/appeng/api/parts/IPart.java
+++ b/src/api/java/appeng/api/parts/IPart.java
@@ -61,7 +61,7 @@ public interface IPart extends ICustomCableConnection {
* get an ItemStack that represents the bus, should contain the settings for
* whatever, can also be used in conjunction with removePart to take a part off
* and drop it or something.
- *
+ *
* This is used to drop the bus, and to save the bus, when saving the bus,
* wrenched is false, and writeToNBT will be called to save important details
* about the part, if the part is wrenched include in your NBT Data any settings
@@ -69,7 +69,6 @@ public interface IPart extends ICustomCableConnection {
* constructing your part.
*
* @param type , what kind of ItemStack to return?
- *
* @return item of part
*/
ItemStack getItemStack(PartItemStack type);
@@ -127,7 +126,6 @@ public interface IPart extends ICustomCableConnection {
* does this part act like a ladder?
*
* @param entity climbing entity
- *
* @return true if entity can climb
*/
boolean isLadder(LivingEntity entity);
@@ -151,7 +149,6 @@ public interface IPart extends ICustomCableConnection {
* write data to bus packet.
*
* @param data to be written data
- *
* @throws IOException
*/
void writeToStream(PacketByteBuf data) throws IOException;
@@ -160,9 +157,7 @@ public interface IPart extends ICustomCableConnection {
* read data from bus packet.
*
* @param data to be read data
- *
* @return true will re-draw the part.
- *
* @throws IOException
*/
boolean readFromStream(PacketByteBuf data) throws IOException;
@@ -170,7 +165,7 @@ public interface IPart extends ICustomCableConnection {
/**
* get the Grid Node for the Bus, be sure your IGridBlock is NOT
* isWorldAccessible, if it is your going to cause crashes.
- *
+ *
* or null if you don't have a grid node.
*
* @return grid node
@@ -216,7 +211,6 @@ public interface IPart extends ICustomCableConnection {
* @param player right clicking player
* @param hand hand used
* @param pos position of block
- *
* @return if your activate method performed something.
*/
boolean onActivate(PlayerEntity player, Hand hand, Vec3d pos);
@@ -227,7 +221,6 @@ public interface IPart extends ICustomCableConnection {
* @param player shift right clicking player
* @param hand hand used
* @param pos position of block
- *
* @return if your activate method performed something, you should use false
* unless you really need it.
*/
@@ -239,7 +232,6 @@ public interface IPart extends ICustomCableConnection {
* @param player left clicking player
* @param hand hand used
* @param pos position of block
- *
* @return if your activate method performed something, you should use false
* unless you really need it.
*/
@@ -254,7 +246,6 @@ public interface IPart extends ICustomCableConnection {
* @param player shift-left clicking player
* @param hand hand used
* @param pos position of block
- *
* @return if your activate method performed something, you should use false
* unless you really need it.
*/
@@ -299,12 +290,11 @@ public interface IPart extends ICustomCableConnection {
/**
* Used to determine which parts can be placed on what cables.
- *
+ *
* Dense cables are not allowed for functional (getGridNode returns a node)
* parts. Doing so will result in crashes.
*
* @param what placed part
- *
* @return true if the part can be placed on this support.
*/
boolean canBePlacedOn(BusSupport what);
diff --git a/src/api/java/appeng/api/parts/IPartCollisionHelper.java b/src/api/java/appeng/api/parts/IPartCollisionHelper.java
index 477000866..a957abb42 100644
--- a/src/api/java/appeng/api/parts/IPartCollisionHelper.java
+++ b/src/api/java/appeng/api/parts/IPartCollisionHelper.java
@@ -29,7 +29,7 @@ public interface IPartCollisionHelper {
/**
* add a collision box, expects 0.0 - 16.0 block coords.
- *
+ *
* No complaints about the size, I like using pixels :P
*
* @param minX minimal x collision
diff --git a/src/api/java/appeng/api/parts/IPartHelper.java b/src/api/java/appeng/api/parts/IPartHelper.java
index 534f94bb2..62ec25a52 100644
--- a/src/api/java/appeng/api/parts/IPartHelper.java
+++ b/src/api/java/appeng/api/parts/IPartHelper.java
@@ -40,7 +40,6 @@ public interface IPartHelper {
* @param side side which the part should be on
* @param player player placing part
* @param world part in world
- *
* @return true if placing was successful
*/
// TODO, this should probably take ItemStack + ItemUseContext
diff --git a/src/api/java/appeng/api/parts/IPartHost.java b/src/api/java/appeng/api/parts/IPartHost.java
index 725d4e451..ac132f4c2 100644
--- a/src/api/java/appeng/api/parts/IPartHost.java
+++ b/src/api/java/appeng/api/parts/IPartHost.java
@@ -38,7 +38,7 @@ import appeng.api.util.DimensionalCoord;
/**
* Implemented on AE's TileEntity.
- *
+ *
* Do Not Implement
*/
public interface IPartHost extends ICustomCableConnection {
@@ -54,7 +54,6 @@ public interface IPartHost extends ICustomCableConnection {
*
* @param part to be added part
* @param side part placed onto side
- *
* @return returns false if the part cannot be added.
*/
boolean canAddPart(ItemStack part, AEPartLocation side);
@@ -66,7 +65,6 @@ public interface IPartHost extends ICustomCableConnection {
* @param is new part
* @param side onto side
* @param owner with owning player
- *
* @return null if the item failed to add, the side it was placed on other wise
* ( may different for cables, {@link AEPartLocation}.UNKNOWN )
*/
@@ -76,7 +74,6 @@ public interface IPartHost extends ICustomCableConnection {
* Get part by side ( center is {@link AEPartLocation}.UNKNOWN )
*
* @param side side of part
- *
* @return the part located on the specified side, or null if there is no part.
*/
IPart getPart(AEPartLocation side);
@@ -86,7 +83,6 @@ public interface IPartHost extends ICustomCableConnection {
* other varient of getPart.
*
* @param side side of part
- *
* @return the part located on the specified side, or null if there is no part.
*/
IPart getPart(Direction side);
@@ -95,7 +91,7 @@ public interface IPartHost extends ICustomCableConnection {
* removes the part on the side, this doesn't drop it or anything, if you don't
* do something with it, its just "gone" and its never coming back; think about
* it.
- *
+ *
* if you want to drop the part you must request it prior to removing it.
*
* @param side side of part
@@ -143,7 +139,6 @@ public interface IPartHost extends ICustomCableConnection {
* finds the part located at the position ( pos must be relative, not global )
*
* @param pos part position
- *
* @return a new SelectedPart, this is never null.
*/
SelectedPart selectPart(Vec3d pos);
@@ -162,7 +157,6 @@ public interface IPartHost extends ICustomCableConnection {
* get the redstone state of host on this side, this value is cached internally.
*
* @param side side of part
- *
* @return true of the part host is receiving redstone from an external source.
*/
boolean hasRedstone(AEPartLocation side);
diff --git a/src/api/java/appeng/api/parts/IPartItem.java b/src/api/java/appeng/api/parts/IPartItem.java
index 773ba9f19..fde91d882 100644
--- a/src/api/java/appeng/api/parts/IPartItem.java
+++ b/src/api/java/appeng/api/parts/IPartItem.java
@@ -30,10 +30,10 @@ import net.minecraft.item.ItemStack;
/**
* This is a pretty basic requirement, once you implement the interface, and
* createPartFromItemStack
- *
+ *
* you must register your bus with the Bus renderer, using
* AEApi.INSTANCE().partHelper().setItemBusRenderer( this );
- *
+ *
* then simply add this, and call AE's Bus Placement Code.
*
*
@@ -41,9 +41,9 @@ import net.minecraft.item.ItemStack;
*
* {@literal @}Override
* public default ActionResult onItemUse(ItemStack is, PlayerEntity player, World world, BlockPos pos, EnumHand hand, EnumFacing side, float hitX, float hitY, float hitZ)
- * {
- * return Api.INSTANCE.partHelper().placeBus( is, pos, side, player, hand, world );
- * }
+ * {
+ * return Api.INSTANCE.partHelper().placeBus( is, pos, side, player, hand, world );
+ * }
*
*
*/
@@ -53,7 +53,6 @@ public interface IPartItem
{
* create a new part INSTANCE
*
* @param is ItemStack of this item, may have additional properties.
- *
* @return part from item
*/
P createPart(ItemStack is);
diff --git a/src/api/java/appeng/api/parts/IPartModel.java b/src/api/java/appeng/api/parts/IPartModel.java
index cb80a3940..1d19ceff4 100644
--- a/src/api/java/appeng/api/parts/IPartModel.java
+++ b/src/api/java/appeng/api/parts/IPartModel.java
@@ -39,7 +39,7 @@ public interface IPartModel {
/**
* A solid {@link IPartModel} indicates that the rendering requires a cable
* connection, which will also result in creating an intersection for the cable.
- *
+ *
* This should be true for pretty much all parts.
*
* @return true for a solid part.
diff --git a/src/api/java/appeng/api/parts/IPartModels.java b/src/api/java/appeng/api/parts/IPartModels.java
index 5e4cf2200..9e199b8c9 100644
--- a/src/api/java/appeng/api/parts/IPartModels.java
+++ b/src/api/java/appeng/api/parts/IPartModels.java
@@ -32,9 +32,9 @@ public interface IPartModels {
/**
* Allows registration of part models that can then be used in
* {@link IPart#getStaticModels()}.
- *
+ *
* Models can be registered multiple times without causing issues.
- *
+ *
* This method must be called during the pre-init phase (as part of your
* plugin's constructor).
*/
diff --git a/src/api/java/appeng/api/parts/LayerBase.java b/src/api/java/appeng/api/parts/LayerBase.java
index 22499f3cb..a47b8dd7e 100644
--- a/src/api/java/appeng/api/parts/LayerBase.java
+++ b/src/api/java/appeng/api/parts/LayerBase.java
@@ -35,7 +35,7 @@ import appeng.api.util.AEPartLocation;
* All Layers must extends this, this get part implementation is provided to
* interface with the parts, however a real implementation will be used at
* runtime.
- *
+ *
* TODO: Consider removing and replacing with capabilities.
*/
public abstract class LayerBase extends BlockEntity // implements IPartHost
@@ -48,12 +48,11 @@ public abstract class LayerBase extends BlockEntity // implements IPartHost
/**
* Grants access for the layer to the parts of the host.
- *
+ *
* This Method looks silly, that is because its not used at runtime, a real
* implementation will be used instead.
*
* @param side side of part
- *
* @return the part for the requested side.
*/
public IPart getPart(final AEPartLocation side) {
@@ -62,12 +61,11 @@ public abstract class LayerBase extends BlockEntity // implements IPartHost
/**
* Grants access for the layer to the parts of the host.
- *
+ *
* This Method looks silly, that is because its not used at runtime, a real
* implementation will be used instead.
*
* @param side side of part
- *
* @return the part for the requested side.
*/
public IPart getPart(final Direction side) {
diff --git a/src/api/java/appeng/api/parts/SelectedPart.java b/src/api/java/appeng/api/parts/SelectedPart.java
index 372f73c95..f03f93817 100644
--- a/src/api/java/appeng/api/parts/SelectedPart.java
+++ b/src/api/java/appeng/api/parts/SelectedPart.java
@@ -27,7 +27,6 @@ import appeng.api.util.AEPartLocation;
/**
* Reports a selected part from the IPartHost
- *
*/
public class SelectedPart {
diff --git a/src/api/java/appeng/api/storage/ICellRegistry.java b/src/api/java/appeng/api/storage/ICellRegistry.java
index c7a16ca9e..061db7b63 100644
--- a/src/api/java/appeng/api/storage/ICellRegistry.java
+++ b/src/api/java/appeng/api/storage/ICellRegistry.java
@@ -39,14 +39,14 @@ import appeng.api.storage.data.IAEStack;
* Storage Cell Registry, used for specially implemented cells, if you just want
* to make a item act like a cell, or new cell with different bytes, then you
* should probably consider IStorageCell instead its considerably simpler.
- *
+ *
* Do not Implement, obtained via {@link IAppEngApi}.getCellRegistry()
*/
public interface ICellRegistry {
/**
* Register a new handler.
- *
+ *
* Never be call before
* {@link net.minecraftforge.fml.event.lifecycle.FMLCommonSetupEvent} was
* handled by AE2. Will throw an exception otherwise.
@@ -66,7 +66,6 @@ public interface ICellRegistry {
* return true, if you can get a InventoryHandler for the item passed.
*
* @param is to be checked item
- *
* @return true if the provided item, can be handled by a handler in AE, ( AE
* May choose to skip this and just get the handler instead. )
*/
@@ -76,7 +75,6 @@ public interface ICellRegistry {
* get the handler, for the requested item.
*
* @param is to be checked item
- *
* @return the handler registered for this item type.
*/
@Nullable
@@ -100,7 +98,6 @@ public interface ICellRegistry {
* @param host can be null. If provided, the host is responsible for persisting
* the cell content.
* @param chan the storage channel to request the handler for.
- *
* @return new ICellInventoryHandler, or null if there isn't one.
*/
@Nullable
diff --git a/src/api/java/appeng/api/storage/IMEInventory.java b/src/api/java/appeng/api/storage/IMEInventory.java
index ea945dd90..b573b839c 100644
--- a/src/api/java/appeng/api/storage/IMEInventory.java
+++ b/src/api/java/appeng/api/storage/IMEInventory.java
@@ -31,12 +31,12 @@ import appeng.api.storage.data.IItemList;
/**
* AE's Equivalent to IInventory, used to reading contents, and manipulating
* contents of ME Inventories.
- *
+ *
* Implementations should COMPLETELY ignore stack size limits from an external
* view point, Meaning that you can inject Integer.MAX_VALUE items and it should
* work as defined, or be able to extract Integer.MAX_VALUE and have it work as
* defined, Translations to MC's max stack size are external to the AE API.
- *
+ *
* If you want to request a stack of an item, you should should determine that
* prior to requesting the stack from the inventory.
*/
@@ -48,7 +48,6 @@ public interface IMEInventory> {
* @param input item to add.
* @param type action type
* @param src action source
- *
* @return returns the number of items not added.
*/
T injectItems(T input, Actionable type, IActionSource src);
@@ -58,7 +57,6 @@ public interface IMEInventory> {
*
* @param request item to request ( with stack size. )
* @param mode simulate, or perform action?
- *
* @return returns the number of items extracted, null
*/
T extractItems(T request, Actionable mode, IActionSource src);
@@ -67,7 +65,6 @@ public interface IMEInventory> {
* request a full report of all available items, storage.
*
* @param out the IItemList the results will be written too
- *
* @return returns same list that was passed in, is passed out
*/
IItemList getAvailableItems(IItemList out);
diff --git a/src/api/java/appeng/api/storage/IMEInventoryHandler.java b/src/api/java/appeng/api/storage/IMEInventoryHandler.java
index 5b2c08f33..65e4f8dc3 100644
--- a/src/api/java/appeng/api/storage/IMEInventoryHandler.java
+++ b/src/api/java/appeng/api/storage/IMEInventoryHandler.java
@@ -49,7 +49,6 @@ public interface IMEInventoryHandler> extends IMEInventory
* inventories.
*
* @param input - item that might be added
- *
* @return if its prioritized
*/
boolean isPrioritized(T input);
@@ -58,7 +57,6 @@ public interface IMEInventoryHandler> extends IMEInventory
* determine if an item can be accepted and stored.
*
* @param input - item that might be added
- *
* @return if the item can be added
*/
boolean canAccept(T input);
@@ -87,7 +85,6 @@ public interface IMEInventoryHandler> extends IMEInventory
* this allows you to do that.
*
* @param i - pass number ( 1 or 2 )
- *
* @return true, if this inventory is valid for this pass.
*/
boolean validForPass(int i);
diff --git a/src/api/java/appeng/api/storage/IMEMonitorHandlerReceiver.java b/src/api/java/appeng/api/storage/IMEMonitorHandlerReceiver.java
index 63ca8d241..77ee15ed8 100644
--- a/src/api/java/appeng/api/storage/IMEMonitorHandlerReceiver.java
+++ b/src/api/java/appeng/api/storage/IMEMonitorHandlerReceiver.java
@@ -33,7 +33,6 @@ public interface IMEMonitorHandlerReceiver> {
* return true if this object should remain as a listener.
*
* @param verificationToken to be checked object
- *
* @return true if object should remain as a listener
*/
boolean isValid(Object verificationToken);
diff --git a/src/api/java/appeng/api/storage/IStorageChannel.java b/src/api/java/appeng/api/storage/IStorageChannel.java
index f693bf5ba..4e8e0dda6 100644
--- a/src/api/java/appeng/api/storage/IStorageChannel.java
+++ b/src/api/java/appeng/api/storage/IStorageChannel.java
@@ -39,7 +39,7 @@ public interface IStorageChannel> {
/**
* Can be used as factor for transferring stacks of a channel.
- *
+ *
* E.g. used by IO Ports to transfer 1000 mB, not 1 mB to match the item channel
* transferring a full bucket per operation.
*
@@ -70,7 +70,7 @@ public interface IStorageChannel> {
/**
* Create a new {@link IAEStack} subtype of the specific object.
- *
+ *
* The parameter is unbound to allow a slightly more flexible approach. But the
* general intention is about converting an {@link ItemStack} or
* {@link FluidStack} into the corresponding {@link IAEStack}. Another valid
diff --git a/src/api/java/appeng/api/storage/IStorageHelper.java b/src/api/java/appeng/api/storage/IStorageHelper.java
index 05f3b5f96..43f3d4886 100644
--- a/src/api/java/appeng/api/storage/IStorageHelper.java
+++ b/src/api/java/appeng/api/storage/IStorageHelper.java
@@ -44,19 +44,19 @@ public interface IStorageHelper {
/**
* Register a new storage channel.
- *
+ *
* AE2 already provides native channels for {@link IAEItemStack} and
* {@link IAEFluidStack}.
- *
+ *
* Each {@link IAEStack} subtype can only have a single factory instance.
* Overwriting is not intended. Each subtype should be a direct one, this might
* be enforced at any time.
- *
+ *
* Channel class and factory instance can be used interchangeable as identifier.
* In most cases the factory instance is used as key as having direct access the
* methods is more beneficial compared to being forced to query the registry
* each time.
- *
+ *
* Caching the factory instance in a field or local variable is perfectly for
* performance reasons. But do not use any AE2 internal field as they can change
* randomly between releases.
@@ -71,19 +71,19 @@ public interface IStorageHelper {
/**
* Fetch the factory instance for a specific storage channel.
- *
+ *
* Channel must be a direct subtype of {@link IStorageChannel}.
*
- * @throws NullPointerException when fetching an unregistered channel.
* @param channel The channel type
* @return the factory instance
+ * @throws NullPointerException when fetching an unregistered channel.
*/
@Nonnull
, C extends IStorageChannel> C getStorageChannel(@Nonnull Class channel);
/**
* An unmodifiable collection of all registered factory instance.
- *
+ *
* This is mainly used as helper to let storage grids construct their internal
* storage for each type.
*/
@@ -94,7 +94,6 @@ public interface IStorageHelper {
* load a crafting link from nbt data.
*
* @param data to be loaded data
- *
* @return crafting link
*/
ICraftingLink loadCraftingLink(CompoundTag data, ICraftingRequester req);
diff --git a/src/api/java/appeng/api/storage/IStorageMonitorableAccessor.java b/src/api/java/appeng/api/storage/IStorageMonitorableAccessor.java
index 414fd8882..ce3859db8 100644
--- a/src/api/java/appeng/api/storage/IStorageMonitorableAccessor.java
+++ b/src/api/java/appeng/api/storage/IStorageMonitorableAccessor.java
@@ -1,4 +1,3 @@
-
package appeng.api.storage;
import javax.annotation.Nullable;
diff --git a/src/api/java/appeng/api/storage/cells/ICellGuiHandler.java b/src/api/java/appeng/api/storage/cells/ICellGuiHandler.java
index aac512571..57b9fa4a8 100644
--- a/src/api/java/appeng/api/storage/cells/ICellGuiHandler.java
+++ b/src/api/java/appeng/api/storage/cells/ICellGuiHandler.java
@@ -1,4 +1,3 @@
-
package appeng.api.storage.cells;
import net.minecraft.entity.player.PlayerEntity;
diff --git a/src/api/java/appeng/api/storage/cells/ICellHandler.java b/src/api/java/appeng/api/storage/cells/ICellHandler.java
index e123ed77b..3d9540340 100644
--- a/src/api/java/appeng/api/storage/cells/ICellHandler.java
+++ b/src/api/java/appeng/api/storage/cells/ICellHandler.java
@@ -39,7 +39,6 @@ public interface ICellHandler {
* choose to skip this method, and just request a handler )
*
* @param is to be checked item
- *
* @return return true, if getCellHandler will not return null.
*/
boolean isCell(ItemStack is);
@@ -53,7 +52,6 @@ public interface ICellHandler {
* null. If provided, the host is responsible for persisting the
* cell content.
* @param channel the storage channel requested.
- *
* @return a new IMEHandler for the provided item
*/
> ICellInventoryHandler getCellInventory(ItemStack is, ISaveProvider host,
@@ -61,17 +59,16 @@ public interface ICellHandler {
/**
* 0 - cell is missing.
- *
+ *
* 1 - green, ( usually means available room for types or items. )
- *
+ *
* 2 - orange, ( usually means available room for items, but not types. )
- *
+ *
* 3 - red, ( usually means the cell is 100% full )
*
* @param is the cell item. ( use the handler for any details you can )
* @param handler the handler for the cell is provides for reference, you can
* cast this to your handler.
- *
* @return get the status of the cell based on its contents.
*/
default > CellState getStatusForCell(ItemStack is, ICellInventoryHandler handler) {
diff --git a/src/api/java/appeng/api/storage/cells/ICellProvider.java b/src/api/java/appeng/api/storage/cells/ICellProvider.java
index cd7fb83bc..b0e336f12 100644
--- a/src/api/java/appeng/api/storage/cells/ICellProvider.java
+++ b/src/api/java/appeng/api/storage/cells/ICellProvider.java
@@ -38,7 +38,7 @@ public interface ICellProvider {
/**
* Inventory of the tile for use with ME, should always return an valid list,
* never NULL.
- *
+ *
* You must return the correct Handler for the correct channel, if your handler
* returns a IAEItemStack handler, for a Fluid Channel stuffs going to explode,
* same with the reverse.
@@ -49,7 +49,7 @@ public interface ICellProvider {
/**
* the storage's priority.
- *
+ *
* Positive and negative are supported
*/
int getPriority();
diff --git a/src/api/java/appeng/api/storage/cells/ICellWorkbenchItem.java b/src/api/java/appeng/api/storage/cells/ICellWorkbenchItem.java
index 90871f866..07911ad21 100644
--- a/src/api/java/appeng/api/storage/cells/ICellWorkbenchItem.java
+++ b/src/api/java/appeng/api/storage/cells/ICellWorkbenchItem.java
@@ -36,7 +36,6 @@ public interface ICellWorkbenchItem {
* inserted into the work bench.
*
* @param is item
- *
* @return true if the item should be editable in the cell workbench.
*/
boolean isEditable(ItemStack is);
@@ -45,16 +44,16 @@ public interface ICellWorkbenchItem {
* used to edit the upgrade slots on your cell, should have a capacity of 0-24,
* you are also responsible for implementing the valid checks, and any
* storage/usage of them.
- *
+ *
* onInventoryChange will be called when saving is needed.
*/
FixedItemInv getUpgradesInventory(ItemStack is);
/**
* Used to extract, or mirror the contents of the work bench onto the cell.
- *
+ *
* - This should have exactly 63 slots, any more, or less might cause issues.
- *
+ *
* onInventoryChange will be called when saving is needed.
*/
FixedItemInv getConfigInventory(ItemStack is);
diff --git a/src/api/java/appeng/api/storage/cells/ISaveProvider.java b/src/api/java/appeng/api/storage/cells/ISaveProvider.java
index 52d7b4366..6d75ad26b 100644
--- a/src/api/java/appeng/api/storage/cells/ISaveProvider.java
+++ b/src/api/java/appeng/api/storage/cells/ISaveProvider.java
@@ -28,7 +28,6 @@ import javax.annotation.Nullable;
/**
* Tells the cell provider that changes have been made an the cell must be
* persisted
- *
*/
public interface ISaveProvider {
/**
diff --git a/src/api/java/appeng/api/storage/data/IAEFluidStack.java b/src/api/java/appeng/api/storage/data/IAEFluidStack.java
index 8515c7443..0c541a069 100644
--- a/src/api/java/appeng/api/storage/data/IAEFluidStack.java
+++ b/src/api/java/appeng/api/storage/data/IAEFluidStack.java
@@ -30,12 +30,12 @@ import alexiil.mc.lib.attributes.fluid.volume.FluidVolume;
/**
* An alternate version of FluidStack for AE to keep tabs on things easier, and
* to support larger storage. stackSizes of getFluidStack will be capped.
- *
+ *
* You may hold on to these if you want, just make sure you let go of them when
* your not using them.
- *
+ *
* Don't Implement.
- *
+ *
* Construct with Api.INSTANCE.storage().getStorageChannel(
* IFluidStorageChannel.class).createStack( FluidStack )
*/
diff --git a/src/api/java/appeng/api/storage/data/IAEItemStack.java b/src/api/java/appeng/api/storage/data/IAEItemStack.java
index eb676e413..c8527b350 100644
--- a/src/api/java/appeng/api/storage/data/IAEItemStack.java
+++ b/src/api/java/appeng/api/storage/data/IAEItemStack.java
@@ -29,12 +29,12 @@ import net.minecraft.item.ItemStack;
/**
* An alternate version of ItemStack for AE to keep tabs on things easier, and
* to support larger storage. stackSizes of getItemStack will be capped.
- *
+ *
* You may hold on to these if you want, just make sure you let go of them when
* your not using them.
- *
+ *
* Don't Implement.
- *
+ *
* Construct with Api.INSTANCE.storage().getStorageChannel(
* IItemStorageChannel.class).createStack( ItemStack )
*/
@@ -86,7 +86,6 @@ public interface IAEItemStack extends IAEStack {
* compare the item/damage/nbt of the stack.
*
* @param otherStack to be compared item
- *
* @return true if it is the same type (same item, damage, nbt)
*/
boolean isSameType(IAEItemStack otherStack);
@@ -95,7 +94,6 @@ public interface IAEItemStack extends IAEStack {
* compare the item/damage/nbt of the stack.
*
* @param stored to be compared item
- *
* @return true if it is the same type (same item, damage, nbt)
*/
boolean isSameType(ItemStack stored);
diff --git a/src/api/java/appeng/api/storage/data/IAEStack.java b/src/api/java/appeng/api/storage/data/IAEStack.java
index e589b99f6..3ca9acde5 100644
--- a/src/api/java/appeng/api/storage/data/IAEStack.java
+++ b/src/api/java/appeng/api/storage/data/IAEStack.java
@@ -130,15 +130,14 @@ public interface IAEStack> {
/**
* Compare stacks using precise logic.
- *
+ *
* a IAEItemStack to another AEItemStack or a ItemStack.
- *
+ *
* or
- *
+ *
* IAEFluidStack, FluidStack
*
* @param obj compared object
- *
* @return true if they are the same.
*/
@Override
@@ -150,7 +149,6 @@ public interface IAEStack> {
*
* @param other The stack to compare.
* @param mode Which {@link FuzzyMode} should be used.
- *
* @return true if two stacks are equal based on AE Fuzzy Comparison.
*/
boolean fuzzyComparison(T other, FuzzyMode mode);
@@ -159,7 +157,6 @@ public interface IAEStack> {
* Slower for disk saving, but smaller/more efficient for packets.
*
* @param data to be written data
- *
* @throws IOException
*/
void writeToPacket(PacketByteBuf data);
diff --git a/src/api/java/appeng/api/storage/data/IItemContainer.java b/src/api/java/appeng/api/storage/data/IItemContainer.java
index 8821379a2..5fb5e9428 100644
--- a/src/api/java/appeng/api/storage/data/IItemContainer.java
+++ b/src/api/java/appeng/api/storage/data/IItemContainer.java
@@ -29,9 +29,8 @@ import appeng.api.config.FuzzyMode;
/**
* Represents a list of items in AE.
- *
+ *
* Don't Implement.
- *
*/
public interface IItemContainer> {
@@ -45,7 +44,6 @@ public interface IItemContainer> {
/**
* @param i compared item
- *
* @return a stack equivalent to the stack passed in, but with the correct stack
* size information, or null if its not present
*/
@@ -53,7 +51,6 @@ public interface IItemContainer> {
/**
* @param input compared item
- *
* @return a list of relevant fuzzy matched stacks
*/
Collection findFuzzy(T input, FuzzyMode fuzzy);
diff --git a/src/api/java/appeng/api/storage/data/IItemList.java b/src/api/java/appeng/api/storage/data/IItemList.java
index e52ecd7ca..5de5a6fe8 100644
--- a/src/api/java/appeng/api/storage/data/IItemList.java
+++ b/src/api/java/appeng/api/storage/data/IItemList.java
@@ -29,9 +29,9 @@ import appeng.api.storage.IStorageChannel;
/**
* Represents a list of items in AE.
- *
+ *
* Don't Implement.
- *
+ *
* Construct with - For items: Api.INSTANCE.storage().getStorageChannel(
* IItemStorageChannel.class).createList() - For fluids:
* Api.INSTANCE.storage().getStorageChannel(
diff --git a/src/api/java/appeng/api/util/AEAxisAlignedBB.java b/src/api/java/appeng/api/util/AEAxisAlignedBB.java
index 50d971314..fdf405dc1 100644
--- a/src/api/java/appeng/api/util/AEAxisAlignedBB.java
+++ b/src/api/java/appeng/api/util/AEAxisAlignedBB.java
@@ -23,7 +23,7 @@ import net.minecraft.util.math.Box;
/**
* Mutable stand in for Axis Aligned BB, this was used to prevent GC Thrashing..
* Related code could also be re-written.
- *
+ *
* TODO: Replace with interface and maybe factory should it ever be needed for
* addons.
*/
diff --git a/src/api/java/appeng/api/util/AEColor.java b/src/api/java/appeng/api/util/AEColor.java
index 7d8564d63..06043638d 100644
--- a/src/api/java/appeng/api/util/AEColor.java
+++ b/src/api/java/appeng/api/util/AEColor.java
@@ -32,7 +32,7 @@ import net.minecraft.util.DyeColor;
/**
* List of all colors supported by AE, their names, and various colors for
* display.
- *
+ *
* Should be the same order as Dyes, excluding Transparent.
*/
public enum AEColor {
diff --git a/src/api/java/appeng/api/util/AEColoredItemDefinition.java b/src/api/java/appeng/api/util/AEColoredItemDefinition.java
index 2b19f1eb4..96b9094cb 100644
--- a/src/api/java/appeng/api/util/AEColoredItemDefinition.java
+++ b/src/api/java/appeng/api/util/AEColoredItemDefinition.java
@@ -52,7 +52,6 @@ public interface AEColoredItemDefinition {
/**
* @param stackSize - stack size of the result.
- *
* @return an array of all colors.
*/
ItemStack[] allStacks(int stackSize);
@@ -62,7 +61,6 @@ public interface AEColoredItemDefinition {
*
* @param color compared color of item
* @param comparableItem compared item
- *
* @return true if the item stack is a matching item.
*/
boolean sameAs(AEColor color, ItemStack comparableItem);
diff --git a/src/api/java/appeng/api/util/IConfigManager.java b/src/api/java/appeng/api/util/IConfigManager.java
index 7754b53ba..5dbab7e7d 100644
--- a/src/api/java/appeng/api/util/IConfigManager.java
+++ b/src/api/java/appeng/api/util/IConfigManager.java
@@ -31,7 +31,7 @@ import appeng.api.config.Settings;
/**
* Used to adjust settings on an object,
- *
+ *
* Obtained via {@link IConfigurableObject}
*/
public interface IConfigManager {
@@ -56,7 +56,6 @@ public interface IConfigManager {
* Get Value of a particular setting
*
* @param settingName name of setting
- *
* @return value of setting
*/
Enum getSetting(Settings settingName);
@@ -66,7 +65,6 @@ public interface IConfigManager {
*
* @param settingName to be changed setting
* @param newValue new value for setting
- *
* @return changed setting
*/
Enum putSetting(Settings settingName, Enum newValue);
diff --git a/src/api/java/appeng/api/util/IOrientable.java b/src/api/java/appeng/api/util/IOrientable.java
index a49c5d522..4dae69f91 100644
--- a/src/api/java/appeng/api/util/IOrientable.java
+++ b/src/api/java/appeng/api/util/IOrientable.java
@@ -27,10 +27,10 @@ import net.minecraft.util.math.Direction;
/**
* Nearly all of AE's Tile Entities implement IOrientable.
- *
+ *
* and it can be used to manipulate the direction of some machines, most of
* these orientations are purely visual.
- *
+ *
* AE also responds to Block.rotateBlock
*/
public interface IOrientable {
diff --git a/src/api/java/appeng/api/util/IOrientableBlock.java b/src/api/java/appeng/api/util/IOrientableBlock.java
index 365b93cf9..ae1e935d5 100644
--- a/src/api/java/appeng/api/util/IOrientableBlock.java
+++ b/src/api/java/appeng/api/util/IOrientableBlock.java
@@ -35,7 +35,6 @@ public interface IOrientableBlock {
/**
* @param world world of block
* @param pos The position of the block.
- *
* @return a IOrientable if applicable
*/
IOrientable getOrientable(BlockView world, BlockPos pos);
diff --git a/src/api/java/appeng/api/util/WorldCoord.java b/src/api/java/appeng/api/util/WorldCoord.java
index c53c0441c..0eee1035d 100644
--- a/src/api/java/appeng/api/util/WorldCoord.java
+++ b/src/api/java/appeng/api/util/WorldCoord.java
@@ -29,7 +29,7 @@ import net.minecraft.util.math.BlockPos;
/**
* Represents a relative coordinate, either relative to another object, or
* relative to the origin of a dimension.
- *
+ *
* If the given TileEntity is not of the right type for this block, the state is
* returned unchanged, this is also the case if the given block state does not
* belong to this block.
@@ -300,7 +299,7 @@ public abstract class AEBaseTileBlock extends AEBas
/**
* Reimplement this in subclasses to allow tile-entities to update the state of
* their block when their own state changes.
- *
+ *