Get Started

 

Getting Started with FAtiMA-Toolkit

FAtiMA Toolkit is a collection of tools/assets designed for the creation of characters with social and emotional intelligence. Using it will allow you to create interesting, believable and engaging characters that appraise events and make decisions on their own.

The FAtiMA framework is available as a C# library that can be easily integrated into several different development engines. FAtiMA Toolkit can be, and is, used in commercial video games, serious games, educational robots, virtual reality experiences, among others.

By incorporating the FAtiMA library authors are able to add different levels of intelligence to their characters such as decision making capabilities, emotional responses, emotional appraisal of events, belief and memory systems, dialogue, etc.

These layers are difficult to author using code alone, this serves as motivation to create the Integrated Authoring Tool – a Windows forms application where authors can easily design and create their scenarios and the characters within them.

The Integrated Authoring Tool works as an independent user interface application where authors can not just create believable agents but also design interactable and socially interesting scenarios. Additionally the Toolkit has several different debugging features such as a Simulator, a Dialogue Tree Generator, a World Model among others.

 

Downloads:

FAtiMA-Toolkit is frequently updated, as such we use Github’s “Release” system. 
Additionally, there is a large amount of material available to users/authors, we hope the following table clarifies their purpose and where you can find them. Download them as you see fit.

Get Latest Toolkit  Version: v5.0

FAtiMA-Toolkit Authoring Tool: Create scenarios and emotional characters files using a User Interface. Last updated January 2023 Download FAtiMA Authoring Tools
FAtiMA-Toolkit:
The latest version of FAtiMA-Toolkit, contains both the authoring tools and the FAtiMA Engine. To start authoring intelligent agent scenarios run the “FAtiMA-Toolkit.exe” file. Last updated September 2022		 Download FAtiMA Toolkit
FAtiMA-Engine:
Import FAtiMA as an external library to your project using its dll files. Last updated January 2023		 Download Dll Files
FAtiMA-Toolkit-UnityDemos: Take a look at some Unity Demos to better understand its capabilities and integration FAtiMA-Toolkit-Unity Demos
FAtiMA’s Github page. here you can find the source code for out tool, including some code examples is available and make your own modifications FAtiMA Toolkit Github Page
FAtiMA Starter Kit: a simple Unity Project that developers can use as a sandbox or a starting point. It features both a simple and a multi-agent scene. Download FAtiMA Starter Kit
FAtiMA Starter Kit Github Repository, the source code of the Unity Project that developers can use as a sandbox or a starting point. It features both a simple and a multi-agent scene. FAtiMA Starter Kit Github

 

Once you download the latest release of FAtiMA Toolkit, you might be a bit lost, so what do all these files ?

As we’ve mentioned FAtiMA is a C# library as a result its source code is a C# Solution/Project. Here are the most important files you can find there:

  • “FAtiMA-Toolkit.sln”: This is the FAtiMA Solution, it encapsulates all the assets used by FAtiMA
  • “Executables” Folder: In this folder you can find the executable file for each component within FAtiMA including the most important one the “Integrated Authoring Tool”.
  •  “AuthoringTols/AuthoringTools.sln”: This is the C# Solution for the Authoring Tools. It is user interface focused and serves as an addition to the original solutions. Keep in mind that in order to be able to compile this part of the code it is important that the FAtiMA Solution is also compiled.
  •  “Tutorials”: In this folder we present different code tutorials for the different assets, these are also available once you’ve loaded the FAtiMA-Toolkit solution.
  • “ExportAuthTool.bat”: This is a script that generates the Authoring Tool Executable files from the AuthoringTools.sln compiled code.
  • “ExportDlls.bat” :  This is a script that generates an C# library (.dll files) using the compiled code from the FAtiMA Solution.

If you prefer to use the latest experimental version, you can do so, by clicking the “Clone or download” button. Use this version at your own risk, however you can take a look at its current state by checking the Unit Tests in its GitHub page.

FAtiMA Toolkit is an open-source project, feel free to play around, change remove and add your own code to it. 

Click here to learn more about the source files

 

Installation:

FAtiMA-Toolkit requires no installation. By opening the “Executable Folder” you can start using the Toolkit and all of its components.

 

Tutorials:

In this website you can find several in-depth tutorials on how to use the different Toolkit components, we advise new users to start at Tutorial 1: What is FAtiMA-Toolkit and continue through that order.

If you are looking for information regarding one particular component, you can find it in the top right column of this page under the “Tutorials”.

Additionally, under “Other Posts:” you can find more “articles” detailing details on: 

Training Materials

 

Workshop Videos (January 2021)

Using the Integrated Authoring Tool

Using FAtiMA Unity Starter Kit

To learn more about FAtiMA Toolkit and for additional learning content check the posts on the right sidebar of this page

 

No announcement available or all announcement expired.