Scene Setup

This guide matches the current module bootstrap workflow. For the fastest route, pair it with Getting Started.

This page describes the minimum scene ingredients required for a working setup.

The current runtime entry point

For the current source, the scene should use BardTreeModuleBootstrap as the runtime entry point.

Add it to an empty GameObject in your scene.

This bootstrap is responsible for:

• creating the shared service registry
• registering installed module registrars
• initializing modules in the correct order
• exposing shared services to runtime and editor tooling

Minimum checklist

Your scene should contain or reference all of the following.

1. Bootstrap

• one GameObject with BardTreeModuleBootstrap

2. Module settings

Open CIVIL-AI-SYSTEM -> Module Settings and make sure the settings asset exists.

For a first working setup, check these areas:

• nav mode
• start time and day
• work behaviour repository selection
• need behaviour repository selection
• character pool service
• item name, type, and size collections

3. At least one valid building setup

You normally need:

• one house
• one workplace with at least one valid work role

Buildings provide the simulation with places that agents can own, use, and travel to.

They also need valid colliders so the scene has reliable physical bounds for building-related setup.

4. At least one population region

Population regions define where agents are allowed to exist and what content they can use.

You can create a region through CIVIL-AI-SYSTEM -> Template and Actions.

5. Behaviour content

Agents need behaviour trees before they can do meaningful work.

At minimum, create:

• one work behaviour tree
• one need behaviour tree

Then assign them in Module Settings.

6. Character pool data

The region must have valid characters to spawn. Make sure your pool contains usable entries and that those entries satisfy any configured requirements.

7. Navigation

Agents need valid navigation support that matches the nav mode configured in Module Settings.

If the world is otherwise correct but agents stand still or never complete move-based actions, inspect navigation first.

A reliable first-scene recipe

If you want the easiest first success, use this exact shape:

1. Add BardTreeModuleBootstrap to the scene.
2. Create module settings.
3. Assign all three item collections.
4. Create one simple work tree.
5. Create one simple need tree.
6. Create one house.
7. Create one workplace with one role.
8. Create one population region.
9. Assign a character pool.
10. Set up navigation and press Play.

Useful editor entry points

• CIVIL-AI-SYSTEM -> Help -> Getting Started
• CIVIL-AI-SYSTEM -> Module Settings
• CIVIL-AI-SYSTEM -> Behaviour Tree Editor
• CIVIL-AI-SYSTEM -> Template and Actions

Resource locations

The current source uses Assets/BardTreeLtd/Resources as the canonical resource root.

That matters when you are looking for generated or module-owned assets such as:

• CivilAI settings and behaviour-related assets
• Dialogue assets
• shared requirements or shared module resources

If you plan to use Dialogue

Dialogue is a separate paid tool that integrates with CIVIL-AI-SYSTEM through shared services and data.

For combined projects, finish the Civil AI setup first, especially item collections, then continue with Dialogue Setup.

If something is not working

Start with Common Issues.