Interface TrialSpawner

All Superinterfaces:
BlockState, Metadatable, PersistentDataHolder, TileState

@Experimental public interface TrialSpawner extends TileState
Represents a captured state of a trial spawner.
  • Method Details Link icon

    • getCooldownLength Link icon

      int getCooldownLength()
      Gets the length in ticks the spawner will stay in cooldown for.
      Returns:
      the number of ticks
    • setCooldownLength Link icon

      void setCooldownLength(int ticks)
      Sets the length in ticks the spawner will stay in cooldown for.
      Parameters:
      ticks - the number of ticks
    • getRequiredPlayerRange Link icon

      int getRequiredPlayerRange()
      Get the maximum distance a player can be in order for this spawner to be active.
      If this value is less than or equal to 0, this spawner is always active (given that there are players online).
      Default value is 16.
      Returns:
      the maximum distance a player can be in order for this spawner to be active.
    • setRequiredPlayerRange Link icon

      void setRequiredPlayerRange(int requiredPlayerRange)
      Set the maximum distance a player can be in order for this spawner to be active.
      Setting this value to less than or equal to 0 will make this spawner always active (given that there are players online).
      Parameters:
      requiredPlayerRange - the maximum distance a player can be in order for this spawner to be active.
    • getTrackedPlayers Link icon

      @NotNull Collection<Player> getTrackedPlayers()
      Gets the players this spawner is currently tracking.

      Note: the returned collection is immutable, use startTrackingPlayer(Player) or stopTrackingPlayer(Player) instead.

      Returns:
      a collection of players this spawner is tracking or an empty collection if there aren't any
    • isTrackingPlayer Link icon

      boolean isTrackingPlayer(@NotNull Player player)
      Checks if this spawner is currently tracking the provided player.
      Parameters:
      player - the player
      Returns:
      true if this spawner is tracking the provided player
    • startTrackingPlayer Link icon

      void startTrackingPlayer(@NotNull Player player)
      Force this spawner to start tracking the provided player.

      Note: the spawner may decide to stop tracking this player at any given time.

      Parameters:
      player - the player
    • stopTrackingPlayer Link icon

      void stopTrackingPlayer(@NotNull Player player)
      Force this spawner to stop tracking the provided player.

      Note: the spawner may decide to start tracking this player again at any given time.

      Parameters:
      player - the player
    • getTrackedEntities Link icon

      @NotNull Collection<Entity> getTrackedEntities()
      Gets a list of entities this spawner is currently tracking.

      Note: the returned collection is immutable, use startTrackingEntity(Entity) or stopTrackingEntity(Entity) instead.

      Returns:
      a collection of entities this spawner is tracking or an empty collection if there aren't any
    • isTrackingEntity Link icon

      boolean isTrackingEntity(@NotNull Entity entity)
      Checks if this spawner is currently tracking the provided entity.
      Parameters:
      entity - the entity
      Returns:
      true if this spawner is tracking the provided entity
    • startTrackingEntity Link icon

      void startTrackingEntity(@NotNull Entity entity)
      Force this spawner to start tracking the provided entity.

      Note: the spawner may decide to stop tracking this entity at any given time.

      Parameters:
      entity - the entity
    • stopTrackingEntity Link icon

      void stopTrackingEntity(@NotNull Entity entity)
      Force this spawner to stop tracking the provided entity.

      Note: the spawner may decide to start tracking this entity again at any given time.

      Parameters:
      entity - the entity
    • isOminous Link icon

      boolean isOminous()
      Checks if this spawner is using the ominous TrialSpawnerConfiguration.
      Returns:
      true is using the ominous configuration
    • setOminous Link icon

      void setOminous(boolean ominous)
      Changes this spawner between the normal and ominous TrialSpawnerConfiguration.
      Parameters:
      ominous - true to use the ominous TrialSpawnerConfiguration, false to use the normal one.
    • getNormalConfiguration Link icon

      @NotNull TrialSpawnerConfiguration getNormalConfiguration()
      Gets the TrialSpawnerConfiguration used when isOminous() is false.
      Returns:
      the TrialSpawnerConfiguration
    • getOminousConfiguration Link icon

      @NotNull TrialSpawnerConfiguration getOminousConfiguration()
      Gets the TrialSpawnerConfiguration used when isOminous() is true.
      Returns:
      the TrialSpawnerConfiguration