iv4xr Demo

This is a demo for the iv4xr Agent-based Testing Framework, demonstrating that iv4xr test agents can control a game called Lab Recruits to perform fome testing tasks. The game is included as binary; else you can build it yourself from its repository.

Work in progress notice. Keep in mind that the work here is still in progress. Things may look ugly while we are working on them, and things may change.

What is the demo? A set of JUnit test classes demonstrating how iv4xr test agents are used to implement a number of testing tasks for the game Lab Recruits. These classes are located in src/test/java/agents/demo. You can simply run them, or modify them yourself. When you run them you don't usually see anything because the tests run pretty fast. You can insert pause-points yourself (e.g. using console-read).

The Lab Recruits Game. It is a 3D game (a screenshot is shown above) written for the purpose of testing AI (like the AI of our iv4xr test agents). It features custom level that you can define yourself through a CSV file. Keep in mind that the game is also work in progress. More about this game can be found in its repository.

Deploying the demo

The demo classes are in src/test/java/agents/demo. The demos are by default non-visual (you don't literally see the game runs). Set the variable TestSettings.USE_GRAPHICS in the corresponding demo-class to true if you want it to be visual.

• Eclipse

  This will allow you to run/modify/rerun the demo classes. Import the project into Eclipse as a maven project. The demo classes are in src/test/java/agents/demo. You can run them as junit tests.

• Maven

  This is if you just want to check that the project builds and that all its tests pass. Just do mvn compile and mvn test at the project root.

Other documentations

• For iv4xr team: World Object Model
• For iv4xr team: where to find goals and tactic
• For others: basic interface to control Lab Recruits

What's in the package

• ./src the source files. It follows Maven's convention, so the root of the source files is in src/main/java and the root of tests' source files is in src/test/java.
• ./gym contains the binary of the Lab Recruits game (macos and windows).
• ./src/test/resources/levels contain sample level definitions for Lab Recruits.

Contributors

Computer Science students from Utrecht University: Adam Smits, August van Casteren, Bram Smit, Frank Hoogmoed, Jacco van Mourik, Jesse van de Berg, Maurin Voshol, Menno Klunder, Stijn Hinlopen, Tom Tanis. Game Artists from Mediacollege Amsterdam: Quinto Veldhuyzen, Sophie Meester. Others: Wishnu Prasetya.