Class ChannelDataAccessor

java.lang.Object
com.gtnewhorizon.structurelib.alignment.constructable.ChannelDataAccessor

public class ChannelDataAccessor extends Object
Provide accessor methods for channel data from trigger item. Channels section on overview
  • Method Details

    • withChannel

      public static ItemStack withChannel(ItemStack masterStack, String channel)
      Return a trigger item that
      • Still carry all the subchannel in some unspecified ways
      • Have its master channel data replaced with specified subchannel's data
      If given subchannel does not exist, masterStack may or may not be returned to save performance. Code within StructureLib can depend on this behavior, you cannot.
      Parameters:
      masterStack - trigger item. can be the return value of another withChannel(net.minecraft.item.ItemStack, String) call
      channel - subchannel to use. will use current master channel data instead if this channel does not exist Note: all channel identifiers are supposed to be lower case and not empty.
      Returns:
      a trigger item with new master channel
    • hasSubChannel

      public static boolean hasSubChannel(ItemStack masterStack)
      Check if given trigger item contains any subchannel
      Parameters:
      masterStack - trigger stack to check
      Returns:
      true if contains any subchannel
    • hasSubChannel

      public static boolean hasSubChannel(ItemStack masterStack, String channel)
      Check if given trigger item contains specified subchannel
      Parameters:
      masterStack - trigger stack to check
      channel - channel identifier. Note: all channel identifiers are supposed to be lower case and not empty.
      Returns:
      true if contains specified subchannel
    • getChannelData

      public static int getChannelData(ItemStack masterStack, String channel)
      Get the subchannel data from given trigger item. Will use master channel instead if not present.
      Parameters:
      masterStack - trigger stack to query from
      channel - channel identifier. Note: all channel identifiers are supposed to be lower case and not empty.
      Returns:
      channel data
    • setChannelData

      public static void setChannelData(ItemStack masterStack, String channel, int data)
      Set the subchannel data on given trigger item
      Parameters:
      masterStack - trigger stack to check
      channel - channel identifier. Note: all channel identifiers are supposed to be lower case and not empty.
      data - positive subchannel data
    • unsetChannelData

      public static void unsetChannelData(ItemStack masterStack, String channel)
      Clear the given subchannel from given trigger item, if it exists
      Parameters:
      masterStack - trigger stack to unset
      channel - channel identifier. Note: all channel identifiers are supposed to be lower case and not empty.
    • wipeChannelData

      public static void wipeChannelData(ItemStack masterStack)
      Wipe all subchannel data on given trigger item
      Parameters:
      masterStack - trigger stack to wipe
    • iterateChannelData

      public static Stream<Map.Entry<String,Integer>> iterateChannelData(ItemStack masterStack)
      Iterate over all subchannel data on trigger stack. Does not include master channel!!
      Parameters:
      masterStack - trigger stack to check
      Returns:
      A java8 stream of pairs. Key is channel identifier and value is channel data. Pairs do not support mutation nor removal. Can still cause ConcurrentModificationException if underlying channel data is modified while stream is working.
    • countChannelData

      public static int countChannelData(ItemStack masterStack)
      Get the number of subchannels present on given trigger item. Does not include master channel.
      Parameters:
      masterStack - trigger stack to query from
      Returns:
      subchannel count