modl.ai
Bots

The AI Engine uses bots to interact with your game. Use the Unity package or Unreal plugin to configure the bots for your game and then choose a bot type when you set up a test to run on the platform. For further information, refer to Bot Types below.

Use the Unity or Unreal game engine integration instructions to add a basic modl:test configuration to your project. If you want to use modl:test throughout your project, it is strongly recommended that you utilize modl.ai’s integration service.

The table below describes the bot configuration workflow. For more information, refer to the bot configuration guidelines for both Unity and Unreal.

Task Description
Select a character to use as your bot Choose a player prefab or actor to use as your bot. You should choose a character that can access the entire level.
Enable the bot to interact with your game Provide the bot with input variables that a player would use when they play the game. Input variables can include input keys or UI input.
Tell your bot about it’s environment Add variables to the exploration space to let the bot know how to determine whether its environment has changed. Use the exploration space to set up the game state intervals. For more information refer to Exploration space.
Tell your bot what you want to know Add game state variables to receive information about what your bot did during the test run. Game state variables show on your test report along with performance details and custom events. For further information, refer to Game state variables.
Provide your bot with a level to explore Add your levels, level loading information and map images to your level configuration to tell your bot which level to explore.

Bot types

Exploratory bot

modl:test uses the exploratory algorithm to drive the exploratory bot. The exploratory bots act as virtual testers that explore and interact with your content during a test run. The exploratory bots automatically report on crashes and errors but you can add custom events, terminal states and waypoints to your game code to create a more robust testing environment. You don’t need to train the QA bot as it will learn as it navigates through your game.

Directed Explorer

The Direct Explorer uses waypoints to direct your bot through your game. Position waypoints around areas that you want your bot to explore or along a route that you want your bot to take.

To set up a Directed Explorer in your game refer to Set up the Directed Explorer (Unreal) or Set up the Directed Explorer (Unity).

Free Explorer

The Free Explorer explores your game without any guidance. Use the free explorer to test the overall performance of your game as well as any content it comes into contact with. The Free Explorer bot does not require any additional set up.