Skip to main content
Version: 0.13.0

Introduction to CIVIL-AI-SYSTEM

New to the tool? Start with the Getting Started guide for the fastest path to a working scene.

CIVIL-AI-SYSTEM is a behaviour-driven simulation toolkit for building interactive worlds with agents that work, move, satisfy needs, and respond to the state of the scene.

The main idea is simple: you define the world, the available behaviours, and the rules around ownership, items, and places of interest. The system then uses that information to drive agent activity.

What the tool is good at​

  • simulating day-to-day NPC activity
  • assigning jobs and homes to agents
  • driving work and need behaviours through reusable trees
  • connecting actions to world objects such as buildings, items, and points of interest
  • giving you editor tooling so most iteration happens through content rather than code

How to use this wiki​

Different users will want different entry points.

What changed in the current workflow​

The current source uses a module bootstrap workflow rather than older scene setup advice that focused on a single scene service object.

For practical use, that means:

  • you should think in terms of installed modules and shared services
  • module settings are the main configuration surface
  • editor tooling depends on shared data being present and assigned correctly

Optional Dialogue integration​

Dialogue is a separate paid tool that can integrate with CIVIL-AI-SYSTEM.

If you are using both, start with your Civil AI world setup first, then read Dialogue Setup before opening the Dialogue editor.

Prerequisites​

There are real prerequisites: a supported Unity version, a render pipeline, and a few Unity packages. Requirements and Installation covers all of them, and is worth reading before anything else.

Beyond that, it helps if you are comfortable with:

  • GameObjects and components
  • ScriptableObject assets
  • scene navigation setup
  • reading console warnings and errors during setup

Unity's own beginner resources are a good starting point if needed: Unity Get Started

Reading tip​

Menu paths in this wiki are written the way Unity shows them, starting from the top menu bar. So BardTreeLtd/Civil AI/Module Settings means: click BardTreeLtd in the menu bar at the top of the editor, then Civil AI, then Module Settings.

Asset creation paths start with Assets > Create, which is the same menu you get by right-clicking in the Project window.

Next step​

Continue to Your First Scene to see the system running, then Getting Started to build one yourself.

Last updated on