Annotation Interface GameTest

@Retention(RUNTIME) @Target(METHOD) @Documented public @interface GameTest
GameTest is an annotation that can be used to mark a method as a game test.

GameTest methods must be public not static, return void and take exactly one argument of type GameTestHelper.

The values in this class directly correspond to the values in TestData.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    String
    environment
    A namespaced ID of an entry within the Registries.TEST_ENVIRONMENT registry.
    boolean
    manualOnly
    When set the test must be run manually.
    int
    maxAttempts
    The number of times the test should be re attempted if it fails.
    int
    maxTicks
    The maximum number of ticks the test is allowed to run for.
    int
    padding
    The number of empty block layers to place around the structure as padding.
    boolean
    required
    Whether the test is required to pass for the test suite to pass.
    int
    requiredSuccesses
    The number of times the test should be successfully ran before it is considered a success.
    net.minecraft.world.level.block.Rotation
    rotation
    The rotation of the structure when placed.
    int
    setupTicks
    The number of ticks to wait before starting the test after placing the structure.
    boolean
    skyAccess
    Whether the test should have sky access.
    String
    structure
    A namespaced ID pointing to a structure resource in the modid/gametest/structure/ directory.

  • Element Details

    • environment

      String environment
      A namespaced ID of an entry within the Registries.TEST_ENVIRONMENT registry.
      Default:
      "minecraft:default"

    • structure

      String structure
      A namespaced ID pointing to a structure resource in the modid/gametest/structure/ directory.

      Defaults to an 8x8 structure with no blocks.

      Default:
      "fabric-gametest-api-v1:empty"

    • maxTicks

      int maxTicks
      The maximum number of ticks the test is allowed to run for.
      Default:
      20

    • setupTicks

      int setupTicks
      The number of ticks to wait before starting the test after placing the structure.
      Default:
      0

    • required

      boolean required
      Whether the test is required to pass for the test suite to pass.
      Default:
      true

    • rotation

      net.minecraft.world.level.block.Rotation rotation
      The rotation of the structure when placed.
      Default:
      NONE

    • manualOnly

      boolean manualOnly
      When set the test must be run manually.
      Default:
      false

    • maxAttempts

      int maxAttempts
      The number of times the test should be re attempted if it fails.
      Default:
      1

    • requiredSuccesses

      int requiredSuccesses
      The number of times the test should be successfully ran before it is considered a success.
      Default:
      1

    • skyAccess

      boolean skyAccess
      Whether the test should have sky access. When false the test will be enclosed by barrier blocks.
      Default:
      false

    • padding

      int padding
      The number of empty block layers to place around the structure as padding.
      Default:
      1