This plug-in provides you with a simple but powerful function - catch signals on Windows and Linux.
With this plug-in you're able to catch user signals sent to the process and interrupt on f.e. CTRL+C shutdowns allowing you to save your player data / server data before server shutdown and avoid mistakes.
This plug-in also optimally pleases automation script developers you're able to properly send commands to the server almost immediately on the system locally; means; You can save all your data before shutting down the server or announce messages on linux using UserSignal1 or 2.
Keep in mind that this plug-in can't catch every process shutdown as systems force the shutdown of a system in one or another way.
On Windows you're able to catch controlled signals (closing the window, pressing ctrl+c) but keep in mind that we're only able to interupt the termination of the process for 10 seconds.
On Linux you're also able to catch controlled signals (closing the terminal, interrupts, termination requests) with one difference once a SIGKILL signal get's sent the process immediately exits.
The installation is simple, just download the latest version from the GitHub Releases Page and install it like every other plug-in.
The plug-in just provides 1 callback and 2 functions there's not much to tell about them other then one example:
public OnGameModeInit()
{
SetCatchExit(true); // not setting this will make the plug-in effectively useless.
return 1;
}
new bool:stuff_saved;
forward SaveUserData();
public SaveUserData()
{
stuff_saved = true;
SetCatchExit(false); // allow the program to exit safely now!
//ExitProcess(); // or exit manually!
printf("Saved user data!");
}
public OnUngracefulExit(ExitFlags:reason)
{
if(reason & EXIT_USER)
{
if(reason & EXIT_CTRLC)
printf("Press CTRL-C again if user data has been saved.");
else
printf("Wait for user data to be saved till exit.");
if(!stuff_saved) SetTimer("SaveUserData", 2500, 0); // simulate delay
}
return true;
}Southclaws - For the boilerplate, cbf setting up this shit <3