AlliedModders - Disconnect Reason

Disconnect Reason

.: v0.6

Description

This plugin notifies players via chat and console the reason that a player has disconnected (ie. Timed out, Client sent 'drop', Kicked). The standard console message notifying of a player disconnect will not be shown when the plugin is enabled. I've also eliminated the cvars found in the previous release that controlled notification types and notification methods; all types of disconnects are displayed in both chat and console. There is also a forward which allows you to utilize disconnect reasons in your own plugins 'client_disconnect_reason( id , drCode , szReason[] )', see below example. The forward remains active regardless of the dr_enabled cvar value which will only control chat\console message. Made by request.

CVars

dr_enabled <0/1> - Chat\console notification enabled\disabled status.
- Default: 1 (0=disabled, 1=enabled)

Forwards

client_disconnect_reason( id , drCode , const szReason[] ) - Forward for client_disconnect with reason.
- id - Player id
- drCode - Disconnect reason code
  - DR_TIMEDOUT
  - DR_DROPPED
  - DR_KICKED
  - DR_LEVELCHANGE
  - DR_OTHER
- szReason - Disconnect reason in text form: "Timed out", "Client sent 'drop'", "Kicked", "Dropping fakeclient on level change".

Disconnect Reason Codes

PHP Code:


		
			
enum ReasonCodes
{
    DR_TIMEDOUT,
    DR_DROPPED,
    DR_KICKED,
    DR_LEVELCHANGE,
    DR_OTHER
}

Modules

Orpheu

Installation

Place compiled (.amxx) file in plugins directory as with any other plugin.
Place the SV_DropClient file (found in signatures.zip) in amxmodx\configs\orpheu\functions.
For forward to work in your plugin(s), you must have this plugin running (do not #include it).

ScreenShots
http://img.photobucket.com/albums/v2...ona/t_chat.jpg

http://img.photobucket.com/albums/v2...na/ct_chat.jpg

http://img.photobucket.com/albums/v2...na/console.jpg

Example Plugin

PHP Code:


		
			
#include <amxmodx>

new const Version[] = "0.1";

enum ReasonCodes
{
    DR_TIMEDOUT,
    DR_DROPPED,
    DR_KICKED,
    DR_LEVELCHANGE,
    DR_OTHER
}

public plugin_init() 
{
    register_plugin( "Disconnect Reason Example" , Version , "bugsy" );
}

public client_disconnect_reason( id , ReasonCodes:drReason , const szReason[] )
{
    //Display info
    server_print( "id=%d ReasonCode=%d ReasonText=^"%s^"" , id , drReason , szReason );
    
    switch ( drReason )
    {
        case DR_TIMEDOUT: server_print( "Poor guy timed out" );
        case DR_DROPPED: server_print( "Ughh, another player left my server :(" );
        case DR_KICKED: server_print( "Player kicked, toodaloo!" );
        case DR_LEVELCHANGE: server_print( "Server changed map, he didnt leave" );
        case DR_OTHER: server_print( "hmm, why did he get disconnected?" );
    }
}

Changelog:

v0.6
- Added 'Dropping fakeclient on level change' disconnect reason.
v0.5
- Added client_disconnect_reason forward for hooking client_disconnect with reason.
v0.4
- Removed Sys_Printf hook since I'm pretty sure it is only used for printing to server console which nobody sees anyway so it's pointless to block. I initially assumed it printed to both server and client consoles.
- Added block for message #Game_disconnected to prevent players from seeing "Name has left the game" in console.
- Removed post hook for SV_DropClient since it was not needed.
  - v0.4a
    - Minor code cleanup
v0.3
- Improved signature used for SV_DropClient
- Removed cvars for controlling type and method, all disconnect types are notified in both chat and console.
- Added Sys_Printf hook to block the default disconnect message in console.
v0.2
- Added condition to check that a real player is disconnecting. xPaw reported that a notification appeared with the server name (id=0).
- Changed chat notification from messaging all players individually to a single message to all.
v0.1
- Initial release

3400 7/3/15