Unity Installation Guide

This page contains detailed step-by-step instructions on setting up Entitas with the Unity game engine. If you still have questions after reading through this then please check out the FAQ, ask for help in the chat, or crate a new issue.

Step 1 - Prepare New Unity Project

Create and open a new Unity project. Then go to the Unity toolbar and select Assets>Open C# Project. This will open the default code editor associated with Unity and generate script assemblies needed by Entitas. You can then close or minimize the editor since we won't need it during setup.

Optional

Create a new folder in the root of your Unity project to hold the Entitas add-on. This is commonly named "Libraries" in most examples, but you can name it anything you want.

Step 2 - Import and Setup Entitas

Download the latest Entitas.zip found in Releases then open it and drag and drop the folder named Entitas (located under Assets/Entitas) into the folder you created earlier or into the root of your Unity project.

Wait for Unity to reload and you should now see a new section on the toolbar titled Tools, select that and choose Entitas>Preferences to open the Entitas preferences window.

In the Entitas preferences window press the button labeled Auto Import. You will then see a warning message, just select Continue and overwrite and all settings in the preferences window should now be automatically setup for you.

Step 3 - Test Code Generator

Press the big green button labeled Generate in the preferences window or use the hotkey Shift+Ctrl+G to verify that everything is setup correctly and to generate your first code.

If everything is working you should see a message in the console and a new folder inside your Unity project containing all generated files. By default this is located at Sources/Generated. If you get an error message instead, please read the FAQ for solutions to common issues.

All done. You're awesome! 🎉😉

Congratulations! You are now all ready to start creating amazing things with Entitas and Unity! To learn how to start making components, systems and game logic, check out the Tutorials and Examples sections.