Skip to content

BRomans/BrainForm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BrainForm

BrainForm is an experimental Unity platform game designed to be controlled with Brain–Computer Interface (BCI) commands.
It integrates the Unicorn SDK to translate neural signals into action to control the player's avatar. The main purpose of BrainForm is to enable scalable and controlled data collection.


🖼️ Preview

BrainForm Preview
Main view of the game. Flashing targets allow the player to shot lasers and unlock doors.


🧪 Research Context

BrainForm was designed to explore two main questions:

  1. How do users develop BCI control skills over repeated gameplay sessions?
  2. What are the perceptual and performance-related impacts of two different visual stimulation textures (with a focus on visual fatigue)?

📊 Experimental Setup

  • Within-subject design
  • Multiple gameplay runs
  • Two BCI tasks of varying complexity
  • Post-session self-report questionnaires

⚙️ Features

  • Real-time EEG input via the Unicorn SDK
  • Designed for scalable collections of raw EEG and in-game performance metrics
  • Neural command mapping to two game mechanics
  • Tutorial and experimental level
  • Extensible design
  • Automatically save experiment logs in the Experiment folder

🧩 Requirements

  • Unity 2022.3
  • Unicorn SDK (installed and configured)
  • Unicorn Hybrid Black EEG device
  • Windows platform

🚀 Installation & Setup

  1. Clone or download this repository:

    git clone https://github.com/BRomans/BrainForm.git
  2. Open the project in Unity 2022.3.

  3. Import the Unicorn EEG SDK:

    • Download the SDK from the official g.tec Unicorn website
    • In Unity, go to Assets → Import Package → Custom Package
    • Select the UnicornSDK.unitypackage file and import all dependencies
  4. Connect your EEG device:

    • Power on your Unicorn Hybrid Black (or compatible hardware)
    • Verify connection using the Unicorn Suite (optional)
    • Ensure data streaming is enabled before starting the Unity scene
  5. Run the scene:

    • Open the main scene (Scenes/Menu.unity)
    • First go to Setup BCI
    • When ready hit Play!

🧠 Usage

  1. Download or build the application
  2. Double click on the .exe file
  3. Go the the Setup BCI scene and follow the instructions
  4. Go back and hit Play, pick your character and enjoy

🧑‍💻 Authors

Team BrainForm

  • Michele Romani – Lead Scientits / Unity Development / BCI Integration
  • Devis Zanoni – Game Designer / Unity Development/ Data Collection

📄 License

This project is released under the MIT License.
See LICENSE for more details.


Acknowledgments

All the participants that contributed to the data collection and all pilot testers for their precious feedback.


Contributing

If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.

  1. Fork the project.
  2. Create a new branch.
  3. Make your changes and commit them.
  4. Push to the branch and create a pull request.

Cite This Work

This project is freely available to anyone and is not intended for commercial use. If you use this project for academic purposes, please cite the original authors.

About

BrainForm is an experimental Unity platform game designed to be controlled with Brain–Computer Interface (BCI) commands.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages