Upgrade Process

This page covers updating an existing project to a newer version of the tool. For a first-time install, see Requirements and Installation instead.

Before you update

Back up your project. Source control is ideal; a copy of the folder works too. Importing a package cannot be undone from inside Unity.

Note which version you are coming from — the steps below differ for a 0.13.0 upgrade.

The general procedure

Check for a new version in the Unity Package Manager under My Assets. When one is available:

1. Copy your Assets/BardTreeLtd/Resources folder somewhere outside the Unity project. This holds your behaviour trees, module settings and other authored content.
2. Delete the module folders you are replacing under Assets/BardTreeLtd/ — CIVIL-AI-SYSTEM, Shared, SAVE-SYSTEM and SENSE-SYSTEM. Leave Resources in place.
3. Import the new version through the Package Manager.
4. Merge your saved Resources folder back in, keeping your own files.
5. Keep the new module settings asset rather than your old one, then reapply your settings by hand. Settings assets gain and lose fields between versions, and an old one can carry stale values.
6. On recompile, if an update window appears, follow the steps it offers.

note

Since 0.13.0 the asset installs as several sibling module folders under Assets/BardTreeLtd/, not a single CIVIL-AI-SYSTEM folder. If you delete only CIVIL-AI-SYSTEM, the other modules are left at their old versions and you will get compile errors from the mismatch.

Upgrading to 0.13.0

0.13.0 restructured the asset into modules and moved the editor menu under a shared BardTreeLtd root. Two extra steps after the import:

1. Repair your scenes

Open each of your scenes and run:

BardTreeLtd/Civil AI/Tool/Repair Scene For V0.13.0

The scene entry point changed from ModuleService to BardTreeModuleBootstrap. The repair tool updates existing scene objects for you.

2. Remove the legacy readme files

BardTreeLtd/Help/Remove Legacy Readme Files

Importing a .unitypackage never deletes anything, so the old Readme.asset and TutorialInfo folder survive an in-place upgrade even though 0.13.0 replaced them with the Welcome window (BardTreeLtd/Welcome).

Also worth knowing

• The editor menu moved. Everything now lives under BardTreeLtd/Civil AI/... rather than a top-level CIVIL-AI-SYSTEM menu.
• Render banding defaults changed to a single 100-unit group with culling from band 1. If you tuned these, check them after upgrading.

See the changelog for the full list.

Run into issues?

Restore from the backup you took and try again.

If it still does not work, reach out on Discord in the support channel with as much detail as you can — the version you came from, the version you moved to, and the steps you took.