From e0b50439b36bb1cff1de0a0a9309cdd850e04628 Mon Sep 17 00:00:00 2001
From: TrainWrack <120750885+TrainWrack@users.noreply.github.com>
Date: Sat, 8 Mar 2025 23:59:49 -0500
Subject: [PATCH] Custom bar module (#1492)

* Update to bug report form

* Update bug_report.yaml

* Update AUTHORS.md

- Tomo (general coding, special FX coding, bug fixing)

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update bug_report.yaml

* Add files via upload

* Update CHANGELOG.md

* Add files via upload

* Update CustomBar.lua

* Fix bugs with bar property setters

* Update CustomBar.lua

* Update documentation

---------

Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com>
Co-authored-by: Nemoel-Tomo <tomo_669@hotmail.com>
Co-authored-by: Jakub <kubabilinski03@gmail.com>
Co-authored-by: Jakub <80340234+Jakub768@users.noreply.github.com>
Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com>
---
 CHANGELOG.md                                  |    1 +
 Documentation/doc/1 modules/Effects.html      |    1 +
 Documentation/doc/1 modules/Flow.html         |    1 +
 Documentation/doc/1 modules/Input.html        |    1 +
 Documentation/doc/1 modules/Inventory.html    |    1 +
 Documentation/doc/1 modules/Logic.html        |    1 +
 Documentation/doc/1 modules/Objects.html      |    1 +
 Documentation/doc/1 modules/Sound.html        |    1 +
 Documentation/doc/1 modules/Strings.html      |    1 +
 Documentation/doc/1 modules/Util.html         |    1 +
 Documentation/doc/1 modules/View.html         |    1 +
 .../doc/2 classes/Collision.Probe.html        |    1 +
 Documentation/doc/2 classes/Flow.Level.html   |    1 +
 .../doc/2 classes/Flow.Settings.html          |    1 +
 .../doc/2 classes/Flow.Statistics.html        |    1 +
 .../doc/2 classes/Objects.AIObject.html       |    1 +
 .../doc/2 classes/Objects.Camera.html         |    1 +
 .../doc/2 classes/Objects.LaraObject.html     |    1 +
 .../doc/2 classes/Objects.Moveable.html       |    1 +
 Documentation/doc/2 classes/Objects.Room.html |    1 +
 Documentation/doc/2 classes/Objects.Sink.html |    1 +
 .../doc/2 classes/Objects.SoundSource.html    |    1 +
 .../doc/2 classes/Objects.Static.html         |    1 +
 .../doc/2 classes/Objects.Volume.html         |    1 +
 .../doc/2 classes/Strings.DisplayString.html  |    1 +
 .../doc/2 classes/View.DisplaySprite.html     |    1 +
 .../doc/3 primitive classes/Color.html        |    1 +
 .../doc/3 primitive classes/Flow.Fog.html     |    1 +
 .../doc/3 primitive classes/Flow.Horizon.html |    1 +
 .../Flow.InventoryItem.html                   |    1 +
 .../3 primitive classes/Flow.LensFlare.html   |    1 +
 .../3 primitive classes/Flow.SkyLayer.html    |    1 +
 .../3 primitive classes/Flow.Starfield.html   |    1 +
 .../doc/3 primitive classes/Rotation.html     |    1 +
 .../doc/3 primitive classes/Time.html         |    1 +
 .../doc/3 primitive classes/Vec2.html         |    1 +
 .../doc/3 primitive classes/Vec3.html         |    1 +
 .../doc/4 enums/Collision.MaterialType.html   |    1 +
 .../doc/4 enums/Effects.BlendID.html          |    1 +
 .../doc/4 enums/Effects.EffectID.html         |    1 +
 .../doc/4 enums/Effects.FeatherMode.html      |    1 +
 .../Effects.ParticleAnimationType.html        |    1 +
 Documentation/doc/4 enums/Flow.ErrorMode.html |    1 +
 .../doc/4 enums/Flow.FreezeMode.html          |    1 +
 .../doc/4 enums/Flow.GameStatus.html          |    1 +
 Documentation/doc/4 enums/Input.ActionID.html |    1 +
 .../doc/4 enums/Objects.AmmoType.html         |    1 +
 .../doc/4 enums/Objects.HandStatus.html       |    1 +
 .../doc/4 enums/Objects.MoveableStatus.html   |    1 +
 Documentation/doc/4 enums/Objects.ObjID.html  |    1 +
 .../doc/4 enums/Objects.RoomFlagID.html       |    1 +
 .../doc/4 enums/Objects.RoomReverb.html       |    1 +
 .../doc/4 enums/Objects.WeaponType.html       |    1 +
 .../doc/4 enums/Sound.SoundTrackType.html     |    1 +
 .../4 enums/Strings.DisplayStringOption.html  |    1 +
 Documentation/doc/4 enums/Util.LogLevel.html  |    1 +
 Documentation/doc/4 enums/View.AlignMode.html |    1 +
 .../doc/4 enums/View.CameraType.html          |    1 +
 .../doc/4 enums/View.PostProcessMode.html     |    1 +
 Documentation/doc/4 enums/View.ScaleMode.html |    1 +
 .../doc/5 lua utility modules/CustomBar.html  | 1510 +++++++++++++++++
 .../doc/5 lua utility modules/Diary.html      |    4 +-
 .../5 lua utility modules/EventSequence.html  |    1 +
 .../doc/5 lua utility modules/Timer.html      |    1 +
 .../doc/5 lua utility modules/Type.html       |    1 +
 Documentation/doc/index.html                  |    8 +-
 Scripts/Engine/CustomBar.lua                  |  951 +++++++++++
 Scripts/Engine/CustomDiary.lua                |    3 +-
 68 files changed, 2533 insertions(+), 6 deletions(-)
 create mode 100644 Documentation/doc/5 lua utility modules/CustomBar.html
 create mode 100644 Scripts/Engine/CustomBar.lua

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 52cb4c1ef..a3671788d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -36,6 +36,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor):
 * Added Collision.Probe class for basic room collision detection.
 * Added advanced particle emitter allowing animations and other effects.
 * Added diary module.
+* Added custom bar module.
 * Added Flow.Horizon class with and use two layers of horizons in a Flow.Level class.
 * Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point.
 * Added Effects.EmitAirBubble() function to spawn air bubbles.
diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html
index 68c602977..5f3c6e3f0 100644
--- a/Documentation/doc/1 modules/Effects.html	
+++ b/Documentation/doc/1 modules/Effects.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html
index 251cdc1ac..87f02974d 100644
--- a/Documentation/doc/1 modules/Flow.html	
+++ b/Documentation/doc/1 modules/Flow.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/1 modules/Input.html b/Documentation/doc/1 modules/Input.html
index 726d63197..ab68d0a53 100644
--- a/Documentation/doc/1 modules/Input.html	
+++ b/Documentation/doc/1 modules/Input.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/1 modules/Inventory.html b/Documentation/doc/1 modules/Inventory.html
index f479a77cf..b16cba1f0 100644
--- a/Documentation/doc/1 modules/Inventory.html	
+++ b/Documentation/doc/1 modules/Inventory.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/1 modules/Logic.html b/Documentation/doc/1 modules/Logic.html
index 022f32f39..607c77c99 100644
--- a/Documentation/doc/1 modules/Logic.html	
+++ b/Documentation/doc/1 modules/Logic.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/1 modules/Objects.html b/Documentation/doc/1 modules/Objects.html
index f891741b2..ae8c45650 100644
--- a/Documentation/doc/1 modules/Objects.html	
+++ b/Documentation/doc/1 modules/Objects.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html
index e2bd199bf..5cfa41484 100644
--- a/Documentation/doc/1 modules/Sound.html	
+++ b/Documentation/doc/1 modules/Sound.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/1 modules/Strings.html b/Documentation/doc/1 modules/Strings.html
index d218b1fd5..0dde6ad65 100644
--- a/Documentation/doc/1 modules/Strings.html	
+++ b/Documentation/doc/1 modules/Strings.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/1 modules/Util.html b/Documentation/doc/1 modules/Util.html
index 75a96f3ca..97a387d2a 100644
--- a/Documentation/doc/1 modules/Util.html	
+++ b/Documentation/doc/1 modules/Util.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html
index 2438302a5..e1bb7aa4d 100644
--- a/Documentation/doc/1 modules/View.html	
+++ b/Documentation/doc/1 modules/View.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html
index 1d15d3361..7470c4456 100644
--- a/Documentation/doc/2 classes/Collision.Probe.html	
+++ b/Documentation/doc/2 classes/Collision.Probe.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Flow.Level.html b/Documentation/doc/2 classes/Flow.Level.html
index 7108791b1..780c9ba38 100644
--- a/Documentation/doc/2 classes/Flow.Level.html	
+++ b/Documentation/doc/2 classes/Flow.Level.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html
index 3c3d02879..092587e0b 100644
--- a/Documentation/doc/2 classes/Flow.Settings.html	
+++ b/Documentation/doc/2 classes/Flow.Settings.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Flow.Statistics.html b/Documentation/doc/2 classes/Flow.Statistics.html
index f3d98b654..2f16e90a9 100644
--- a/Documentation/doc/2 classes/Flow.Statistics.html	
+++ b/Documentation/doc/2 classes/Flow.Statistics.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Objects.AIObject.html b/Documentation/doc/2 classes/Objects.AIObject.html
index 3f81de9d9..fcb918837 100644
--- a/Documentation/doc/2 classes/Objects.AIObject.html	
+++ b/Documentation/doc/2 classes/Objects.AIObject.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Objects.Camera.html b/Documentation/doc/2 classes/Objects.Camera.html
index edfafcf92..c79508433 100644
--- a/Documentation/doc/2 classes/Objects.Camera.html	
+++ b/Documentation/doc/2 classes/Objects.Camera.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html
index 2e9d879f1..ef3373f39 100644
--- a/Documentation/doc/2 classes/Objects.LaraObject.html	
+++ b/Documentation/doc/2 classes/Objects.LaraObject.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html
index d7b89fd6b..b088b9ea2 100644
--- a/Documentation/doc/2 classes/Objects.Moveable.html	
+++ b/Documentation/doc/2 classes/Objects.Moveable.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Objects.Room.html b/Documentation/doc/2 classes/Objects.Room.html
index 82e8a24a7..e4eb0369b 100644
--- a/Documentation/doc/2 classes/Objects.Room.html	
+++ b/Documentation/doc/2 classes/Objects.Room.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Objects.Sink.html b/Documentation/doc/2 classes/Objects.Sink.html
index f81ec4196..e9e57c4fe 100644
--- a/Documentation/doc/2 classes/Objects.Sink.html	
+++ b/Documentation/doc/2 classes/Objects.Sink.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Objects.SoundSource.html b/Documentation/doc/2 classes/Objects.SoundSource.html
index c9223f69a..2a93e9b12 100644
--- a/Documentation/doc/2 classes/Objects.SoundSource.html	
+++ b/Documentation/doc/2 classes/Objects.SoundSource.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Objects.Static.html b/Documentation/doc/2 classes/Objects.Static.html
index 9a995cd3b..f8afe4407 100644
--- a/Documentation/doc/2 classes/Objects.Static.html	
+++ b/Documentation/doc/2 classes/Objects.Static.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Objects.Volume.html b/Documentation/doc/2 classes/Objects.Volume.html
index 4d0c47805..7b8534235 100644
--- a/Documentation/doc/2 classes/Objects.Volume.html	
+++ b/Documentation/doc/2 classes/Objects.Volume.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/Strings.DisplayString.html b/Documentation/doc/2 classes/Strings.DisplayString.html
index 86c258db7..d1a494957 100644
--- a/Documentation/doc/2 classes/Strings.DisplayString.html	
+++ b/Documentation/doc/2 classes/Strings.DisplayString.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html
index fe3ff45c1..4548df0db 100644
--- a/Documentation/doc/2 classes/View.DisplaySprite.html	
+++ b/Documentation/doc/2 classes/View.DisplaySprite.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Color.html b/Documentation/doc/3 primitive classes/Color.html
index 22af2ca4f..0d2993bd9 100644
--- a/Documentation/doc/3 primitive classes/Color.html	
+++ b/Documentation/doc/3 primitive classes/Color.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Flow.Fog.html b/Documentation/doc/3 primitive classes/Flow.Fog.html
index d9a361a05..3bd25c6b4 100644
--- a/Documentation/doc/3 primitive classes/Flow.Fog.html	
+++ b/Documentation/doc/3 primitive classes/Flow.Fog.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Flow.Horizon.html b/Documentation/doc/3 primitive classes/Flow.Horizon.html
index 61025ca74..5beccaa2b 100644
--- a/Documentation/doc/3 primitive classes/Flow.Horizon.html	
+++ b/Documentation/doc/3 primitive classes/Flow.Horizon.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html
index 8449b9cc3..1586a6072 100644
--- a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html	
+++ b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html
index b93607fc6..ad3f0f67a 100644
--- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html	
+++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html
index 0109dba88..03d2a46af 100644
--- a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html	
+++ b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Flow.Starfield.html b/Documentation/doc/3 primitive classes/Flow.Starfield.html
index f1ea0feb6..05934ae6b 100644
--- a/Documentation/doc/3 primitive classes/Flow.Starfield.html	
+++ b/Documentation/doc/3 primitive classes/Flow.Starfield.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Rotation.html b/Documentation/doc/3 primitive classes/Rotation.html
index bc19be436..607218c1a 100644
--- a/Documentation/doc/3 primitive classes/Rotation.html	
+++ b/Documentation/doc/3 primitive classes/Rotation.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Time.html b/Documentation/doc/3 primitive classes/Time.html
index c80e6636e..5cc1949f6 100644
--- a/Documentation/doc/3 primitive classes/Time.html	
+++ b/Documentation/doc/3 primitive classes/Time.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html
index 7c6dce268..5c7f7e5c4 100644
--- a/Documentation/doc/3 primitive classes/Vec2.html	
+++ b/Documentation/doc/3 primitive classes/Vec2.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/3 primitive classes/Vec3.html b/Documentation/doc/3 primitive classes/Vec3.html
index 51c9700d1..715d39062 100644
--- a/Documentation/doc/3 primitive classes/Vec3.html	
+++ b/Documentation/doc/3 primitive classes/Vec3.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html
index 940554fba..560cb4d9f 100644
--- a/Documentation/doc/4 enums/Collision.MaterialType.html	
+++ b/Documentation/doc/4 enums/Collision.MaterialType.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Effects.BlendID.html b/Documentation/doc/4 enums/Effects.BlendID.html
index 9e264a172..540ac8415 100644
--- a/Documentation/doc/4 enums/Effects.BlendID.html	
+++ b/Documentation/doc/4 enums/Effects.BlendID.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Effects.EffectID.html b/Documentation/doc/4 enums/Effects.EffectID.html
index ff79e7033..577ca2670 100644
--- a/Documentation/doc/4 enums/Effects.EffectID.html	
+++ b/Documentation/doc/4 enums/Effects.EffectID.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Effects.FeatherMode.html b/Documentation/doc/4 enums/Effects.FeatherMode.html
index 0cd3fee96..aeab018ee 100644
--- a/Documentation/doc/4 enums/Effects.FeatherMode.html	
+++ b/Documentation/doc/4 enums/Effects.FeatherMode.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html
index e78b9afbc..5da6ba0e8 100644
--- a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html	
+++ b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Flow.ErrorMode.html b/Documentation/doc/4 enums/Flow.ErrorMode.html
index ea2882299..a972c1369 100644
--- a/Documentation/doc/4 enums/Flow.ErrorMode.html	
+++ b/Documentation/doc/4 enums/Flow.ErrorMode.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Flow.FreezeMode.html b/Documentation/doc/4 enums/Flow.FreezeMode.html
index b0b7b74d0..cff19f990 100644
--- a/Documentation/doc/4 enums/Flow.FreezeMode.html	
+++ b/Documentation/doc/4 enums/Flow.FreezeMode.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Flow.GameStatus.html b/Documentation/doc/4 enums/Flow.GameStatus.html
index aa9b3e8da..27324b7b4 100644
--- a/Documentation/doc/4 enums/Flow.GameStatus.html	
+++ b/Documentation/doc/4 enums/Flow.GameStatus.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Input.ActionID.html b/Documentation/doc/4 enums/Input.ActionID.html
index ede13bb3a..270c5a9e7 100644
--- a/Documentation/doc/4 enums/Input.ActionID.html	
+++ b/Documentation/doc/4 enums/Input.ActionID.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Objects.AmmoType.html b/Documentation/doc/4 enums/Objects.AmmoType.html
index 1cc6aa18f..80d10b754 100644
--- a/Documentation/doc/4 enums/Objects.AmmoType.html	
+++ b/Documentation/doc/4 enums/Objects.AmmoType.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Objects.HandStatus.html b/Documentation/doc/4 enums/Objects.HandStatus.html
index 8cab70060..639793907 100644
--- a/Documentation/doc/4 enums/Objects.HandStatus.html	
+++ b/Documentation/doc/4 enums/Objects.HandStatus.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Objects.MoveableStatus.html b/Documentation/doc/4 enums/Objects.MoveableStatus.html
index a0c273c0e..abc608b8a 100644
--- a/Documentation/doc/4 enums/Objects.MoveableStatus.html	
+++ b/Documentation/doc/4 enums/Objects.MoveableStatus.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html
index 9b1367920..0daeb40f0 100644
--- a/Documentation/doc/4 enums/Objects.ObjID.html	
+++ b/Documentation/doc/4 enums/Objects.ObjID.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Objects.RoomFlagID.html b/Documentation/doc/4 enums/Objects.RoomFlagID.html
index 1e099fcad..a472524ec 100644
--- a/Documentation/doc/4 enums/Objects.RoomFlagID.html	
+++ b/Documentation/doc/4 enums/Objects.RoomFlagID.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Objects.RoomReverb.html b/Documentation/doc/4 enums/Objects.RoomReverb.html
index 846d0228b..9ecacbbbf 100644
--- a/Documentation/doc/4 enums/Objects.RoomReverb.html	
+++ b/Documentation/doc/4 enums/Objects.RoomReverb.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Objects.WeaponType.html b/Documentation/doc/4 enums/Objects.WeaponType.html
index 0f0f62c2c..ded6644fb 100644
--- a/Documentation/doc/4 enums/Objects.WeaponType.html	
+++ b/Documentation/doc/4 enums/Objects.WeaponType.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Sound.SoundTrackType.html b/Documentation/doc/4 enums/Sound.SoundTrackType.html
index a62e76557..322be1ca6 100644
--- a/Documentation/doc/4 enums/Sound.SoundTrackType.html	
+++ b/Documentation/doc/4 enums/Sound.SoundTrackType.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Strings.DisplayStringOption.html b/Documentation/doc/4 enums/Strings.DisplayStringOption.html
index 00bbc3e43..193062a2a 100644
--- a/Documentation/doc/4 enums/Strings.DisplayStringOption.html	
+++ b/Documentation/doc/4 enums/Strings.DisplayStringOption.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/Util.LogLevel.html b/Documentation/doc/4 enums/Util.LogLevel.html
index c8ff448e4..e460b478b 100644
--- a/Documentation/doc/4 enums/Util.LogLevel.html	
+++ b/Documentation/doc/4 enums/Util.LogLevel.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/View.AlignMode.html b/Documentation/doc/4 enums/View.AlignMode.html
index 3696dd12c..c1f559c82 100644
--- a/Documentation/doc/4 enums/View.AlignMode.html	
+++ b/Documentation/doc/4 enums/View.AlignMode.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/View.CameraType.html b/Documentation/doc/4 enums/View.CameraType.html
index 37d7656b7..a6a4f12ba 100644
--- a/Documentation/doc/4 enums/View.CameraType.html	
+++ b/Documentation/doc/4 enums/View.CameraType.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/View.PostProcessMode.html b/Documentation/doc/4 enums/View.PostProcessMode.html
index cb22d26d0..83657e992 100644
--- a/Documentation/doc/4 enums/View.PostProcessMode.html	
+++ b/Documentation/doc/4 enums/View.PostProcessMode.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/4 enums/View.ScaleMode.html b/Documentation/doc/4 enums/View.ScaleMode.html
index 3e90fbcda..3ced09b6a 100644
--- a/Documentation/doc/4 enums/View.ScaleMode.html	
+++ b/Documentation/doc/4 enums/View.ScaleMode.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/5 lua utility modules/CustomBar.html b/Documentation/doc/5 lua utility modules/CustomBar.html
new file mode 100644
index 000000000..293044e74
--- /dev/null
+++ b/Documentation/doc/5 lua utility modules/CustomBar.html	
@@ -0,0 +1,1510 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>TombEngine 1.7.2 (Developer) Lua API</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>&nbsp;TombEngine</h1>
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>1 Modules</h2>
+<ul class="nowrap">
+  <li>    <a href="../1 modules/Effects.html">Effects</a></li>
+  <li>    <a href="../1 modules/Flow.html">Flow</a></li>
+  <li>    <a href="../1 modules/Input.html">Input</a></li>
+  <li>    <a href="../1 modules/Inventory.html">Inventory</a></li>
+  <li>    <a href="../1 modules/Logic.html">Logic</a></li>
+  <li>    <a href="../1 modules/Objects.html">Objects</a></li>
+  <li>    <a href="../1 modules/Sound.html">Sound</a></li>
+  <li>    <a href="../1 modules/Strings.html">Strings</a></li>
+  <li>    <a href="../1 modules/Util.html">Util</a></li>
+  <li>    <a href="../1 modules/View.html">View</a></li>
+</ul>
+<h2>2 Classes</h2>
+<ul class="nowrap">
+  <li>    <a href="../2 classes/Collision.Probe.html">Collision.Probe</a></li>
+  <li>    <a href="../2 classes/Flow.Level.html">Flow.Level</a></li>
+  <li>    <a href="../2 classes/Flow.Settings.html">Flow.Settings</a></li>
+  <li>    <a href="../2 classes/Flow.Statistics.html">Flow.Statistics</a></li>
+  <li>    <a href="../2 classes/Objects.AIObject.html">Objects.AIObject</a></li>
+  <li>    <a href="../2 classes/Objects.Camera.html">Objects.Camera</a></li>
+  <li>    <a href="../2 classes/Objects.LaraObject.html">Objects.LaraObject</a></li>
+  <li>    <a href="../2 classes/Objects.Moveable.html">Objects.Moveable</a></li>
+  <li>    <a href="../2 classes/Objects.Room.html">Objects.Room</a></li>
+  <li>    <a href="../2 classes/Objects.Sink.html">Objects.Sink</a></li>
+  <li>    <a href="../2 classes/Objects.SoundSource.html">Objects.SoundSource</a></li>
+  <li>    <a href="../2 classes/Objects.Static.html">Objects.Static</a></li>
+  <li>    <a href="../2 classes/Objects.Volume.html">Objects.Volume</a></li>
+  <li>    <a href="../2 classes/Strings.DisplayString.html">Strings.DisplayString</a></li>
+  <li>    <a href="../2 classes/View.DisplaySprite.html">View.DisplaySprite</a></li>
+</ul>
+<h2>3 Primitive Classes</h2>
+<ul class="nowrap">
+  <li>    <a href="../3 primitive classes/Flow.Fog.html">Flow.Fog</a></li>
+  <li>    <a href="../3 primitive classes/Flow.Horizon.html">Flow.Horizon</a></li>
+  <li>    <a href="../3 primitive classes/Flow.InventoryItem.html">Flow.InventoryItem</a></li>
+  <li>    <a href="../3 primitive classes/Flow.LensFlare.html">Flow.LensFlare</a></li>
+  <li>    <a href="../3 primitive classes/Flow.SkyLayer.html">Flow.SkyLayer</a></li>
+  <li>    <a href="../3 primitive classes/Flow.Starfield.html">Flow.Starfield</a></li>
+  <li>    <a href="../3 primitive classes/Color.html">Color</a></li>
+  <li>    <a href="../3 primitive classes/Rotation.html">Rotation</a></li>
+  <li>    <a href="../3 primitive classes/Time.html">Time</a></li>
+  <li>    <a href="../3 primitive classes/Vec2.html">Vec2</a></li>
+  <li>    <a href="../3 primitive classes/Vec3.html">Vec3</a></li>
+</ul>
+<h2>4 Enums</h2>
+<ul class="nowrap">
+  <li>    <a href="../4 enums/Collision.MaterialType.html">Collision.MaterialType</a></li>
+  <li>    <a href="../4 enums/Effects.BlendID.html">Effects.BlendID</a></li>
+  <li>    <a href="../4 enums/Effects.EffectID.html">Effects.EffectID</a></li>
+  <li>    <a href="../4 enums/Effects.FeatherMode.html">Effects.FeatherMode</a></li>
+  <li>    <a href="../4 enums/Effects.ParticleAnimationType.html">Effects.ParticleAnimationType</a></li>
+  <li>    <a href="../4 enums/Flow.ErrorMode.html">Flow.ErrorMode</a></li>
+  <li>    <a href="../4 enums/Flow.FreezeMode.html">Flow.FreezeMode</a></li>
+  <li>    <a href="../4 enums/Flow.GameStatus.html">Flow.GameStatus</a></li>
+  <li>    <a href="../4 enums/Input.ActionID.html">Input.ActionID</a></li>
+  <li>    <a href="../4 enums/Objects.AmmoType.html">Objects.AmmoType</a></li>
+  <li>    <a href="../4 enums/Objects.HandStatus.html">Objects.HandStatus</a></li>
+  <li>    <a href="../4 enums/Objects.WeaponType.html">Objects.WeaponType</a></li>
+  <li>    <a href="../4 enums/Objects.MoveableStatus.html">Objects.MoveableStatus</a></li>
+  <li>    <a href="../4 enums/Objects.ObjID.html">Objects.ObjID</a></li>
+  <li>    <a href="../4 enums/Objects.RoomFlagID.html">Objects.RoomFlagID</a></li>
+  <li>    <a href="../4 enums/Objects.RoomReverb.html">Objects.RoomReverb</a></li>
+  <li>    <a href="../4 enums/Sound.SoundTrackType.html">Sound.SoundTrackType</a></li>
+  <li>    <a href="../4 enums/Strings.DisplayStringOption.html">Strings.DisplayStringOption</a></li>
+  <li>    <a href="../4 enums/Util.LogLevel.html">Util.LogLevel</a></li>
+  <li>    <a href="../4 enums/View.AlignMode.html">View.AlignMode</a></li>
+  <li>    <a href="../4 enums/View.CameraType.html">View.CameraType</a></li>
+  <li>    <a href="../4 enums/View.PostProcessMode.html">View.PostProcessMode</a></li>
+  <li>    <a href="../4 enums/View.ScaleMode.html">View.ScaleMode</a></li>
+</ul>
+<h2>5 Lua utility modules</h2>
+<ul class="nowrap">
+  <li>    <here>CustomBar</here></li>
+  <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
+  <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
+  <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
+  <li>    <a href="../5 lua utility modules/Type.html">Type</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Lua utility module <code>CustomBar</code></h1>
+<p>This module provides functions for creating and managing custom progress bars.</p>
+<p>
+<p> It stores bar definitions and configurations in <code>LevelVars.Engine.CustomBars</code>, enabling seamless state management.
+ Each bar is independently controlled through its associated functions.</p>
+
+<p> Example usage:</p>
+
+
+<pre>
+<span class="keyword">local</span> CustomBar = <span class="global">require</span>(<span class="string">"Engine.CustomBar"</span>)
+
+<span class="comment">-- Create a table with all the bar properties
+</span><span class="keyword">local</span> barData = {
+    barName             = <span class="string">"water"</span>,
+    startValue          = <span class="number">0</span>,
+    maxValue            = <span class="number">1000</span>,
+    objectIdBg          = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC,
+    spriteIdBg          = <span class="number">0</span>,
+    colorBg             = TEN.Color(<span class="number">255</span>,<span class="number">255</span>,<span class="number">255</span>),
+    posBg               = TEN.Vec2(<span class="number">20</span>, <span class="number">20</span>),
+    rotBg               = <span class="number">0</span>,
+    scaleBg             = TEN.Vec2(<span class="number">19.05</span>, <span class="number">19.1</span>),
+    alignModeBg         = TEN.View.AlignMode.CENTER_LEFT,
+    scaleModeBg         = TEN.View.ScaleMode.FIT,
+    blendModeBg         = TEN.Effects.BlendID.ALPHABLEND,
+    objectIdBar         = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC,
+    spriteIdBar         = <span class="number">1</span>,
+    colorBar            = TEN.Color(<span class="number">255</span>,<span class="number">0</span>,<span class="number">0</span>),
+    posBar              = TEN.Vec2(<span class="number">20.15</span>, <span class="number">20</span>),
+    rot                 = <span class="number">0</span>,
+    scaleBar            = TEN.Vec2(<span class="number">18.7</span>, <span class="number">18.48</span>),
+    alignMode           = TEN.View.AlignMode.CENTER_LEFT,
+    scaleMode           = TEN.View.ScaleMode.FIT,
+    blendMode           = TEN.Effects.BlendID.ALPHABLEND,
+    text                = <span class="string">"Water Bar"</span>,
+    textPos             = TEN.Vec2(<span class="number">20</span>, <span class="number">15</span>),
+    textOptions         = {TEN.Strings.DisplayStringOption.SHADOW,TEN.Strings.DisplayStringOption.CENTER},
+    textScale           = <span class="number">1</span>,
+    textColor           = TEN.Color(<span class="number">255</span>,<span class="number">0</span>,<span class="number">0</span>),
+    hideText            = <span class="keyword">false</span>,
+    alphaBlendSpeed     = <span class="number">50</span>,
+    blink               = <span class="keyword">false</span>,
+    blinkLimit          = <span class="number">0.25</span>
+}
+
+<span class="comment">-- This function creates the bar.
+</span>CustomBar.Create(barData)
+
+<span class="comment">-- This method gets the bar with name "water" and stores it in variable bar.
+</span><span class="keyword">local</span> bar = CustomBar.Get(<span class="string">"water"</span>)
+<span class="comment">-- This method displays the bar
+</span>bar:SetVisibility(<span class="keyword">true</span>)
+<span class="comment">-- This method sets the bar value to 1000 over 5 seconds.
+</span>bar:SetBarValue(<span class="number">1000</span>,<span class="number">5</span>)
+</pre>
+
+</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" ><a href="#Create">Create(barData)</a></td>
+	<td class="summary">Creates a custom progress bar with extensive configuration options.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#CreatePlayerBar">CreatePlayerBar(playerBarData)</a></td>
+	<td class="summary">Creates a bar tied to Players's attributes (Health, Air, Stamina).</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#CreateEnemyHpBar">CreateEnemyHpBar(enemyBarData)</a></td>
+	<td class="summary">Creates a custom health bar for a specific enemy (like a boss).</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetEnemiesHpGenericBar">SetEnemiesHpGenericBar(enemiesBarData)</a></td>
+	<td class="summary">Creates health bars for all enemies.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#Get">Get(barName)</a></td>
+	<td class="summary">The function retrieves an existing bar instance by its unique identifier (barName).</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#Delete">Delete(barName)</a></td>
+	<td class="summary">The function removes a custom bar and its associated data from the system.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBarValue">SetBarValue(value, time)</a></td>
+	<td class="summary">The function sets the value of a custom bar over a specified time period.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#ChangeBarValueOverTimespan">ChangeBarValueOverTimespan(value, time)</a></td>
+	<td class="summary">The function adjusts the bar's value relative to its current or target value over a specified time span.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetVisibility">SetVisibility(visible)</a></td>
+	<td class="summary">The function controls the visibility of a custom bar.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#IsVisible">IsVisible()</a></td>
+	<td class="summary">The function checks whether a custom bar is currently visible.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#GetValue">GetValue()</a></td>
+	<td class="summary">The function retrieves the current value of a custom bar.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#DeleteAllBars">DeleteAllBars()</a></td>
+	<td class="summary">The function deletes all custom bars.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#ShowEnemiesHpGenericBar">ShowEnemiesHpGenericBar(value)</a></td>
+	<td class="summary">This function prevents the creation of new health bars for enemies when set to false.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#DeleteExistingHpGenericBars">DeleteExistingHpGenericBars()</a></td>
+	<td class="summary">The function deletes all the enemy health bars excluding those created by CustomBar.CreateEnemyHpBar.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBackgroundPosition">SetBackgroundPosition(pos)</a></td>
+	<td class="summary">Sets the custom bar background sprite position.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBackgroundRotation">SetBackgroundRotation(rot)</a></td>
+	<td class="summary">Sets the custom bar background sprite rotation.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBackgroundScale">SetBackgroundScale(scale)</a></td>
+	<td class="summary">Sets the custom bar background sprite scale.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBackgroundSpriteSlot">SetBackgroundSpriteSlot(slot, id)</a></td>
+	<td class="summary">Sets the custom bar background sprite slot and sprite ID.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBackgroundAlignMode">SetBackgroundAlignMode(alignMode)</a></td>
+	<td class="summary">Sets the custom bar background sprite align mode.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBackgroundScaleMode">SetBackgroundScaleMode(scaleMode)</a></td>
+	<td class="summary">Sets the custom bar background sprite scale mode.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBackgroundBlendMode">SetBackgroundBlendMode(blendMode)</a></td>
+	<td class="summary">Sets the custom bar background sprite blend mode.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBarPosition">SetBarPosition(pos)</a></td>
+	<td class="summary">Sets the custom bar sprite position.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBarRotation">SetBarRotation(rot)</a></td>
+	<td class="summary">Sets the custom bar sprite rotation.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBarColor">SetBarColor(color)</a></td>
+	<td class="summary">Sets the custom bar sprite color.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBarScale">SetBarScale(scale)</a></td>
+	<td class="summary">Sets the custom bar sprite scale.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBarSpriteSlot">SetBarSpriteSlot(slot, id)</a></td>
+	<td class="summary">Sets the custom bar sprite slot and sprite ID.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBarAlignMode">SetBarAlignMode(alignMode)</a></td>
+	<td class="summary">Sets the custom bar sprite alignment mode.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBarScaleMode">SetBarScaleMode(scaleMode)</a></td>
+	<td class="summary">Sets the custom bar sprite scale mode.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#SetBarBlendMode">SetBarBlendMode(blendMode)</a></td>
+	<td class="summary">Sets the custom bar sprite blend mode.</td>
+	</tr>
+</table>
+<h2><a href="#Tables">Tables</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" ><a href="#barData">barData</a></td>
+	<td class="summary">Table setup for creating custom bar.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#playerBarData">playerBarData</a></td>
+	<td class="summary">Table setup for creating custom player attribute bar.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#enemyBarData">enemyBarData</a></td>
+	<td class="summary">Table setup for creating a specific enemy health bar.</td>
+	</tr>
+	<tr>
+	<td class="name" ><a href="#enemiesBarData">enemiesBarData</a></td>
+	<td class="summary">Table setup for creating health bars for all enemies.</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+
+    <dl class="function">
+    <dt>
+    <a name = "Create"></a>
+    <strong>Create(barData)</strong>
+    </dt>
+    <dd>
+    Creates a custom progress bar with extensive configuration options.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">barData</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         The table that contains all the bar data. Refer to table setup for barData.
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="../5 lua utility modules/CustomBar.html#">CustomBar</a></span>
+        The custombar in its hidden state
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "CreatePlayerBar"></a>
+    <strong>CreatePlayerBar(playerBarData)</strong>
+    </dt>
+    <dd>
+    Creates a bar tied to Players's attributes (Health, Air, Stamina).
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">playerBarData</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         The table that contains all the player bar data. Refer to table setup for playerBarData.
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="../5 lua utility modules/CustomBar.html#">CustomBar</a></span>
+        Player attribute bar.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "CreateEnemyHpBar"></a>
+    <strong>CreateEnemyHpBar(enemyBarData)</strong>
+    </dt>
+    <dd>
+    Creates a custom health bar for a specific enemy (like a boss).  Ensure this function is called before Lara aims at the enemy if using generic enemy HP bars as well.
+ Also be sure to call this function after increasing the HP of the enemy via LUA.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">enemyBarData</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         The table that contains all the enemy bar data. Refer to table setup for enemyBarData.
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="../5 lua utility modules/CustomBar.html#">CustomBar</a></span>
+        Enemy health bar.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetEnemiesHpGenericBar"></a>
+    <strong>SetEnemiesHpGenericBar(enemiesBarData)</strong>
+    </dt>
+    <dd>
+    Creates health bars for all enemies.  A new bar is generated whenever Lara targets an enemy. If the "hide text" option is disabled, the enemy's name (as set in the editor) is displayed.
+ Multiple enemies can share the same name by appending _number to the name in the editor. If adjusting an enemy's max HP, ensure this is done before Lara targets the enemy.
+ To create health bars for specific enemies, use CustomBar.CreateEnemyHpBar, ensuring the bar is created prior to targeting.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">enemiesBarData</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         The table that contains all the enemies bar data. Refer to table setup for enemiesBarData.
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="../5 lua utility modules/CustomBar.html#">CustomBar</a></span>
+        Enemy health bars.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Get"></a>
+    <strong>Get(barName)</strong>
+    </dt>
+    <dd>
+    The function retrieves an existing bar instance by its unique identifier (barName).  This function is useful when you need to access or manipulate a bar that has already been created.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">barName</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         The unique identifier assigned to the bar when it was created using CustomBar.New
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Delete"></a>
+    <strong>Delete(barName)</strong>
+    </dt>
+    <dd>
+    The function removes a custom bar and its associated data from the system.  It ensures that the bar is no longer tracked or accessible in the LevelVars.Engine.CustomBars.bars table.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">barName</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         The name of the custom bar to be deleted.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBarValue"></a>
+    <strong>SetBarValue(value, time)</strong>
+    </dt>
+    <dd>
+    The function sets the value of a custom bar over a specified time period.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">value</span>
+            <span class="types"><span class="type">number</span></span>
+         The new target to which the bar's current value should transition. (Must be a non-negative number; between 0 and the bar's maxValue.
+        </li>
+        <li><span class="parameter">time</span>
+            <span class="types"><span class="type">number</span></span>
+         The time (in seconds) over which the bar's value should transition to the target value.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "ChangeBarValueOverTimespan"></a>
+    <strong>ChangeBarValueOverTimespan(value, time)</strong>
+    </dt>
+    <dd>
+    The function adjusts the bar's value relative to its current or target value over a specified time span.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">value</span>
+            <span class="types"><span class="type">number</span></span>
+         The relative value to add (positive or negative) to the current bar value.
+        </li>
+        <li><span class="parameter">time</span>
+            <span class="types"><span class="type">number</span></span>
+         The duration (in seconds) over which the change should occur.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetVisibility"></a>
+    <strong>SetVisibility(visible)</strong>
+    </dt>
+    <dd>
+    The function controls the visibility of a custom bar.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">visible</span>
+            <span class="types"><span class="type">bool</span></span>
+         true: Makes the bar visible.; false: Hides the bar.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "IsVisible"></a>
+    <strong>IsVisible()</strong>
+    </dt>
+    <dd>
+    The function checks whether a custom bar is currently visible.
+
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><span class="type">bool</span></span>
+        true if the bar is visible and false if it is not.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "GetValue"></a>
+    <strong>GetValue()</strong>
+    </dt>
+    <dd>
+    The function retrieves the current value of a custom bar.
+
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><span class="type">float</span></span>
+        returns the current value of a custom bar.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "DeleteAllBars"></a>
+    <strong>DeleteAllBars()</strong>
+    </dt>
+    <dd>
+    The function deletes all custom bars.
+
+
+
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "ShowEnemiesHpGenericBar"></a>
+    <strong>ShowEnemiesHpGenericBar(value)</strong>
+    </dt>
+    <dd>
+    This function prevents the creation of new health bars for enemies when set to false.  However, it does not affect the health bars that have already been created.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">value</span>
+            <span class="types"><span class="type">bool</span></span>
+         Specifies whether new health bars for enemies should be created.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "DeleteExistingHpGenericBars"></a>
+    <strong>DeleteExistingHpGenericBars()</strong>
+    </dt>
+    <dd>
+    The function deletes all the enemy health bars excluding those created by CustomBar.CreateEnemyHpBar.
+
+
+
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBackgroundPosition"></a>
+    <strong>SetBackgroundPosition(pos)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar background sprite position.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">pos</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar's background in screen percent (0-100).
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBackgroundRotation"></a>
+    <strong>SetBackgroundRotation(rot)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar background sprite rotation.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">rot</span>
+            <span class="types"><span class="type">number</span></span>
+         rotation of the bar's background. sprite (0-360).
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBackgroundScale"></a>
+    <strong>SetBackgroundScale(scale)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar background sprite scale.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">scale</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's background sprite.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBackgroundSpriteSlot"></a>
+    <strong>SetBackgroundSpriteSlot(slot, id)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar background sprite slot and sprite ID.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">slot</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar's background sprite.
+        </li>
+        <li><span class="parameter">id</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar's background.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBackgroundAlignMode"></a>
+    <strong>SetBackgroundAlignMode(alignMode)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar background sprite align mode.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">alignMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar's background.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBackgroundScaleMode"></a>
+    <strong>SetBackgroundScaleMode(scaleMode)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar background sprite scale mode.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">scaleMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar's background.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBackgroundBlendMode"></a>
+    <strong>SetBackgroundBlendMode(blendMode)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar background sprite blend mode.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">blendMode</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar's background.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBarPosition"></a>
+    <strong>SetBarPosition(pos)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar sprite position.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">pos</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar in screen percent (0-100).
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBarRotation"></a>
+    <strong>SetBarRotation(rot)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar sprite rotation.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">rot</span>
+            <span class="types"><span class="type">number</span></span>
+         rotation of the bar's sprite (0-360).
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBarColor"></a>
+    <strong>SetBarColor(color)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar sprite color.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">color</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of the bar.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBarScale"></a>
+    <strong>SetBarScale(scale)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar sprite scale.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">scale</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's sprite.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBarSpriteSlot"></a>
+    <strong>SetBarSpriteSlot(slot, id)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar sprite slot and sprite ID.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">slot</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar sprite.
+        </li>
+        <li><span class="parameter">id</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBarAlignMode"></a>
+    <strong>SetBarAlignMode(alignMode)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar sprite alignment mode.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">alignMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBarScaleMode"></a>
+    <strong>SetBarScaleMode(scaleMode)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar sprite scale mode.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">scaleMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "SetBarBlendMode"></a>
+    <strong>SetBarBlendMode(blendMode)</strong>
+    </dt>
+    <dd>
+    Sets the custom bar sprite blend mode.
+
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">blendMode</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+</dl>
+    <h2 class="section-header "><a name="Tables"></a>Tables</h2>
+
+    <dl class="function">
+    <dt>
+    <a name = "barData"></a>
+    <strong>barData</strong>
+    </dt>
+    <dd>
+    Table setup for creating custom bar.
+
+
+
+    <h3>Fields:</h3>
+    <ul>
+        <li><span class="parameter">barName</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         Unique identifier for the bar.
+        </li>
+        <li><span class="parameter">startValue</span>
+            <span class="types"><span class="type">float</span></span>
+         Initial value of the bar.
+        </li>
+        <li><span class="parameter">maxValue</span>
+            <span class="types"><span class="type">float</span></span>
+         Maximum value of the bar.
+        </li>
+        <li><span class="parameter">objectIdBg</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar's background sprite.
+        </li>
+        <li><span class="parameter">spriteIdBg</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar's background.
+        </li>
+        <li><span class="parameter">colorBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of bar's background.
+        </li>
+        <li><span class="parameter">posBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar's background in screen percent (0-100).
+        </li>
+        <li><span class="parameter">rotBg</span>
+            <span class="types"><span class="type">float</span></span>
+         rotation of the bar's background. sprite (0-360).
+        </li>
+        <li><span class="parameter">scaleBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's background sprite.
+        </li>
+        <li><span class="parameter">alignModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar's background.
+        </li>
+        <li><span class="parameter">scaleModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar's background.
+        </li>
+        <li><span class="parameter">blendModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar's background.
+        </li>
+        <li><span class="parameter">objectIdBar</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar sprite.
+        </li>
+        <li><span class="parameter">spriteIdBar</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar.
+        </li>
+        <li><span class="parameter">colorBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of the bar.
+        </li>
+        <li><span class="parameter">posBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar in screen percent (0-100).
+        </li>
+        <li><span class="parameter">rot</span>
+            <span class="types"><span class="type">float</span></span>
+         rotation of the bar's sprite (0-360).
+        </li>
+        <li><span class="parameter">scaleBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's sprite.
+        </li>
+        <li><span class="parameter">alignMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar.
+        </li>
+        <li><span class="parameter">scaleMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar.
+        </li>
+        <li><span class="parameter">blendMode</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar.
+        </li>
+        <li><span class="parameter">text</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         Text to display on the bar.
+        </li>
+        <li><span class="parameter">textPos</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the text.
+        </li>
+        <li><span class="parameter">textOptions</span>
+            <span class="types"><a class="type" href="../4 enums/Strings.DisplayStringOption.html#">DisplayStringOption</a></span>
+         alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT
+        </li>
+        <li><span class="parameter">textScale</span>
+            <span class="types"><span class="type">number</span></span>
+         Scale factor for the text.
+        </li>
+        <li><span class="parameter">textColor</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of the text.
+        </li>
+        <li><span class="parameter">hideText</span>
+            <span class="types"><span class="type">bool</span></span>
+         Whether to hide the text.
+        </li>
+        <li><span class="parameter">alphaBlendSpeed</span>
+            <span class="types"><span class="type">number</span></span>
+         Speed of alpha blending for bar visibility (0-255).
+        </li>
+        <li><span class="parameter">blink</span>
+            <span class="types"><span class="type">bool</span></span>
+         Whether the bar blinks.
+        </li>
+        <li><span class="parameter">blinkLimit</span>
+            <span class="types"><span class="type">number</span></span>
+         % Limit below which bar starts blinking (0-1).
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "playerBarData"></a>
+    <strong>playerBarData</strong>
+    </dt>
+    <dd>
+    Table setup for creating custom player attribute bar.
+
+
+
+    <h3>Fields:</h3>
+    <ul>
+        <li><span class="parameter">getActionType</span>
+            <span class="types"><span class="type">number</span></span>
+         Determines the bar type: 1: Health, 2: Air, 3: Stamina.
+        </li>
+        <li><span class="parameter">objectIdBg</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar's background sprite.
+        </li>
+        <li><span class="parameter">spriteIdBg</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar's background.
+        </li>
+        <li><span class="parameter">colorBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of bar's background.
+        </li>
+        <li><span class="parameter">posBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar's background in screen percent (0-100).
+        </li>
+        <li><span class="parameter">rotBg</span>
+            <span class="types"><span class="type">number</span></span>
+         rotation of the bar's background. sprite (0-360).
+        </li>
+        <li><span class="parameter">scaleBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's background sprite.
+        </li>
+        <li><span class="parameter">alignModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar's background.
+        </li>
+        <li><span class="parameter">scaleModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar's background.
+        </li>
+        <li><span class="parameter">blendModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar's background.
+        </li>
+        <li><span class="parameter">objectIdBar</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar sprite.
+        </li>
+        <li><span class="parameter">spriteIdBar</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar.
+        </li>
+        <li><span class="parameter">colorBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of the bar.
+        </li>
+        <li><span class="parameter">posBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar in screen percent (0-100).
+        </li>
+        <li><span class="parameter">rot</span>
+            <span class="types"><span class="type">number</span></span>
+         rotation of the bar's sprite (0-360).
+        </li>
+        <li><span class="parameter">scaleBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's sprite.
+        </li>
+        <li><span class="parameter">alignMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar.
+        </li>
+        <li><span class="parameter">scaleMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar.
+        </li>
+        <li><span class="parameter">blendMode</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar.
+        </li>
+        <li><span class="parameter">alphaBlendSpeed</span>
+            <span class="types"><span class="type">number</span></span>
+         Speed of alpha blending for bar visibility (0-255).
+        </li>
+        <li><span class="parameter">showBar</span>
+            <span class="types"><span class="type">bool</span></span>
+         Option to always show the bar. If set to false, the bars will automatically hide when they stop updating.
+        </li>
+        <li><span class="parameter">blink</span>
+            <span class="types"><span class="type">bool</span></span>
+         Whether the bar blinks.
+        </li>
+        <li><span class="parameter">blinkLimit</span>
+            <span class="types"><span class="type">number</span></span>
+         % Limit below which bar starts blinking (0-1).
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "enemyBarData"></a>
+    <strong>enemyBarData</strong>
+    </dt>
+    <dd>
+    Table setup for creating a specific enemy health bar.
+
+
+
+    <h3>Fields:</h3>
+    <ul>
+        <li><span class="parameter">barName</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         Unique identifier for the bar.
+        </li>
+        <li><span class="parameter">objectIdBg</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar's background sprite.
+        </li>
+        <li><span class="parameter">spriteIdBg</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar's background.
+        </li>
+        <li><span class="parameter">colorBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of bar's background.
+        </li>
+        <li><span class="parameter">posBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar's background in screen percent (0-100).
+        </li>
+        <li><span class="parameter">rotBg</span>
+            <span class="types"><span class="type">number</span></span>
+         rotation of the bar's background. sprite (0-360).
+        </li>
+        <li><span class="parameter">scaleBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's background sprite.
+        </li>
+        <li><span class="parameter">alignModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar's background.
+        </li>
+        <li><span class="parameter">scaleModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar's background.
+        </li>
+        <li><span class="parameter">blendModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar's background.
+        </li>
+        <li><span class="parameter">objectIdBar</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar sprite.
+        </li>
+        <li><span class="parameter">spriteIdBar</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar.
+        </li>
+        <li><span class="parameter">colorBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of the bar.
+        </li>
+        <li><span class="parameter">posBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar in screen percent (0-100).
+        </li>
+        <li><span class="parameter">rot</span>
+            <span class="types"><span class="type">number</span></span>
+         rotation of the bar's sprite (0-360).
+        </li>
+        <li><span class="parameter">scaleBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's sprite.
+        </li>
+        <li><span class="parameter">alignMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar.
+        </li>
+        <li><span class="parameter">scaleMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar.
+        </li>
+        <li><span class="parameter">blendMode</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar.
+        </li>
+        <li><span class="parameter">text</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         Text to display for the enemy.
+        </li>
+        <li><span class="parameter">textPos</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the text.
+        </li>
+        <li><span class="parameter">textOptions</span>
+            <span class="types"><a class="type" href="../4 enums/Strings.DisplayStringOption.html#">DisplayStringOption</a></span>
+         alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT
+        </li>
+        <li><span class="parameter">textScale</span>
+            <span class="types"><span class="type">number</span></span>
+         Scale factor for the text.
+        </li>
+        <li><span class="parameter">textColor</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of the text.
+        </li>
+        <li><span class="parameter">hideText</span>
+            <span class="types"><span class="type">bool</span></span>
+         Whether to hide the text.
+        </li>
+        <li><span class="parameter">alphaBlendSpeed</span>
+            <span class="types"><span class="type">number</span></span>
+         Speed of alpha blending for bar visibility (0-255).
+        </li>
+        <li><span class="parameter">object</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         Enemy name set in Editor for which to create HP for.
+        </li>
+        <li><span class="parameter">showBar</span>
+            <span class="types"><span class="type">bool</span></span>
+         Option to always show the bar whether the enemy is current target or not. Useful for boss health bars.
+        </li>
+        <li><span class="parameter">blink</span>
+            <span class="types"><span class="type">bool</span></span>
+         Whether the bar blinks.
+        </li>
+        <li><span class="parameter">blinkLimit</span>
+            <span class="types"><span class="type">number</span></span>
+         %Limit below which bar starts blinking (0-1).
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+    <dt>
+    <a name = "enemiesBarData"></a>
+    <strong>enemiesBarData</strong>
+    </dt>
+    <dd>
+    Table setup for creating health bars for all enemies.
+
+
+
+    <h3>Fields:</h3>
+    <ul>
+        <li><span class="parameter">objectIdBg</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar's background sprite.
+        </li>
+        <li><span class="parameter">spriteIdBg</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar's background.
+        </li>
+        <li><span class="parameter">colorBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of bar's background.
+        </li>
+        <li><span class="parameter">posBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar's background in screen percent (0-100).
+        </li>
+        <li><span class="parameter">rotBg</span>
+            <span class="types"><span class="type">number</span></span>
+         rotation of the bar's background. sprite (0-360).
+        </li>
+        <li><span class="parameter">scaleBg</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's background sprite.
+        </li>
+        <li><span class="parameter">alignModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar's background.
+        </li>
+        <li><span class="parameter">scaleModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar's background.
+        </li>
+        <li><span class="parameter">blendModeBg</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar's background.
+        </li>
+        <li><span class="parameter">objectIdBar</span>
+            <span class="types"><a class="type" href="../4 enums/Objects.ObjID.html#">ObjID</a></span>
+         Object ID for the bar sprite.
+        </li>
+        <li><span class="parameter">spriteIdBar</span>
+            <span class="types"><span class="type">number</span></span>
+         SpriteID from the specified object for the bar.
+        </li>
+        <li><span class="parameter">colorBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of the bar.
+        </li>
+        <li><span class="parameter">posBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y position of the bar in screen percent (0-100).
+        </li>
+        <li><span class="parameter">rot</span>
+            <span class="types"><span class="type">number</span></span>
+         rotation of the bar's sprite (0-360).
+        </li>
+        <li><span class="parameter">scaleBar</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Vec2.html#">Vec2</a></span>
+         X,Y Scaling factor for the bar's sprite.
+        </li>
+        <li><span class="parameter">alignMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.AlignMode.html#">AlignMode</a></span>
+         Alignment for the bar.
+        </li>
+        <li><span class="parameter">scaleMode</span>
+            <span class="types"><a class="type" href="../4 enums/View.ScaleMode.html#">ScaleMode</a></span>
+         Scaling for the bar.
+        </li>
+        <li><span class="parameter">blendMode</span>
+            <span class="types"><a class="type" href="../4 enums/Effects.BlendID.html#">BlendID</a></span>
+         Blending modes for the bar.
+        </li>
+        <li><span class="parameter">textPos</span>
+            <span class="types"><span class="type">number</span></span>
+         X position of the text.
+        </li>
+        <li><span class="parameter">textOptions</span>
+            <span class="types"><a class="type" href="../4 enums/Strings.DisplayStringOption.html#">DisplayStringOption</a></span>
+         alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT
+        </li>
+        <li><span class="parameter">textScale</span>
+            <span class="types"><span class="type">number</span></span>
+         Scale factor for the text.
+        </li>
+        <li><span class="parameter">textColor</span>
+            <span class="types"><a class="type" href="../3 primitive classes/Color.html#">Color</a></span>
+         Color of the text.
+        </li>
+        <li><span class="parameter">hideText</span>
+            <span class="types"><span class="type">bool</span></span>
+         Whether to hide the enemy name text.
+        </li>
+        <li><span class="parameter">alphaBlendSpeed</span>
+            <span class="types"><span class="type">number</span></span>
+         Speed of alpha blending for bar visibility (0-255).
+        </li>
+        <li><span class="parameter">blink</span>
+            <span class="types"><span class="type">bool</span></span>
+         Whether the bar blinks.
+        </li>
+        <li><span class="parameter">blinkLimit</span>
+            <span class="types"><span class="type">number</span></span>
+         %Limit below which bar starts blinking (0-1).
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="https://github.com/hispidence/TEN-LDoc">TEN-LDoc</a> (a fork of <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a>)</i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/Documentation/doc/5 lua utility modules/Diary.html b/Documentation/doc/5 lua utility modules/Diary.html
index 492298007..3a0a4c6d5 100644
--- a/Documentation/doc/5 lua utility modules/Diary.html	
+++ b/Documentation/doc/5 lua utility modules/Diary.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <here>Diary</here></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
@@ -114,8 +115,7 @@
 <div id="content">
 
 <h1>Lua utility module <code>Diary</code></h1>
-<p>Diaries:
- The module provides functions to create and manage Diaries.</p>
+<p>This module provides functions to create and manage diaries.</p>
 <p>
 <p> It maintains diary definitions and entries through all levels and hubs.
  Each diary is accessed by the object that was used to create it. </p>
diff --git a/Documentation/doc/5 lua utility modules/EventSequence.html b/Documentation/doc/5 lua utility modules/EventSequence.html
index f12fd2f6f..21199ec26 100644
--- a/Documentation/doc/5 lua utility modules/EventSequence.html	
+++ b/Documentation/doc/5 lua utility modules/EventSequence.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <here>EventSequence</here></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/5 lua utility modules/Timer.html b/Documentation/doc/5 lua utility modules/Timer.html
index 550d1d189..263709641 100644
--- a/Documentation/doc/5 lua utility modules/Timer.html	
+++ b/Documentation/doc/5 lua utility modules/Timer.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <here>Timer</here></li>
diff --git a/Documentation/doc/5 lua utility modules/Type.html b/Documentation/doc/5 lua utility modules/Type.html
index be9f19aa1..ab0d9dcff 100644
--- a/Documentation/doc/5 lua utility modules/Type.html	
+++ b/Documentation/doc/5 lua utility modules/Type.html	
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="../5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="../5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="../5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="../5 lua utility modules/Timer.html">Timer</a></li>
diff --git a/Documentation/doc/index.html b/Documentation/doc/index.html
index d743234d1..1d5a3c407 100644
--- a/Documentation/doc/index.html
+++ b/Documentation/doc/index.html
@@ -103,6 +103,7 @@
 </ul>
 <h2>5 Lua utility modules</h2>
 <ul class="nowrap">
+  <li>    <a href="5 lua utility modules/CustomBar.html">CustomBar</a></li>
   <li>    <a href="5 lua utility modules/Diary.html">Diary</a></li>
   <li>    <a href="5 lua utility modules/EventSequence.html">EventSequence</a></li>
   <li>    <a href="5 lua utility modules/Timer.html">Timer</a></li>
@@ -386,10 +387,13 @@ local door = GetMoveableByName("door_type4_14")
 </table>
 <h2>5 Lua utility modules</h2>
 <table class="module_list">
+	<tr>
+		<td class="name"  ><a href="5 lua utility modules/CustomBar.html">CustomBar</a></td>
+		<td class="summary">This module provides functions for creating and managing custom progress bars.</td>
+	</tr>
 	<tr>
 		<td class="name"  ><a href="5 lua utility modules/Diary.html">Diary</a></td>
-		<td class="summary">Diaries:
- The module provides functions to create and manage Diaries.</td>
+		<td class="summary">This module provides functions to create and manage diaries.</td>
 	</tr>
 	<tr>
 		<td class="name"  ><a href="5 lua utility modules/EventSequence.html">EventSequence</a></td>
diff --git a/Scripts/Engine/CustomBar.lua b/Scripts/Engine/CustomBar.lua
new file mode 100644
index 000000000..a0404199f
--- /dev/null
+++ b/Scripts/Engine/CustomBar.lua
@@ -0,0 +1,951 @@
+------
+-- This module provides functions for creating and managing custom progress bars. It stores bar definitions and configurations in `LevelVars.Engine.CustomBars`, enabling seamless state management. 
+-- Each bar is independently controlled through its associated functions.
+--
+-- Example usage:
+--
+--	local CustomBar = require("Engine.CustomBar")
+--
+--	-- Create a table with all the bar properties
+--	local barData = {
+--		barName             = "water",
+--		startValue          = 0,
+--		maxValue            = 1000,
+--		objectIdBg          = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC,
+--		spriteIdBg          = 0,
+--		colorBg             = TEN.Color(255,255,255),
+--		posBg               = TEN.Vec2(20, 20),
+--		rotBg               = 0,
+--		scaleBg             = TEN.Vec2(19.05, 19.1),
+--		alignModeBg         = TEN.View.AlignMode.CENTER_LEFT,
+--		scaleModeBg         = TEN.View.ScaleMode.FIT,
+--		blendModeBg         = TEN.Effects.BlendID.ALPHABLEND,
+--		objectIdBar         = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC,
+--		spriteIdBar         = 1,
+--		colorBar            = TEN.Color(255,0,0),
+--		posBar              = TEN.Vec2(20.15, 20),
+--		rot                 = 0,
+--		scaleBar            = TEN.Vec2(18.7, 18.48),
+--		alignMode           = TEN.View.AlignMode.CENTER_LEFT,
+--		scaleMode           = TEN.View.ScaleMode.FIT,
+--		blendMode           = TEN.Effects.BlendID.ALPHABLEND,
+--		text                = "Water Bar",
+--		textPos             = TEN.Vec2(20, 15),
+--		textOptions         = {TEN.Strings.DisplayStringOption.SHADOW,TEN.Strings.DisplayStringOption.CENTER},
+--		textScale           = 1,
+--		textColor           = TEN.Color(255,0,0),
+--		hideText            = false,
+--		alphaBlendSpeed     = 50,
+--		blink               = false,
+--		blinkLimit          = 0.25
+--	}
+--
+--	-- This function creates the bar.
+--	CustomBar.Create(barData)
+--
+--	-- This method gets the bar with name "water" and stores it in variable bar.
+--	local bar = CustomBar.Get("water")
+--	-- This method displays the bar
+--	bar:SetVisibility(true)
+--	-- This method sets the bar value to 1000 over 5 seconds.
+--	bar:SetBarValue(1000,5)
+--
+-- @luautil CustomBar
+
+
+local CustomBar = {}
+
+CustomBar.__index = CustomBar
+
+LevelFuncs.Engine.CustomBar = {}
+LevelVars.Engine.CustomBars = {bars = {}, enemiesHpBar = {status = nil}}
+
+---
+-- Creates a custom progress bar with extensive configuration options.
+-- @tparam table barData The table that contains all the bar data. Refer to table setup for barData.
+--
+-- @treturn CustomBar The custombar in its hidden state
+--
+CustomBar.Create = function (barData)
+
+	local dataName	= barData.barName .. "_bar_data"
+	local self = {name = dataName}
+
+	if LevelVars.Engine.CustomBars.bars[dataName] then
+        print("Warning: a customBar with name " .. dataName .. " already exists; overwriting it with a new one...")
+	end
+---
+-- Table setup for creating custom bar.
+-- @table barData
+-- @tfield string barName Unique identifier for the bar.
+-- @tfield float startValue Initial value of the bar.
+-- @tfield float maxValue Maximum value of the bar.
+-- @tfield Objects.ObjID objectIdBg Object ID for the bar's background sprite.
+-- @tfield number spriteIdBg SpriteID from the specified object for the bar's background.
+-- @tfield Color colorBg Color of bar's background.
+-- @tfield Vec2 posBg X,Y position of the bar's background in screen percent (0-100).
+-- @tfield float rotBg rotation of the bar's background. sprite (0-360).
+-- @tfield Vec2 scaleBg X,Y Scaling factor for the bar's background sprite.
+-- @tfield View.AlignMode alignModeBg Alignment for the bar's background.
+-- @tfield View.ScaleMode scaleModeBg Scaling for the bar's background.
+-- @tfield Effects.BlendID blendModeBg Blending modes for the bar's background.
+-- @tfield Objects.ObjID objectIdBar Object ID for the bar sprite.
+-- @tfield number spriteIdBar SpriteID from the specified object for the bar.
+-- @tfield Color colorBar Color of the bar.
+-- @tfield Vec2 posBar X,Y position of the bar in screen percent (0-100).
+-- @tfield float rot rotation of the bar's sprite (0-360).
+-- @tfield Vec2 scaleBar X,Y Scaling factor for the bar's sprite.
+-- @tfield View.AlignMode alignMode Alignment for the bar.
+-- @tfield View.ScaleMode scaleMode Scaling for the bar.
+-- @tfield Effects.BlendID blendMode Blending modes for the bar.
+-- @tfield string text Text to display on the bar.
+-- @tfield Vec2 textPos X,Y position of the text.
+-- @tfield Strings.DisplayStringOption textOptions alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT
+-- @tfield number textScale Scale factor for the text.
+-- @tfield Color textColor Color of the text.
+-- @tfield bool hideText Whether to hide the text.
+-- @tfield number alphaBlendSpeed Speed of alpha blending for bar visibility (0-255).
+-- @tfield bool blink Whether the bar blinks.
+-- @tfield number blinkLimit % Limit below which bar starts blinking (0-1).
+
+	LevelVars.Engine.CustomBars.bars[dataName]			        = {}
+	LevelVars.Engine.CustomBars.bars[dataName].name				= dataName
+	LevelVars.Engine.CustomBars.bars[dataName].fixedInterval	= 1/30
+	LevelVars.Engine.CustomBars.bars[dataName].progress			= barData.startValue / barData.maxValue -- Set initial progress from start value
+	LevelVars.Engine.CustomBars.bars[dataName].objectIdBg		= barData.objectIdBg
+	LevelVars.Engine.CustomBars.bars[dataName].spriteIdBg		= barData.spriteIdBg
+	LevelVars.Engine.CustomBars.bars[dataName].colorBg			= barData.colorBg
+	LevelVars.Engine.CustomBars.bars[dataName].posBg			= barData.posBg
+	LevelVars.Engine.CustomBars.bars[dataName].scaleBg			= barData.scaleBg
+	LevelVars.Engine.CustomBars.bars[dataName].rotBg			= barData.rotBg
+	LevelVars.Engine.CustomBars.bars[dataName].alignModeBg	    = barData.alignModeBg
+	LevelVars.Engine.CustomBars.bars[dataName].scaleModeBg	    = barData.scaleModeBg
+	LevelVars.Engine.CustomBars.bars[dataName].blendModeBg	    = barData.blendModeBg
+	LevelVars.Engine.CustomBars.bars[dataName].objectIdBar		= barData.objectIdBar
+	LevelVars.Engine.CustomBars.bars[dataName].spriteIdBar		= barData.spriteIdBar
+	LevelVars.Engine.CustomBars.bars[dataName].colorBar			= barData.colorBar
+	LevelVars.Engine.CustomBars.bars[dataName].posBar			= barData.posBar
+	LevelVars.Engine.CustomBars.bars[dataName].scaleBar			= barData.scaleBar
+	LevelVars.Engine.CustomBars.bars[dataName].rot				= barData.rot
+	LevelVars.Engine.CustomBars.bars[dataName].alignMode		= barData.alignMode
+	LevelVars.Engine.CustomBars.bars[dataName].scaleMode		= barData.scaleMode
+	LevelVars.Engine.CustomBars.bars[dataName].blendMode		= barData.blendMode
+	LevelVars.Engine.CustomBars.bars[dataName].oldValue			= barData.startValue  -- stores the current bar value
+	LevelVars.Engine.CustomBars.bars[dataName].targetValue		= barData.startValue  -- target value to reach
+	LevelVars.Engine.CustomBars.bars[dataName].maxValue			= barData.maxValue
+	LevelVars.Engine.CustomBars.bars[dataName].text				= barData.text
+	LevelVars.Engine.CustomBars.bars[dataName].textPos			= barData.textPos
+	LevelVars.Engine.CustomBars.bars[dataName].textOptions		= barData.textOptions
+	LevelVars.Engine.CustomBars.bars[dataName].textScale		= barData.textScale
+	LevelVars.Engine.CustomBars.bars[dataName].textColor		= barData.textColor
+	LevelVars.Engine.CustomBars.bars[dataName].hideText			= barData.hideText  -- required to hide bar text
+	LevelVars.Engine.CustomBars.bars[dataName].visible			= false
+	LevelVars.Engine.CustomBars.bars[dataName].currentAlpha		= 0
+	LevelVars.Engine.CustomBars.bars[dataName].targetAlpha		= 0
+	LevelVars.Engine.CustomBars.bars[dataName].alphaBlendSpeed	= barData.alphaBlendSpeed
+	LevelVars.Engine.CustomBars.bars[dataName].blink			= barData.blink
+	LevelVars.Engine.CustomBars.bars[dataName].blinkLimit		= barData.blinkLimit
+	LevelVars.Engine.CustomBars.bars[dataName].blinkSpeed		= 8
+	LevelVars.Engine.CustomBars.bars[dataName].showBar			= nil --required to hide bar when enemy is not targeted
+	LevelVars.Engine.CustomBars.bars[dataName].object			= nil
+	LevelVars.Engine.CustomBars.bars[dataName].getActionType	= nil
+	LevelVars.Engine.CustomBars.bars[dataName].currentTimer		= 0
+    return setmetatable(self, CustomBar)
+end
+
+---
+-- Creates a bar tied to Players's attributes (Health, Air, Stamina).
+-- @tparam table playerBarData The table that contains all the player bar data. Refer to table setup for playerBarData.
+-- @treturn CustomBar Player attribute bar.
+
+CustomBar.CreatePlayerBar = function (playerBarData)
+
+	local barName = "Player" .. playerBarData.getActionType
+	local dataName	= barName .. "_bar_data"
+
+	if playerBarData.getActionType >= 1 and playerBarData.getActionType <= 3 then
+		local startValue = playerBarData.getActionType == 1 and Lara:GetHP() or
+		(playerBarData.getActionType == 2 and Lara:GetAir() or
+		(playerBarData.getActionType == 3 and Lara:GetStamina()))
+		local maxValue = playerBarData.getActionType == 1 and 1000 or (playerBarData.getActionType == 2 and 1800 or (playerBarData.getActionType == 3 and 120))
+
+---
+-- Table setup for creating custom player attribute bar.
+-- @table playerBarData
+-- @tfield number getActionType Determines the bar type: 1: Health, 2: Air, 3: Stamina.
+-- @tfield Objects.ObjID objectIdBg Object ID for the bar's background sprite.
+-- @tfield number spriteIdBg SpriteID from the specified object for the bar's background.
+-- @tfield Color colorBg Color of bar's background.
+-- @tfield Vec2 posBg X,Y position of the bar's background in screen percent (0-100).
+-- @tfield number rotBg rotation of the bar's background. sprite (0-360).
+-- @tfield Vec2 scaleBg X,Y Scaling factor for the bar's background sprite.
+-- @tfield View.AlignMode alignModeBg Alignment for the bar's background.
+-- @tfield View.ScaleMode scaleModeBg Scaling for the bar's background.
+-- @tfield Effects.BlendID blendModeBg Blending modes for the bar's background.
+-- @tfield Objects.ObjID objectIdBar Object ID for the bar sprite.
+-- @tfield number spriteIdBar SpriteID from the specified object for the bar.
+-- @tfield Color colorBar Color of the bar.
+-- @tfield Vec2 posBar X,Y position of the bar in screen percent (0-100).
+-- @tfield number rot rotation of the bar's sprite (0-360).
+-- @tfield Vec2 scaleBar X,Y Scaling factor for the bar's sprite.
+-- @tfield View.AlignMode alignMode Alignment for the bar.
+-- @tfield View.ScaleMode scaleMode Scaling for the bar.
+-- @tfield Effects.BlendID blendMode Blending modes for the bar.
+-- @tfield number alphaBlendSpeed Speed of alpha blending for bar visibility (0-255).
+-- @tfield bool showBar Option to always show the bar. If set to false, the bars will automatically hide when they stop updating.
+-- @tfield bool blink Whether the bar blinks.
+-- @tfield number blinkLimit % Limit below which bar starts blinking (0-1).
+
+		local playerBar = {
+			barName			= barName,
+			startValue		= startValue,
+			maxValue		= maxValue,
+			objectIdBg		= playerBarData.objectIdBg,
+			spriteIdBg		= playerBarData.spriteIdBg,
+			colorBg			= playerBarData.colorBg,
+			posBg			= playerBarData.posBg,
+			rotBg			= playerBarData.rotBg,
+			scaleBg			= playerBarData.scaleBg,
+			alignModeBg		= playerBarData.alignModeBg,
+			scaleModeBg		= playerBarData.scaleModeBg,
+			blendModeBg		= playerBarData.blendModeBg,
+			objectIdBar		= playerBarData.objectIdBar,
+			spriteIdBar		= playerBarData.spriteIdBar,
+			colorBar		= playerBarData.colorBar,
+			posBar			= playerBarData.posBar,
+			rot				= playerBarData.rot,
+			scaleBar		= playerBarData.scaleBar,
+			alignMode		= playerBarData.alignMode,
+			scaleMode		= playerBarData.scaleMode,
+			blendMode		= playerBarData.blendMode,
+			text			= "BLANK",
+			textPos			= TEN.Vec2(0,0),
+			textOptions		= {},
+			textScale		= 0,
+			textColor		= TEN.Color(0,0,0),
+			hideText		= true,
+			alphaBlendSpeed	= playerBarData.alphaBlendSpeed,
+			blink			= playerBarData.blink,
+			blinkLimit		= playerBarData.blinkLimit,
+		}
+
+		CustomBar.Create(playerBar)
+
+	end
+
+	LevelVars.Engine.CustomBars.bars[dataName].getActionType	= playerBarData.getActionType
+	LevelVars.Engine.CustomBars.bars[dataName].showBar			= playerBarData.showBar
+	LevelVars.Engine.CustomBars.bars[dataName].visible			= true
+	LevelVars.Engine.CustomBars.bars[dataName].targetAlpha		= 255
+
+end
+
+---
+-- Creates a custom health bar for a specific enemy (like a boss). Ensure this function is called before Lara aims at the enemy if using generic enemy HP bars as well.
+-- Also be sure to call this function after increasing the HP of the enemy via LUA.
+-- @tparam table enemyBarData The table that contains all the enemy bar data. Refer to table setup for enemyBarData.
+-- @treturn CustomBar Enemy health bar.
+CustomBar.CreateEnemyHpBar = function (enemyBarData)
+
+	local dataName	= enemyBarData.barName .. "_bar_data"
+	local enemyHP = TEN.Objects.GetMoveableByName(enemyBarData.object):GetHP()
+
+---
+-- Table setup for creating a specific enemy health bar.
+-- @table enemyBarData
+-- @tfield string barName Unique identifier for the bar.
+-- @tfield Objects.ObjID objectIdBg Object ID for the bar's background sprite.
+-- @tfield number spriteIdBg SpriteID from the specified object for the bar's background.
+-- @tfield Color colorBg Color of bar's background.
+-- @tfield Vec2 posBg X,Y position of the bar's background in screen percent (0-100).
+-- @tfield number rotBg rotation of the bar's background. sprite (0-360).
+-- @tfield Vec2 scaleBg X,Y Scaling factor for the bar's background sprite.
+-- @tfield View.AlignMode alignModeBg Alignment for the bar's background.
+-- @tfield View.ScaleMode scaleModeBg Scaling for the bar's background.
+-- @tfield Effects.BlendID blendModeBg Blending modes for the bar's background.
+-- @tfield Objects.ObjID objectIdBar Object ID for the bar sprite.
+-- @tfield number spriteIdBar SpriteID from the specified object for the bar.
+-- @tfield Color colorBar Color of the bar.
+-- @tfield Vec2 posBar X,Y position of the bar in screen percent (0-100).
+-- @tfield number rot rotation of the bar's sprite (0-360).
+-- @tfield Vec2 scaleBar X,Y Scaling factor for the bar's sprite.
+-- @tfield View.AlignMode alignMode Alignment for the bar.
+-- @tfield View.ScaleMode scaleMode Scaling for the bar.
+-- @tfield Effects.BlendID blendMode Blending modes for the bar.
+-- @tfield string text Text to display for the enemy.
+-- @tfield Vec2 textPos X,Y position of the text.
+-- @tfield Strings.DisplayStringOption textOptions alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT
+-- @tfield number textScale Scale factor for the text.
+-- @tfield Color textColor Color of the text.
+-- @tfield bool hideText Whether to hide the text.
+-- @tfield number alphaBlendSpeed Speed of alpha blending for bar visibility (0-255).
+-- @tfield string object Enemy name set in Editor for which to create HP for.
+-- @tfield bool showBar Option to always show the bar whether the enemy is current target or not. Useful for boss health bars.
+-- @tfield bool blink Whether the bar blinks.
+-- @tfield number blinkLimit %Limit below which bar starts blinking (0-1).
+	
+	local enemyBar = {
+		barName			= enemyBarData.barName,
+		startValue		= enemyHP,
+		maxValue		= enemyHP,
+		objectIdBg		= enemyBarData.objectIdBg,
+		spriteIdBg		= enemyBarData.spriteIdBg,
+		colorBg			= enemyBarData.colorBg,
+		posBg			= enemyBarData.posBg,
+		rotBg			= enemyBarData.rotBg,
+		scaleBg			= enemyBarData.scaleBg,
+		alignModeBg		= enemyBarData.alignModeBg,
+		scaleModeBg		= enemyBarData.scaleModeBg,
+		blendModeBg		= enemyBarData.blendModeBg,
+		objectIdBar		= enemyBarData.objectIdBar,
+		spriteIdBar		= enemyBarData.spriteIdBar,
+		colorBar		= enemyBarData.colorBar,
+		posBar			= enemyBarData.posBar,
+		rot				= enemyBarData.rot,
+		scaleBar		= enemyBarData.scaleBar,
+		alignMode		= enemyBarData.alignMode,
+		scaleMode		= enemyBarData.scaleMode,
+		blendMode		= enemyBarData.blendMode,
+		text			= enemyBarData.text,
+		textPos			= enemyBarData.textPos,
+		textOptions		= enemyBarData.textOptions,
+		textScale		= enemyBarData.textScale,
+		textColor		= enemyBarData.textColor,
+		hideText		= enemyBarData.hideText,
+		alphaBlendSpeed	= enemyBarData.alphaBlendSpeed,
+		blink			= enemyBarData.blink,
+		blinkLimit		= enemyBarData.blinkLimit
+	}
+
+	CustomBar.Create(enemyBar)
+
+	LevelVars.Engine.CustomBars.bars[dataName].showBar			= enemyBarData.showBar
+	LevelVars.Engine.CustomBars.bars[dataName].object			= enemyBarData.object
+	LevelVars.Engine.CustomBars.bars[dataName].getActionType	= 0
+	LevelVars.Engine.CustomBars.bars[dataName].visible			= true
+	LevelVars.Engine.CustomBars.bars[dataName].fixedInterval	= 1/3
+	LevelVars.Engine.CustomBars.bars[dataName].currentAlpha		= 0
+	LevelVars.Engine.CustomBars.bars[dataName].targetAlpha		= 255
+
+end
+
+---
+-- Creates health bars for all enemies. A new bar is generated whenever Lara targets an enemy. If the "hide text" option is disabled, the enemy's name (as set in the editor) is displayed. 
+-- Multiple enemies can share the same name by appending _number to the name in the editor. If adjusting an enemy's max HP, ensure this is done before Lara targets the enemy.
+-- To create health bars for specific enemies, use CustomBar.CreateEnemyHpBar, ensuring the bar is created prior to targeting.
+-- @tparam table enemiesBarData The table that contains all the enemies bar data. Refer to table setup for enemiesBarData.
+-- @treturn CustomBar Enemy health bars.
+
+CustomBar.SetEnemiesHpGenericBar = function (enemiesBarData)
+
+	if LevelVars.Engine.CustomBars.enemiesHpBar.objectIdBg then
+        print("Warning: Overwriting enemy HP bar definitions")
+	end
+
+---
+-- Table setup for creating health bars for all enemies.
+-- @table enemiesBarData
+-- @tfield Objects.ObjID objectIdBg Object ID for the bar's background sprite.
+-- @tfield number spriteIdBg SpriteID from the specified object for the bar's background.
+-- @tfield Color colorBg Color of bar's background.
+-- @tfield Vec2 posBg X,Y position of the bar's background in screen percent (0-100).
+-- @tfield number rotBg rotation of the bar's background. sprite (0-360).
+-- @tfield Vec2 scaleBg X,Y Scaling factor for the bar's background sprite.
+-- @tfield View.AlignMode alignModeBg Alignment for the bar's background.
+-- @tfield View.ScaleMode scaleModeBg Scaling for the bar's background.
+-- @tfield Effects.BlendID blendModeBg Blending modes for the bar's background.
+-- @tfield Objects.ObjID objectIdBar Object ID for the bar sprite.
+-- @tfield number spriteIdBar SpriteID from the specified object for the bar.
+-- @tfield Color colorBar Color of the bar.
+-- @tfield Vec2 posBar X,Y position of the bar in screen percent (0-100).
+-- @tfield number rot rotation of the bar's sprite (0-360).
+-- @tfield Vec2 scaleBar X,Y Scaling factor for the bar's sprite.
+-- @tfield View.AlignMode alignMode Alignment for the bar.
+-- @tfield View.ScaleMode scaleMode Scaling for the bar.
+-- @tfield Effects.BlendID blendMode Blending modes for the bar.
+-- @tfield number textPos X position of the text.
+-- @tfield Strings.DisplayStringOption textOptions alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT
+-- @tfield number textScale Scale factor for the text.
+-- @tfield Color textColor Color of the text.
+-- @tfield bool hideText Whether to hide the enemy name text.
+-- @tfield number alphaBlendSpeed Speed of alpha blending for bar visibility (0-255).
+-- @tfield bool blink Whether the bar blinks.
+-- @tfield number blinkLimit %Limit below which bar starts blinking (0-1).
+
+	LevelVars.Engine.CustomBars.enemiesHpBar.objectIdBg			= enemiesBarData.objectIdBg
+	LevelVars.Engine.CustomBars.enemiesHpBar.spriteIdBg			= enemiesBarData.spriteIdBg
+	LevelVars.Engine.CustomBars.enemiesHpBar.colorBg			= enemiesBarData.colorBg
+	LevelVars.Engine.CustomBars.enemiesHpBar.posBg				= enemiesBarData.posBg
+	LevelVars.Engine.CustomBars.enemiesHpBar.scaleBg			= enemiesBarData.scaleBg
+	LevelVars.Engine.CustomBars.enemiesHpBar.rotBg				= enemiesBarData.rotBg
+	LevelVars.Engine.CustomBars.enemiesHpBar.alignModeBg	    = enemiesBarData.alignModeBg
+	LevelVars.Engine.CustomBars.enemiesHpBar.scaleModeBg	    = enemiesBarData.scaleModeBg
+	LevelVars.Engine.CustomBars.enemiesHpBar.blendModeBg	    = enemiesBarData.blendModeBg
+	LevelVars.Engine.CustomBars.enemiesHpBar.objectIdBar		= enemiesBarData.objectIdBar
+	LevelVars.Engine.CustomBars.enemiesHpBar.spriteIdBar		= enemiesBarData.spriteIdBar
+	LevelVars.Engine.CustomBars.enemiesHpBar.colorBar			= enemiesBarData.colorBar
+	LevelVars.Engine.CustomBars.enemiesHpBar.posBar				= enemiesBarData.posBar
+	LevelVars.Engine.CustomBars.enemiesHpBar.scaleBar			= enemiesBarData.scaleBar
+	LevelVars.Engine.CustomBars.enemiesHpBar.rot				= enemiesBarData.rot
+	LevelVars.Engine.CustomBars.enemiesHpBar.alignMode			= enemiesBarData.alignMode
+	LevelVars.Engine.CustomBars.enemiesHpBar.scaleMode			= enemiesBarData.scaleMode
+	LevelVars.Engine.CustomBars.enemiesHpBar.blendMode			= enemiesBarData.blendMode
+	LevelVars.Engine.CustomBars.enemiesHpBar.textPos			= enemiesBarData.textPos
+	LevelVars.Engine.CustomBars.enemiesHpBar.textOptions		= enemiesBarData.textOptions
+	LevelVars.Engine.CustomBars.enemiesHpBar.textScale			= enemiesBarData.textScale
+	LevelVars.Engine.CustomBars.enemiesHpBar.textColor			= enemiesBarData.textColor
+	LevelVars.Engine.CustomBars.enemiesHpBar.hideText			= enemiesBarData.hideText
+	LevelVars.Engine.CustomBars.enemiesHpBar.alphaBlendSpeed	= enemiesBarData.alphaBlendSpeed
+	LevelVars.Engine.CustomBars.enemiesHpBar.blink				= enemiesBarData.blink
+	LevelVars.Engine.CustomBars.enemiesHpBar.blinkLimit			= enemiesBarData.blinkLimit
+
+
+	LevelVars.Engine.CustomBars.enemiesHpBar.status = true
+
+end
+
+--- The function retrieves an existing bar instance by its unique identifier (barName). This function is useful when you need to access or manipulate a bar that has already been created.
+-- @string barName The unique identifier assigned to the bar when it was created using CustomBar.New
+CustomBar.Get = function(barName)
+	local dataName = barName .. "_bar_data"
+    if LevelVars.Engine.CustomBars.bars[dataName] then
+        local self = {name = dataName}
+        return setmetatable(self, CustomBar)
+    end
+end
+
+--- The function removes a custom bar and its associated data from the system. It ensures that the bar is no longer tracked or accessible in the LevelVars.Engine.CustomBars.bars table.
+-- @string barName The name of the custom bar to be deleted.
+CustomBar.Delete = function (barName)
+    local dataName = barName .. "_bar_data"
+	if LevelVars.Engine.CustomBars.bars[dataName] then
+		LevelVars.Engine.CustomBars.bars[dataName] = nil
+	end
+end
+
+--- The function sets the value of a custom bar over a specified time period.
+-- @number value The new target to which the bar's current value should transition. (Must be a non-negative number; between 0 and the bar's maxValue.
+-- @number time The time (in seconds) over which the bar's value should transition to the target value.
+function CustomBar:SetBarValue(value, time)
+	if LevelVars.Engine.CustomBars.bars[self.name] then
+		if type(value) =="number" and value >= 0 then
+			local currentValue = LevelVars.Engine.CustomBars.bars[self.name].oldValue
+			local maxValue = LevelVars.Engine.CustomBars.bars[self.name].maxValue
+			local newTargetValue = math.max(0, math.min(maxValue, value))
+			LevelVars.Engine.CustomBars.bars[self.name].targetValue = newTargetValue
+			LevelVars.Engine.CustomBars.bars[self.name].fixedInterval = (newTargetValue - currentValue) / (time * 30)
+		end
+	end
+end
+
+--- The function adjusts the bar's value relative to its current or target value over a specified time span.
+-- @number value The relative value to add (positive or negative) to the current bar value.
+-- @number time The duration (in seconds) over which the change should occur.
+function CustomBar:ChangeBarValueOverTimespan(value, time)
+    -- Check if bar data and timer exist
+	if LevelVars.Engine.CustomBars.bars[self.name] then
+
+		-- Get the current target value or old value if no target value exists
+		local currentValue = LevelVars.Engine.CustomBars.bars[self.name].oldValue
+		local maxValue = LevelVars.Engine.CustomBars.bars[self.name].maxValue
+		local currentTarget = LevelVars.Engine.CustomBars.bars[self.name].targetValue or currentValue
+
+		-- Calculate new target value by adding the relative 'value' and clamp between 0 and 1000
+		local newTargetValue = math.max(0, math.min(maxValue, currentTarget + value))
+
+		-- Set the new target value
+		LevelVars.Engine.CustomBars.bars[self.name].targetValue = newTargetValue
+
+		-- Calculate total frames based on time and FPS (30 FPS)
+		local totalFrames = time * 30
+
+		-- Calculate the fixed interval for the entire transition
+		LevelVars.Engine.CustomBars.bars[self.name].fixedInterval = (newTargetValue - currentValue) / totalFrames
+	end
+end
+
+--- The function controls the visibility of a custom bar.
+-- @bool visible true: Makes the bar visible.; false: Hides the bar.
+function CustomBar:SetVisibility(visible)
+    --the visible variable is a boolean
+	if LevelVars.Engine.CustomBars.bars[self.name] then
+		if visible and type(visible) == "boolean" then
+			LevelVars.Engine.CustomBars.bars[self.name].targetAlpha = 255
+			LevelVars.Engine.CustomBars.bars[self.name].visible = true
+		else
+			LevelVars.Engine.CustomBars.bars[self.name].targetAlpha = 0
+		end
+	end
+end
+
+--- The function checks whether a custom bar is currently visible.
+-- @treturn bool true if the bar is visible and false if it is not.
+function CustomBar:IsVisible()
+    
+	if LevelVars.Engine.CustomBars.bars[self.name] then
+		if LevelVars.Engine.CustomBars.bars[self.name].visible then
+			return true
+		else
+			return false
+		end
+	end
+end
+
+--- The function retrieves the current value of a custom bar.
+-- @treturn float returns the current value of a custom bar.
+function CustomBar:GetValue()
+	
+    if LevelVars.Engine.CustomBars.bars[self.name] then
+        return LevelVars.Engine.CustomBars.bars[self.name].oldValue
+	end
+end
+
+--- The function deletes all custom bars.
+CustomBar.DeleteAllBars = function ()
+	for _, customBar in pairs (LevelVars.Engine.CustomBars.bars) do
+		LevelVars.Engine.CustomBars.bars[customBar.name] = nil
+	end
+end
+
+--- This function prevents the creation of new health bars for enemies when set to false. However, it does not affect the health bars that have already been created.
+-- @bool value Specifies whether new health bars for enemies should be created. 
+CustomBar.ShowEnemiesHpGenericBar = function(value)
+	if type(value) == "boolean" then
+		LevelVars.Engine.CustomBars.enemiesHpBar.status = value
+	end
+end
+
+--- The function deletes all the enemy health bars excluding those created by CustomBar.CreateEnemyHpBar.
+CustomBar.DeleteExistingHpGenericBars = function ()
+	for _, customBar in pairs (LevelVars.Engine.CustomBars.bars) do
+		if customBar.getActionType == 4 then
+			LevelVars.Engine.CustomBars.bars[customBar.name] = nil
+		end
+	end
+end
+
+--- Sets the custom bar background sprite position.
+-- @tparam Vec2 pos X,Y position of the bar's background in screen percent (0-100).
+--
+function CustomBar:SetBackgroundPosition(pos)
+	if pos and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].posBg = pos
+	end
+end
+
+--- Sets the custom bar background sprite rotation.
+-- @tparam number rot rotation of the bar's background. sprite (0-360).
+--
+function CustomBar:SetBackgroundRotation(rot)
+	if rot and  LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].rotBg = rot
+	end
+end
+
+-- Sets the custom bar background sprite color.
+-- @tparam Color color Color of bar's background.
+--
+function CustomBar:SetBackgroundColor(color)
+	if color and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].colorBg = color
+	end
+end
+
+---
+-- Sets the custom bar background sprite scale.
+-- @tparam Vec2 scale X,Y Scaling factor for the bar's background sprite.
+--
+function CustomBar:SetBackgroundScale(scale)
+	if scale and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].scaleBg = scale
+	end
+end
+
+---
+-- Sets the custom bar background sprite slot and sprite ID.
+-- @tparam Objects.ObjID slot Object ID for the bar's background sprite.
+-- @tparam number id SpriteID from the specified object for the bar's background.
+--
+function CustomBar:SetBackgroundSpriteSlot(slot, id)
+	if slot and id and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].objectIdBg = slot
+		LevelVars.Engine.CustomBars.bars[self.name].spriteIdBg = id
+	end
+end
+
+---
+-- Sets the custom bar background sprite align mode.
+-- @tparam View.AlignMode alignMode Alignment for the bar's background.
+--
+function CustomBar:SetBackgroundAlignMode(alignMode)
+	if alignMode and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].alignModeBg = alignMode
+	end
+end
+---
+-- Sets the custom bar background sprite scale mode.
+-- @tparam View.ScaleMode scaleMode Scaling for the bar's background.
+--
+function CustomBar:SetBackgroundScaleMode(scaleMode)
+	if scaleMode and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].scaleModeBg = scaleMode
+	end
+end
+---
+-- Sets the custom bar background sprite blend mode.
+-- @tparam Effects.BlendID blendMode Blending modes for the bar's background.
+--
+function CustomBar:SetBackgroundBlendMode(blendMode)
+	if blendMode and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].blendModeBg = blendMode
+	end
+end
+
+---
+-- Sets the custom bar sprite position.
+-- @tparam Vec2 pos X,Y position of the bar in screen percent (0-100).
+--
+function CustomBar:SetBarPosition(pos)
+	if pos and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].posBar = pos
+	end
+end
+---
+-- Sets the custom bar sprite rotation.
+-- @tparam number rot rotation of the bar's sprite (0-360).
+--
+function CustomBar:SetBarRotation(rot)
+	if rot and  LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].rot = rot
+	end
+end
+---
+-- Sets the custom bar sprite color.
+-- @tparam Color color Color of the bar.
+--
+function CustomBar:SetBarColor(color)
+	if color and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].colorBar = color
+	end
+end
+---
+-- Sets the custom bar sprite scale.
+-- @tparam Vec2 scale X,Y Scaling factor for the bar's sprite.
+--
+function CustomBar:SetBarScale(scale)
+	if scale and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].scaleBar = scale
+	end
+end
+---
+-- Sets the custom bar sprite slot and sprite ID.
+-- @tparam Objects.ObjID slot Object ID for the bar sprite.
+-- @tparam number id SpriteID from the specified object for the bar.
+--
+function CustomBar:SetBarSpriteSlot(slot, id)
+	if slot and id and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].objectIdBar = slot
+		LevelVars.Engine.CustomBars.bars[self.name].spriteIdBar = id
+	end
+end
+---
+-- Sets the custom bar sprite alignment mode.
+-- @tparam View.AlignMode alignMode Alignment for the bar.
+--
+function CustomBar:SetBarAlignMode(alignMode)
+	if alignMode and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].alignMode = alignMode
+	end
+end
+---
+-- Sets the custom bar sprite scale mode.
+-- @tparam View.ScaleMode scaleMode Scaling for the bar.
+--
+function CustomBar:SetBarScaleMode(scaleMode)
+	if scaleMode and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].scaleMode = scaleMode
+	end
+end
+---
+-- Sets the custom bar sprite blend mode.
+-- @tparam Effects.BlendID blendMode Blending modes for the bar.
+--
+function CustomBar:SetBarBlendMode(blendMode)
+	if blendMode and LevelVars.Engine.CustomBars.bars[self.name] then
+		LevelVars.Engine.CustomBars.bars[self.name].blendMode = blendMode
+	end
+end
+
+LevelFuncs.Engine.CustomBar.UpdateCustomBars = function()
+	
+	local playerTarget = Lara:GetTarget()
+	
+	if playerTarget ~= nil and LevelVars.Engine.CustomBars.enemiesHpBar.status then
+		local playerTargetName = playerTarget:GetName()
+		local displayName = LevelFuncs.Engine.Node.SplitString(playerTargetName, "_")
+		local enemytable = playerTargetName .. "_bar_data"
+		if LevelVars.Engine.CustomBars.bars[enemytable] == nil then
+			local eB = LevelVars.Engine.CustomBars.enemiesHpBar
+
+			local enemyBar = {
+				barName			= playerTargetName,
+				objectIdBg		= eB.objectIdBg,
+				spriteIdBg		= eB.spriteIdBg,
+				colorBg			= eB.colorBg,
+				posBg			= eB.posBg,
+				rotBg			= eB.rotBg,
+				scaleBg			= eB.scaleBg,
+				alignModeBg		= eB.alignModeBg,
+				scaleModeBg		= eB.scaleModeBg,
+				blendModeBg		= eB.blendModeBg,
+				objectIdBar		= eB.objectIdBar,
+				spriteIdBar		= eB.spriteIdBar,
+				colorBar		= eB.colorBar,
+				posBar			= eB.posBar,
+				rot				= eB.rot,
+				scaleBar		= eB.scaleBar,
+				alignMode		= eB.alignMode,
+				scaleMode		= eB.scaleMode,
+				blendMode		= eB.blendMode,
+				text			= displayName[1],
+				textPos			= eB.textPos,
+				textOptions		= eB.textOptions,
+				textScale		= eB.textScale,
+				textColor		= eB.textColor,
+				hideText		= eB.hideText,
+				alphaBlendSpeed	= eB.alphaBlendSpeed,
+				blink			= eB.blink,
+				blinkLimit		= eB.blinkLimit,
+				showBar 		= false,
+				object			= playerTargetName
+			}
+			
+			CustomBar.CreateEnemyHpBar(enemyBar)
+			LevelVars.Engine.CustomBars.bars[enemytable].getActionType = 4
+
+		end
+	end
+	
+	for _, customBar in pairs (LevelVars.Engine.CustomBars.bars) do
+
+		if customBar ~= nil then
+			-- Smoothly transition to target value
+			local currentValue = customBar.oldValue or 0
+			local targetValue = customBar.targetValue or 0
+			local delta = customBar.fixedInterval
+
+			if customBar.object ~=nil and (customBar.getActionType == 0 or customBar.getActionType == 4) then
+				local enemy = GetMoveableByName(customBar.object)
+				currentValue = enemy:GetHP()
+
+				targetValue = currentValue
+
+				customBar.progress = math.max(0, math.min(currentValue / customBar.maxValue, 1))
+
+				if customBar.showBar == true then
+					-- If showBar is true, the bar is always visible at full alpha
+					customBar.targetAlpha = 255
+					customBar.visible = true
+				else
+					-- If showBar is false, only show the bar if the enemy is the player's current target
+					if playerTarget == enemy then
+						customBar.targetAlpha = 255  -- Set to full alpha if this enemy is the target
+						customBar.visible = true
+					else
+						customBar.targetAlpha = 0  -- Set to 0 alpha if this enemy is not the target
+					end
+				end
+
+				if currentValue <= 0 then
+					customBar.targetAlpha = 0
+				end
+				
+				-- When Alpha reaches 0 set visibility to false
+				if currentValue <= 0 and customBar.currentAlpha == 0 then
+					customBar.visible = false
+					LevelVars.Engine.CustomBars.bars[customBar.name] = nil
+				end
+			end
+
+			if customBar.getActionType == 1 then
+								
+				currentValue = Lara:GetHP()
+				targetValue = currentValue
+				
+				customBar.progress = math.max(0, math.min(currentValue / customBar.maxValue, 1))
+
+				-- Check if `hideBar` is true, which overrides all other behaviors
+				if customBar.showBar == true then
+					customBar.targetAlpha = 255  -- Bar is always visible
+					customBar.visible = true
+
+				elseif currentValue ~= (customBar.oldValue or currentValue) then
+					customBar.targetAlpha = 255  -- Show the bar if value changes
+					customBar.visible = true
+
+					customBar.currentTimer = customBar.currentTimer + 1
+
+						if customBar.currentTimer >= 90 then
+							customBar.oldValue = currentValue
+							customBar.currentTimer = 0
+						end
+				
+				elseif Lara:GetHandStatus() == 0 and currentValue >= customBar.blinkLimit*1000 then
+						-- Hide bar if hands are free and HP is 200 or more
+						customBar.targetAlpha = 0
+						customBar.visible = false
+
+				elseif Lara:GetHandStatus() == 2 or Lara:GetHandStatus() == 3 or Lara:GetHandStatus() == 4 then
+						-- Show bar if hand status is 2, 3, or 4 (weapon drawn)
+						customBar.targetAlpha = 255
+						customBar.visible = true
+
+				elseif Lara:GetHandStatus() == 0 and currentValue < customBar.blinkLimit*1000 then
+						-- Show bar if hands are free and HP is less than 200
+						customBar.targetAlpha = 255
+						customBar.visible = true
+				end
+
+			elseif customBar.getActionType == 2 then
+				currentValue = Lara:GetAir()
+				targetValue = currentValue
+
+				customBar.progress = math.max(0, math.min(currentValue / customBar.maxValue, 1))
+
+				if customBar.showBar == true then
+					-- If showBar is true, the bar is always visible
+					customBar.targetAlpha = 255
+					customBar.visible = true
+				else
+					-- If showBar is false, hide the bar when currentValue is at max
+					if currentValue == customBar.maxValue then
+						customBar.targetAlpha = 0  -- Hide the bar when at max value
+					else
+						customBar.targetAlpha = 255  -- Show the bar if currentValue is not max
+						customBar.visible = true
+					end
+				end
+				
+			elseif customBar.getActionType == 3 then 
+				currentValue = Lara:GetStamina()
+				targetValue = currentValue
+
+				customBar.progress = math.max(0, math.min(currentValue / customBar.maxValue, 1))
+				
+				if customBar.showBar == true then
+					-- If showBar is true, the bar is always visible
+					customBar.targetAlpha = 255
+					customBar.visible = true
+				else
+					-- If showBar is false, hide the bar when currentValue is at max
+					if currentValue == customBar.maxValue then
+						customBar.targetAlpha = 0  -- Hide the bar when at max value
+					else
+						customBar.targetAlpha = 255  -- Show the bar if currentValue is not max
+						customBar.visible = true
+					end
+				end
+
+			end
+
+			if currentValue ~= targetValue then
+				-- Update current value by delta (increment or decrement)
+				if currentValue < targetValue then
+					currentValue = math.min(currentValue + delta, targetValue)
+				else
+					currentValue = math.max(currentValue + delta, targetValue)
+				end
+
+				-- Update the bar's progress (0-1 scale)
+				customBar.oldValue = currentValue
+				customBar.progress = currentValue / customBar.maxValue
+			end
+			-- Smoothly transition alpha
+			if customBar.currentAlpha ~= customBar.targetAlpha then
+				local alphaDelta = customBar.alphaBlendSpeed
+				if customBar.currentAlpha < customBar.targetAlpha then
+					customBar.currentAlpha = math.floor(math.min(customBar.currentAlpha + alphaDelta, customBar.targetAlpha))
+				else
+					customBar.currentAlpha = math.floor(math.max(customBar.currentAlpha - alphaDelta, customBar.targetAlpha))
+				end
+			end
+			
+			-- Set parameters to draw the background
+			local posBg = customBar.posBg
+			local scaleBg = customBar.scaleBg
+			local rotBg = customBar.rotBg
+			local alignMBg = LevelFuncs.Engine.Node.GetDisplaySpriteAlignMode(customBar.alignModeBg)
+			local scaleMBg = LevelFuncs.Engine.Node.GetDisplaySpriteScaleMode(customBar.scaleModeBg)
+			local blendIdBg = LevelFuncs.Engine.Node.GetBlendMode(customBar.blendModeBg)
+
+			-- Adjust color with alpha blending
+			local bgColor = Color(customBar.colorBg.r,customBar.colorBg.g,customBar.colorBg.b,customBar.currentAlpha)
+			
+			-- Set parameters to draw the bar
+			local pos = customBar.posBar
+			local rot = customBar.rot
+			local alignM = LevelFuncs.Engine.Node.GetDisplaySpriteAlignMode(customBar.alignMode)
+			local scaleM = LevelFuncs.Engine.Node.GetDisplaySpriteScaleMode(customBar.scaleMode)
+			local blendID = LevelFuncs.Engine.Node.GetBlendMode(customBar.blendMode)
+			local barColor = TEN.Color(customBar.colorBar.r,customBar.colorBar.g,customBar.colorBar.b,customBar.currentAlpha)
+			
+			-- when Alpha reaches 0 set visibility to false
+			if customBar.currentAlpha > 0 then
+				customBar.visible = true
+			elseif customBar.currentAlpha == 0 then
+				customBar.visible = false
+			end
+			
+			--draw bar if alpha is greater than 1 and visibility is true
+			if customBar.visible and customBar.currentAlpha > 0 then
+				-- Draw background sprite
+				local bgSprite = TEN.DisplaySprite(customBar.objectIdBg, customBar.spriteIdBg, posBg, rotBg, scaleBg, bgColor)
+				bgSprite:Draw(0, alignMBg, scaleMBg, blendIdBg)
+
+				-- Draw foreground sprite (the bar itself) proportional to Progress
+				local barScale = TEN.Vec2(customBar.scaleBar.x * customBar.progress, customBar.scaleBar.y)
+				local barSprite = TEN.DisplaySprite(customBar.objectIdBar, customBar.spriteIdBar, pos, rot, barScale, barColor)
+				
+				if customBar.frameCounter == nil then
+					customBar.frameCounter = 0
+				end
+				
+				-- Calculate HP percentage
+				local Percentage = (currentValue / customBar.maxValue)
+				
+				-- Update frame counter
+				customBar.frameCounter = customBar.frameCounter + 1
+				
+				-- Check if blink is enabled and value is below blinkLimit
+				if customBar.blink == true and Percentage <= customBar.blinkLimit then
+					-- Only draw the sprite every other frame
+					if customBar.frameCounter % (customBar.blinkSpeed * 2) < customBar.blinkSpeed then
+						barSprite:Draw(1, alignM, scaleM, blendID)
+					end
+				else
+					-- Draw the sprite normally if blink is off or value is above blinkLimit
+					barSprite:Draw(1, alignM, scaleM, blendID)
+				end
+				
+				-- Reset the frame counter if it reaches the blinkSpeed limit to prevent overflow
+				if customBar.frameCounter >= customBar.blinkSpeed * 2 then
+					customBar.frameCounter = 0
+				end
+			
+				if customBar.hideText == false then
+					-- Draw text (enemy name and health)
+					local barText = tostring(customBar.text) --debug text	 .. " (" .. currentHP .. " / " .. totalHP .. ")"
+					local textColor = TEN.Color(customBar.textColor.r, customBar.textColor.g, customBar.textColor.b, customBar.currentAlpha)
+					local posInPixel = TEN.Vec2(TEN.Util.PercentToScreen(customBar.textPos.x, customBar.textPos.y))
+					local IsString = TEN.Flow.IsStringPresent(barText)
+					local myText = TEN.Strings.DisplayString(barText, posInPixel, customBar.textScale, textColor, IsString, customBar.textOptions)
+					TEN.Strings.ShowString(myText, 1/30)
+				end
+			end
+		end
+	end
+end
+
+TEN.Logic.AddCallback(TEN.Logic.CallbackPoint.PRELOOP, LevelFuncs.Engine.CustomBar.UpdateCustomBars)
+
+return CustomBar
diff --git a/Scripts/Engine/CustomDiary.lua b/Scripts/Engine/CustomDiary.lua
index 17ab7b27a..e62e2424d 100644
--- a/Scripts/Engine/CustomDiary.lua
+++ b/Scripts/Engine/CustomDiary.lua
@@ -1,6 +1,5 @@
 -----
---- Diaries:
--- The module provides functions to create and manage Diaries. It maintains diary definitions and entries through all levels and hubs.
+-- This module provides functions to create and manage diaries. It maintains diary definitions and entries through all levels and hubs.
 -- Each diary is accessed by the object that was used to create it. 
 --
 -- Example usage: