For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /server-gametest/functions/registerAsync.md.

Function: registerAsync()

registerAsync(testClassName, testName, testFunction): RegistrationBuilder

World Mutation Early Execution Beta

Parameters

testClassName

string

Name of the class of tests this test should be a part of.

testName

string

Name of this specific test.

testFunction

(arg0) => Promise<void>

Implementation of the test function.

Returns

RegistrationBuilder

Returns a RegistrationBuilder object where additional options for this test can be specified via builder methods.

Remarks

注册一个为异步执行而设计的新 GameTest 函数。此 GameTest 将可以在 Minecraft 中通过 /gametest run [testClassName]:[testName] 使用。

Registers a new GameTest function that is designed for asynchronous execution. This GameTest will become available in Minecraft via /gametest run [testClassName]:[testName].

Example

simpleMobAsyncTest.ts

import * as gameTest from '@minecraft/server-gametest';

gameTest
  .registerAsync('StarterTests', 'simpleMobTest', async (test: gameTest.Test) => {
    const attackerId = 'fox';
    const victimId = 'chicken';

    test.spawn(attackerId, { x: 5, y: 2, z: 5 });
    test.spawn(victimId, { x: 2, y: 2, z: 2 });

    test.assertEntityPresentInArea(victimId, true);

    test.succeedWhen(() => {
      test.assertEntityPresentInArea(victimId, false);
    });
  })
  .maxTicks(400)
  .structureName('gametests:mediumglass');