Blood Trail

EntityBleedingBehavior Events:
- OnStartBleeding -> BleedingEventArgs
- OnStopBleeding -> BleedingEventArgs

BleedingEventArgs
(Entity Entity, long StartTime, long? StopTime)

--------------------------------------------------------------------------------
// Inside YourMod.csproj
<Reference Include="BloodTrail">
    <HintPath>../BloodTrail.dll</HintPath>
</Reference>

--------------------------------------------------------------------------------
// Inside YourMod : ModSystem
public override void StartServerSide(ICoreServerAPI sapi)
{
    if (api.ModLoader.IsModEnabled("bloodtrail"))
    {
        sapi.Event.OnEntitySpawn += OnEntitySpawnOrLoad;
        sapi.Event.OnEntityLoaded += OnEntitySpawnOrLoad;
    }
}

private void OnEntitySpawnOrLoad(Entity entity)
{
    var behavior = entity.GetBehavior<EntityBleedingBehavior>();
    if (behavior != null)
    {
        behavior.OnStartBleeding += HandleStartBleeding;
        behavior.OnStopBleeding += HandleStopBleeding; // Visual bleeding may stop before if the entity is death.
    }
}

private void HandleStartBleeding(object? sender, BleedingEventArgs e)
{
    e.Entity.Api.World.Logger.Event($"Entity #{e.Entity.EntityId} started bleeding at {e.StartTime}");
}

private void HandleStopBleeding(object? sender, BleedingEventArgs e)
{
    e.Entity.Api.World.Logger.Event($"Entity #{e.Entity.EntityId} stoped bleeding at {e.StopTime}");
}

public override void Dispose()
{
    sapi.Event.OnEntitySpawn -= OnEntitySpawnOrLoad;
    sapi.Event.OnEntityLoaded -= OnEntitySpawnOrLoad;
}

-------

Where to edit the configs: You can adjust settings via the in-game menu (requires ConfigLib & ImGUI; a new button appears in the Escape Menu) OR manually edit the JSON file: VintageStoryData/ModConfig/BloodTrail-....json

• BloodTrail-Client: Only affects your local game.

• BloodTrail-Server: Affects all players in multiplayer (and acts as Client for you in singleplayer).

-------

No bleeding:

For the bleeding to start, the player must attack with a damage value greater than 1 (attacking with bare hands won't work).

Check your configs to make sure the "Bleeding effect" is enabled. If the issue persists keep reading "Missing particles" below.

-------

Missing particles:

• Make sure the animal is either vanilla or explicitly supported in the list of mods found in the mod description.

• "Particles" (inside the in-game graphics setitngs tab) must be set above ~30%.

• The particle effect requires the in-game clock to be running. If you stop the time, the effect will not work.

• Make sure the version of the mod you are using is compatible with your current game version.

• If you've edited your configs, try resetting them to their default values.

• If the issue persists, please share your modlist and logs in the comments below or reach out directly via Discord.