Important

First of all, it is highly recommended that users backup their projects before updating. This update improves the folder structure of Emerald AI, has new demo scenes and demo objects, and improvements to Root Motion movement.

It is important that users regenerate their AI’s Animator Controllers after importing the update. This update also brings improvements to the Animator Controller so users will need to regenerate them to have improved animation transitions. This can be done by pressing the Regenerate button within the Animation tab of the Emerald AI Editor.

For users who do not care about removing the previous Emerald AI assets (or who can’t), you can import the 3.1 update without any issues. This will just mean that users will have both demo sources.

(For users who want to remove the previous demo objects)

If users feel comfortable, and have backed up their projects, they should be able to remove everything within the Emerald AI folder (Not the Emerald AI folder itself) to avoid having the previous demo objects take up unneeded space. Be aware of any files you have created within the Emerald AI folder and to not delete them . If you have custom faction data, ensure you backup your Faction Data asset before updating or removing the previous version. After all this has been done, users can import version 3.1 of Emerald AI. Once again, use caution while doing this and only do this if you do not want the previous demo objects in your project, and that you have a backup of your project.

3.1.0

Changes to Emerald AI’s folder Structure

• Removed all previous demo scenes and files and replaced them with new Emerald AI demos and new models with root motion animations to better showcase Emerald AI’s features and capabilities.
• Completely restructured all demo files so they no longer have to be imported and so the folder structure is cleaner. While it’s highly recommended users include the demo files and scenes, the Demo folder can now be excluding when initially importing Emerald AI.
• Some previous unused scripts were removed.
• Added new AI prefabs to help get users get started quicker.

Current Improvements

• New Demos and demo models to better show Emerald AI’s features and capabilities.
• Big improvements to how Emerald AI’s Root Motion is calculated which allows for much smoother transitions, more fluid movement, and stopping quicker. This is showcased in the new Emerald AI demos.
• Allowed the WalkFootstepSound and RunFootstepSound to play when called from stationary turn animations so footstep sounds could be played while turning.
• Added new AI prefabs to help get users get started quicker.
• Added Force Walk Distance to the Emerald AI Editor (located under AI’s Settings>Combat>Damage Settings) that allows users control the distance in which an AI will start walking instead of running as it approaches its target. This setting can also be set to 0 if users would like this feature disabled.

Current Fixes

• Fixed a bug that allowed AI using Line of Sight to sometimes detect targets through the floors and walls both on the first time detecting a target and after kill one.
• Fixed various bugs related to companion AI.
• Fixed a bug that caused some EmeraldAIProjectiles script to not properly set the added sphere collider to (0,0,0) which resulted in incorrect projectile collisions.
• Fixed a bug that caused foot sliding when using run animations.
• Fixed a bug that could allow some AI to get stuck in a loop of their turning left and turning right animations.
• Fixed a bug that sometimes allowed an AI to skip its second waypoint when using the Loop or Reverse Waypoint Types.
• Fixed a bug that didn’t allow an AI’s Stopping Distance to be set to its Attack Distance when getting a target while in the process of reversing its waypoints.
• Fixed a few warning messages from some of Emerald AI’s scripts.
• Stopped allowing warning messages to be displayed for setting up a faction and melee attacks/ranged abilities when using a non-combat Passive AI.
• Added a check to ensure the file path of an Animator Controller exists before regenerating an Animator Controller (When pressing the Regenerate Animator Controller button). This previously lead to a lost reference to the AI’s Animator Controller. Instead, this notifies users to just clear the Animator Controller and create a new one which will fix the missing reference and update the Animator Controller.

3.0.1

• Updated Emerald AI’s offline documentaion to say Emerald AI 3.0 to avoid confusion as previously it said Emerald AI 2.0. Both of these docs link to the Emerald AI Wiki site which is still highly recommended for the most up to date documentation.
• Fixed a bug that didn’t allow the ResetAI API to work correctly.

Emerald AI 3.0 is a large updated version to Emerald AI 2.0. For a list of all changes, improvements, and new features, the Release Notes can be found here: All Emerald AI 3.0 Release Notes

For users who are upgrading from Emerald AI version 2.0, it is recommended that projects are backed up before updating to version 3.0. The upgrading process is simple and compatible coming from version 2.0. An upgrade guide can be found here: Emerald AI 3.0 Upgrade Guide