Add OnServerHibernationUpdate forward (closes #1483)

[ojlanders]

Adds the OnServerHibernationUpdate forward. OnServerHibernationUpdate_Post() isn't possible to implement because there would be no place for it to be called from after SV_Frame stops executing.
Link to Discord discussion:
https://discord.com/channels/335290997317697536/335290997317697536/1236880595448233995

[ojlanders]

Test script:

#include <sourcemod>

public void OnServerHibernationUpdate(bool state)
{
    PrintToServer("Server hibernation state changed to: %s", state ? "true" : "false");
}

here's the output:

sm_cvar sv_hibernate_when_empty 0
[SM] Changed cvar "sv_hibernate_when_empty" to "0".
L 05/05/2024 - 23:11:48: [basecommands.smx] "Console<0><Console><Console>" changed cvar (cvar "sv_hibernate_when_empty") (value "0")
Server waking up from hibernation
Server hibernation state changed to: false
sm_cvar sv_hibernate_when_empty 1
[SM] Changed cvar "sv_hibernate_when_empty" to "1".
L 05/05/2024 - 23:11:49: [basecommands.smx] "Console<0><Console><Console>" changed cvar (cvar "sv_hibernate_when_empty") (value "1")
Server is hibernating
Server hibernation state changed to: true

[Headline]

Thanks! - I just have some dev-user clarifications from me

[Headline]

new state? we should mention what true means here so it's clear we have begun hibernating, does false mean we have just awakened? Name it isHibernating

[ojlanders]

added a bit to explain this

[Headline]

OnHibernationChanged? Update implies to me we're getting this every frame, but this could just be me..

[ojlanders]

in general there's not a better way to do this: the function name "ServerHibernationUpdate" is well known, and the proper nomenclature used both in the engine and in everywhere i've seen it (like master server comms) is "hibernation state" unfortunately

[KaelaSavia]

Perhaps having two forwards instead could help

• OnServerEnterHibernation
• OnServerExitHibernation

Would make it more clear and be less confusing than bool

[ojlanders]

done

[psychonic]

Thanks