A test helper to instantiate a full headless TerasologyEngine instance in JUnit tests.
For more examples see the test suite.
Here's an example taken from the test suite:
@ExtendWith(MTEExtension.class)
@Dependencies("MyModule")
@UseWorldGenerator("CoreWorlds:flat")
public class ExampleTest {
@In
private WorldProvider worldProvider;
@In
private BlockManager blockManager;
@In
private EntityManager entityManager;
@In
private ModuleTestingHelper helper;
@Test
public void testExample() {
// create some clients (the library connects them automatically)
Context clientContext1 = helper.createClient();
Context clientContext2 = helper.createClient();
// wait for both clients to be known to the server
helper.runUntil(()-> Lists.newArrayList(entityManager.getEntitiesWith(ClientComponent.class)).size() == 2);
assertEquals(2, Lists.newArrayList(entityManager.getEntitiesWith(ClientComponent.class)).size());
// run while a condition is true or until a timeout passes
boolean timedOut = helper.runWhile(1000, ()-> true);
assertTrue(timedOut);
// send an event to a client's local player just for fun
clientContext1.get(LocalPlayer.class).getClientEntity().send(new ResetCameraEvent());
// wait for a chunk to be generated
helper.forceAndWaitForGeneration(new Vector3i());
// set a block's type and immediately read it back
worldProvider.setBlock(Vector3i.zero(), blockManager.getBlock("engine:air"));
assertEquals("engine:air", worldProvider.getBlock(Vector3f.zero()).getURI().toString());
}
}You can use a TestEventReceiver to inspect events fired against the engine context.
TestEventReceiver receiver = new TestEventReceiver<>(context, DropItemEvent.class, (event, entity) -> {
// do something with the event or entity
});Conventionally, we use while (condition) to wait for delaying action. This can be done in MTE test by using
runWhile() method. This runs the test engine while the condition is true.
runWhile(() -> true);Conversely, for running the enging until some condition is true, use runUntil()
runUntil(() -> false);Check the JavaDoc and test suite for more usage examples.
By default MTEExtension will reuse the same engine instance for all test cases. If you want to create a new engine
instance for every test (and wait much longer) try IsolatedMTEExtension.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent