Triggering the screens

Triggering a Blood Screen from Your Scripts

Activating a blood screen effect from your own scripts is straightforward and highly modular. First, retrieve a reference to the BloodScreensPro_Manager component in your script:

public BloodScreensPro_Manager bloodScreenManager;

Once you have the reference, you can trigger the blood screen effect using the following method:

bloodScreenManager.ShowDamageEffect();

This allows you to integrate BloodScreens Pro seamlessly into your gameplay logic—whether you're responding to damage, environmental hazards, or any custom event.

Tip: Ensure that the BloodScreensPro_Manager is present in your scene before calling the method to avoid runtime errors.

Low Health System

BloodScreens Pro includes a built-in Low Health Indication System, allowing you to easily activate or deactivate a low health visual effect with just a single line of code:

bloodScreenManager.StartLowHealthIndication(); // Activates the low health effect
bloodScreenManager.StopLowHealthIndication();  // Deactivates the low health effect

This system is perfect for enhancing player feedback when health is critically low, adding a sense of urgency and immersion.

Example Usage

You can refer to the included BSP_ExampleDamageReceiver script to see how the system works in a practical context:

public class BSP_ExampleDamageReceiver : MonoBehaviour
{
    public BloodScreensPro_Manager bloodScreenManager = null;

    void Awake()
    {
        if (bloodScreenManager == null)
            Debug.LogWarning("BloodScreensPro Manager is missing from the scene.");
    }

    void Update()
    {
        if (bloodScreenManager == null) return;

        if (Input.GetKeyDown(KeyCode.X))
        {
            bloodScreenManager.ShowDamageEffect(); // Simulate taking damage
        }

        if (Input.GetKeyDown(KeyCode.I))
        {
            bloodScreenManager.StartLowHealthIndication(); // Start low health effect
        }

        if (Input.GetKeyDown(KeyCode.U))
        {
            bloodScreenManager.StopLowHealthIndication(); // Stop low health effect
        }
    }
}

💡 Tip: You can easily integrate this logic into your existing health or player controller scripts for full control over visual feedback based on gameplay events.