Always remember to unpack integration packages that you’re using when importing new version of Energy Bar Toolkit!

General info

Upgrading EnergyBarToolkit is very simple, and in most cases after importing the new version everything should be fine. In some cases importing the new version over existing one may fail. You may notice this immediately (compilation errors), or after some time (script referenced in documentation is missing). This is because the unitypackage format, which is used to distribute assets, is not perfect. If you want to be 100% sure that EnergyBarToolkit is imported 100% correctly, please remove EnergyBarToolkit directory from your Project manually before importing the new version.

Don’t forget to manually unpack all integration packages for tools that you’re using after each upgrade!

API changes

Renames

FillRenderer3D has been renamed to FilledRenderer3D. There should be no consequences to your current scenes, but if you referenced FillRenderer3D in your code directly, then please update its name.

Inheritance

In order to make component classification more consistent, new base class has been introduced: EnergyBarOnGUIBase. Now inheritance tree looks as follows:

  • EnergyBarBase – base class for all renderers
    • EnergyBarOnGUIBase – subclass for OnGUI renderers, common code only for OnGUI renderers
      • EnergyBarRenderer
      • EnergyBarRepeatedRenderer
      • EnergyBarSequenceRenderer
      • EnergyBarTransformRenderer
    • EnergyBar3DBase – subclass for mesh renderers, common code only for Mesh renderers.
      • FilledRenderer3D
      • RepeatedRenderer3D
Notice that 3D renderers are missing EnergyBar prefix. That’s because these classes are located in EnergyBarToolkit namespace, and the prefix is no longer needed.

Possible issues

Energy Bar Toolkit 1.8.0 may reset your Pivot point for Mesh Renderers to Center. Please recheck every scene where you’re making use of these renderers.

New NGUI integration

Energy Bar Toolkit 1.8.0 is dropping support for NGUI older than 3.0.0. It also introduces new integration for NGUI, and makes old integration code deprecated (old integration package is now located in Deprecated directory).

Improved DF-GUI integration

Energy Bar Toolkit 1.8.0 greatly improves support for DF-GUI. Please check again your DF-GUI scenes if you were using the integration.