Basic tunnel structure re-add

Author: robotgryphon

src/api/java/dev/compactmods/machines/api/tunnels/EnumTunnelSide.java

@@ -0,0 +1,31 @@
+package dev.compactmods.machines.api.tunnels;
+
+import javax.annotation.Nonnull;
+import java.util.Optional;
+import dev.compactmods.machines.api.teleportation.IDimensionalPosition;
+import net.minecraft.core.Direction;
+import net.minecraft.world.level.LevelReader;
+import net.minecraft.world.level.block.state.BlockState;
+
+/**
+ * Provides information on positions and states a tunnel is connected to.
+ * Accessed via a sided capability lookup on either the tunnel block or a machine block.
+ */
+public interface ITunnelConnection {
+
+    @Nonnull
+    IDimensionalPosition getConnectedPosition();
+
+    @Nonnull
+    BlockState getConnectedState();
+
+    Optional<? extends LevelReader> getConnectedWorld();
+
+    /**
+     * Gets the connection information for sidedness.
+     *
+     * From a machine block, gets the direction of the block adjacent to the tunnel.
+     * From a tunnel block, gets the side of the machine the tunnel is bound to.
+     */
+    Direction getConnectedSide();
+}

src/api/java/dev/compactmods/machines/api/tunnels/ICapableTunnel.java

@@ -11,8 +11,10 @@ public abstract class TunnelDefinition extends ForgeRegistryEntry<TunnelDefiniti
      */
     public static final int NO_INDICATOR_COLOR = 3751749;
 
-    public abstract int getTunnelRingColor();
+    public static final int IMPORT_COLOR = 0xff2462cd;
+    public static final int EXPORT_COLOR = 0xffe6a709;
 
+    public abstract int getTunnelRingColor();
     /**
      * Gets the color for the indicator at the top-right of the block texture.
      *

src/api/java/dev/compactmods/machines/api/tunnels/IItemTunnel.java

@@ -0,0 +1,7 @@
+package dev.compactmods.machines.api.tunnels.item;
+
+/**
+ * Interface that allows for items to push into a machine's item buffer.
+ */
+public interface IItemExportTunnel extends IItemTunnel {
+}

src/api/java/dev/compactmods/machines/api/tunnels/ITunnelConnection.java

@@ -0,0 +1,7 @@
+package dev.compactmods.machines.api.tunnels.item;
+
+/**
+ * Interface that allows for items to pull from a machine's item buffer.
+ */
+public interface IItemImportTunnel extends IItemTunnel {
+}

src/api/java/dev/compactmods/machines/api/tunnels/ITunnelConnectionInfo.java

@@ -0,0 +1,8 @@
+package dev.compactmods.machines.api.tunnels.item;
+
+/**
+ * Marker interface that specifies that one of the tunnel sides supports movement of items.
+ */
+public interface IItemTunnel {
+
+}

src/api/java/dev/compactmods/machines/api/tunnels/TunnelDefinition.java

@@ -1,6 +1,6 @@
 package dev.compactmods.machines.api.tunnels.redstone;
 
-import dev.compactmods.machines.api.tunnels.ITunnelConnectionInfo;
+import dev.compactmods.machines.api.tunnels.ITunnelConnection;
 
 /**
  * A redstone reader reads a redstone value from outside the machine (from a given side).
@@ -13,7 +13,7 @@ public interface IRedstoneReaderTunnel extends IRedstoneTunnel {
      * @param connectionInfo
      * @return
      */
-    default int getPowerLevel(ITunnelConnectionInfo connectionInfo) {
+    default int getPowerLevel(ITunnelConnection connectionInfo) {
         return 0;
     }
 
@@ -25,9 +25,9 @@ default int getPowerLevel(ITunnelConnectionInfo connectionInfo) {
      * @param connectionInfo Connection information for the tunnel instance.
      * @return
      */
-    default boolean canConnectRedstone(ITunnelConnectionInfo connectionInfo) {
+    default boolean canConnectRedstone(ITunnelConnection connectionInfo) {
         return true;
     }
 
-    default void onPowerChanged(ITunnelConnectionInfo connectionInfo, int latestPower) {}
+    default void onPowerChanged(ITunnelConnection connectionInfo, int latestPower) {}
 }