Introduction

ScriptAI Editor ScriptAI Editor

The ScriptAI Editor is a GUI-based tool designed to allow the user to design and execute complex vehicle-to-vehicle interactions in the BeamNG virtual environment. Recreation of multi-vehicle real-world trajectory recordings can be produced, as can more-precise safety-critical scenarios involving two or three vehicles, such as emergency stopping procedures, general vehicle collisions, or tight lane-changing choreographies.

Various supported ScriptAI behaviors allow for the creation of time-based and speed-based vehicle trajectories, which can be combined together in a scenario. Vehicle trajectories can be edited in space-time directly on the map with the mouse, and supported with a dedicated window for each trajectory, where operations such as spline-fitting, velocity-matching, and behaviour can be selected.

A seperate space-time Trajectory can be created for the scene camera, which can be placed on top of the scenario to provide smoothly-executing camera footage of the vehicle-vehicle interactions. With full translational and rotation gimbal controls, full rotational control is possible. Another dedicated window exists to assist with this, which has similar functionality to vehicle trajectory editing.

A Vehicles List window displays all vehicles currently loaded into the simulator, and highlights their status with respect to the ScriptAI scenario currently being worked on in the ScriptAI Editor. The linking between scene vehicles and scene trajectories is a key feature of the ScriptAI Editor. Recordings of new trajectories, whereby the user manually drives a vehicle in real time, can be accomplished directly through this window.

A Trajectory List window displays all vehicle trajectories which have been recorded, imported, or manually drawn-in (the three options for generating vehicle trajectory content). These can be cued and auditioned through simple attachment and detachment from any of the scene vehicles. Many more trajectories can exist in the trajectory list than there are number of vehicles in the scene, for this purpose of audition.

ScriptAI Editor ‘sessions’ comprising all vehicles, all loaded vehicle trajectories, and the camera path trajectory can be saved to file, as .json, and recalled later. Individual trajectories can also be saved and loaded in BeamNG’s standard ScriptAI format, where they can be used with other tools.

These pages provide some depth on each of the features described above, including full descriptions for each of the available windows in the ScriptAI Editor tool.

Last modified: 20/9/2023 11:35

Any further questions?

Join our discord