2.0.2 • Public • Published

    The BiomotionLab Toolkit for Unity Experiments (bmlTUX)

    An experimental framework for experiments in Unity

    The BioMotionLab Toolkit for Unity Experiments helps you design and run experiments in Unity quickly and iteratively without fussing over coding details. You define your variables and experiment structure, and the toolkit will automatically create a table of trials to run. You can customize what happens before, during, and after a trial, block of trials, or the experiment itself, while not having to worry about the details of setting up and running your experiment. You configure an experimental design, write custom behavior and functionality, and then the toolkit will automatically construct your experiment, create and run all required trials, and outputs the results to a file.

    For documentation and installation instructions see Here.

    If you use our work, please cite us.


    Adam O. Bebko
    Nikolaus F. Troje

    Center for Vision Research
    York University
    Toronto, Ontario, Canada


    Advances in virtual reality (VR) technology have made it a valuable new tool for vision and perception researchers since it offers a critical depth cue, active motion parallax. Coding VR experiments from scratch is difficult and time-consuming so researchers rely on software such as Unity game engine to create and edit virtual scenes. However, Unity lacks built-in tools for controlling experiments. Existing third-party add-ins require complicated scripts to define experiments. This can be difficult and requires advanced coding knowledge, especially for multifactorial experimental designs. In this paper, we describe a new free and open-source tool called the BiomotionLab Toolkit for Unity Experiments (bmlTUX) that provides a simple interface for controlling experiments in Unity. In contrast to existing tools, bmlTUX provides a graphical interface to automatically handle combinatorics, counterbalancing, randomization, mixed designs, and blocking of trial order. The toolbox works “out-of-the-box” since simple experiments can be created with almost no coding. Furthermore, multiple design configurations can be swapped with a drag-and-drop interface allowing researchers to test new configurations iteratively while maintaining the ability to easily revert to previous configurations. Despite its simplicity, bmlTUX remains highly flexible and customizable, catering to coding novices and experts alike.

    Download Paper

    In Press, submitted to i-Perception, available as pre-print on PsyArXiv:


    Bebko, A. O., & Troje, N. F. (2020 In Press) bmlTUX: Design and control of experiments in virtual reality. _i-Perception. preprint doi: 10.31234/ PsyArXiv:

     title={BMLtux: Design and control of experiments in virtual reality and beyond},
     author={Bebko, Adam O and Troje, Nikolaus F},


    npm i com.biomotionlab.tux

    DownloadsWeekly Downloads





    Creative Commons Attribution-NonCommercial-ShareAlike 4.0

    Unpacked Size

    5.08 MB

    Total Files


    Last publish


    • adambebko