Skip to main content

1. Create a New Unreal Engine 5 Project

Using the Epic Games Launcher, create a new Unreal Engine 5.5, 5.6 or 5.7 project of your choice. Launch the editor to initialize the engine files, then close the editor.
If you already have an Unreal Engine 5 project, you can use it instead.

Download and Install the Elisa Plugin

Start by downloading the Elisa Unreal Plugin:
  1. Download 👉 Elisa Unreal Plugin ZIP.
  2. Extract the plugin folder into your project’s Plugins directory.
    If the Plugins folder doesn’t exist, create it at the root of your Unreal project.
plugin-extraction.gif Next, re-open your Unreal project to verify the plugin installation.
You must restart Unreal Engine after enabling the plugin.
This is necessary for certain features to work correctly in later steps.

2. Request your Elisa API Key

You should have received your Elisa API key by email. If not, you can request access via the Elisa website.
👉 Get your Elisa API Key
Copy this key; you’ll need it in the next steps.

3. Get a Google API Key

Elisa uses Google for the included Landscaper agent:
  1. Visit 👉 Google AI Studio.
  2. Sign in with your Google account.
  3. Create an API key.
Save this key for later.

4. Set your Elisa API Key

In the engine, open the Elisa Settings Panel. Edit > Project Settings > Elisa Set your Elisa API Key there. Then press Enter. Image

5. Set your Google API Key

Still in the ⚙️Elisa Settings, under the Google category, click Set your Google API key. Then press Enter. Image

6. Register a new Project

Still in the**⚙️Elisa Settings**, under the Project category, click the Register a new Project button.
  • In Project Description, fill in a Project Name, then press Enter.
  • Once your project is registered, fill in the Description and press Enter.
Project Description
The Project Description should include basic information about its type, style, and usage.

7. Generate Your Asset Catalog

Elisa needs a catalog of assets from your project in order to understand what it can place. A catalog links asset metadata to Elisa’s AI system.
If you don’t yet have assets in your project, we recommend using the 👉 FANTASTIC - Village Pack.
To generate a catalog: In Catalog management, fill in a catalog Description and press Enter. Image
  • This should include key details about the assets style, theme, and intended usage.

Let an LLM do the writing for you!

Paste your asset pack URL into your favorite chat interface and use this prompt:
“Analyze every item in the catalog and write 3-5 sentences (60-120 words) that capture their shared stylistic and technical DNA. Cover dominant art styles/eras, modelling techniques, color palette and lighting mood, and any typical functional contexts. Omitting all file paths, IDs, prices, or seller names.”

Option 1:

1. Click the Generate Catalog button.

Download
  • Elisa scans your entire project files containing prefabs and meshes.
  • Press the Generate button.
Image

Option 2:

1. Select the assets you want Elisa to use.

  • You can select multiple assets or even entire folders directly in your Project Files.
For more detailed information on what assets you can use, see the Selecting the right assets page.

2. Right-click the selection and choose Add to Elisa Catalog.

Image

Having issues with catalog generation?

If you’re using a free Gemini API key, it may be due to rate or token limits.
👉 See common solutions here

8. Design with Elisa

Elisa uses surfaces to create layouts. You can choose or place any suitable surface, such as a plane or a landscape. You can also select multiple actors as a single surface area. Elisa will treat them as one continuous layout region. Right-click on your surface and choose: Design with Elisa For more information on surfaces: Here SurfacePlacementAndDesignWithElisa.gif

9. Send Your First Message

Now it’s time to create! In Elisa’s chat box, try typing: Add a cozy campsite with rocks, logs for seating, and a small campfire. Elisa will analyze the selected surface and start populating the scene with suitable assets from the catalog.

10. Switch Surface

You can create as many design sessions as you want! Design with Elisa on a returned asset to nest a new design session. Or place new surfaces to start creating new layouts! Go back to previous sessions and retrieve your chat history along with all of the elements Elisa placed, so you never lose anything you’ve worked on! Image Learn more about how to Work on Surfaces

11. You’re Up and Running with Elisa!

From here, you can:
  • Refine the scene using the chat (e.g., Add a surrounding forest, Make it spooky, etc.).
  • Switch surfaces and start new design sessions.
  • Upload your own catalogs! (see How to Generate your own Catalogs)
Need help or want to explore further? 👉 Visit the Full Documentation
👉 Check out the Discord
**Happy designing! **✨