| EngineFunctionsHook (Hook) EngineFunctionsHook (Hook) |
Что это такое: What it is:
Функции описанные в HLSDK -> cdll_int.h -> структура cl_enginefuncs_s . The functions described in HLSDK -> cdll_int.h -> structure cl_enginefuncs_s. Структура иниализируется при передаче клиенту функции Initialize (client.dll export). Structure inializiruetsya transmission client function Initialize (client.dll export). - int (*Initialize)(cl_enginefunc_t *, int); - Int (* Initialize) (cl_enginefunc_t *, int);
Полная структура здесь (со всеми недокументированными функциями): Complete structure here (with all the undocumented features):
typedef struct cl_enginefuncs_s typedef struct cl_enginefuncs_s { { // sprite handlers // Sprite handlers HSPRITE ( *pfnSPR_Load ) ( const char *szPicName ); HSPRITE (* pfnSPR_Load) (const char * szPicName); int ( *pfnSPR_Frames ) ( HSPRITE hPic ); int (* pfnSPR_Frames) (HSPRITE hPic); int ( *pfnSPR_Height ) ( HSPRITE hPic, int frame ); int (* pfnSPR_Height) (HSPRITE hPic, int frame); int ( *pfnSPR_Width ) ( HSPRITE hPic, int frame ); int (* pfnSPR_Width) (HSPRITE hPic, int frame); void ( *pfnSPR_Set ) ( HSPRITE hPic, int r, int g, int b ); void (* pfnSPR_Set) (HSPRITE hPic, int r, int g, int b); void ( *pfnSPR_Draw ) ( int frame, int x, int y, const wrect_t *prc ); void (* pfnSPR_Draw) (int frame, int x, int y, const wrect_t * prc); void ( *pfnSPR_DrawHoles ) ( int frame, int x, int y, const wrect_t *prc ); void (* pfnSPR_DrawHoles) (int frame, int x, int y, const wrect_t * prc); void ( *pfnSPR_DrawAdditive ) ( int frame, int x, int y, const wrect_t *prc ); void (* pfnSPR_DrawAdditive) (int frame, int x, int y, const wrect_t * prc); void ( *pfnSPR_EnableScissor ) ( int x, int y, int width, int height ); void (* pfnSPR_EnableScissor) (int x, int y, int width, int height); void ( *pfnSPR_DisableScissor ) ( void ); void (* pfnSPR_DisableScissor) (void); client_sprite_t *( *pfnSPR_GetList ) ( char *psz, int *piCount ); client_sprite_t * (* pfnSPR_GetList) (char * psz, int * piCount); // screen handlers // Screen handlers void ( *pfnFillRGBA ) ( int x, int y, int width, int height, int r, int g, int b, int a ); void (* pfnFillRGBA) (int x, int y, int width, int height, int r, int g, int b, int a); int ( *pfnGetScreenInfo ) ( SCREENINFO *pscrinfo ); int (* pfnGetScreenInfo) (SCREENINFO * pscrinfo); void ( *pfnSetCrosshair ) ( HSPRITE hspr, wrect_t rc, int r, int g, int b ); void (* pfnSetCrosshair) (HSPRITE hspr, wrect_t rc, int r, int g, int b); // cvar handlers // Cvar handlers struct cvar_s *( *pfnRegisterVariable ) ( char *szName, char *szValue, int flags ); struct cvar_s * (* pfnRegisterVariable) (char * szName, char * szValue, int flags); float ( *pfnGetCvarFloat ) ( char *szName ); float (* pfnGetCvarFloat) (char * szName); char* ( *pfnGetCvarString ) ( char *szName ); char * (* pfnGetCvarString) (char * szName); // command handlers // Command handlers int ( *pfnAddCommand ) ( char *cmd_name, void (*function)(void) ); int (* pfnAddCommand) (char * cmd_name, void (* function) (void)); int ( *pfnHookUserMsg ) ( char *szMsgName, pfnUserMsgHook pfn ); int (* pfnHookUserMsg) (char * szMsgName, pfnUserMsgHook pfn); int ( *pfnServerCmd ) ( char *szCmdString ); int (* pfnServerCmd) (char * szCmdString); int ( *pfnClientCmd ) ( char *szCmdString ); int (* pfnClientCmd) (char * szCmdString); void ( *pfnGetPlayerInfo ) ( int ent_num, hud_player_info_t *pinfo ); void (* pfnGetPlayerInfo) (int ent_num, hud_player_info_t * pinfo); // sound handlers // Sound handlers void ( *pfnPlaySoundByName ) ( char *szSound, float volume ); void (* pfnPlaySoundByName) (char * szSound, float volume); void ( *pfnPlaySoundByIndex ) ( int iSound, float volume ); void (* pfnPlaySoundByIndex) (int iSound, float volume); // vector helpers // Vector helpers void ( *pfnAngleVectors ) ( const float * vecAngles, float * forward, float * right, float * up ); void (* pfnAngleVectors) (const float * vecAngles, float * forward, float * right, float * up); // text message system // Text message system client_textmessage_t *( *pfnTextMessageGet ) ( const char *pName ); client_textmessage_t * (* pfnTextMessageGet) (const char * pName); int ( *pfnDrawCharacter ) ( int x, int y, int number, int r, int g, int b ); int (* pfnDrawCharacter) (int x, int y, int number, int r, int g, int b); int ( *pfnDrawConsoleString ) ( int x, int y, char *string ); int (* pfnDrawConsoleString) (int x, int y, char * string); void ( *pfnDrawSetTextColor ) ( float r, float g, float b ); void (* pfnDrawSetTextColor) (float r, float g, float b); void ( *pfnDrawConsoleStringLen )( const char *string, int *length, int *height ); void (* pfnDrawConsoleStringLen) (const char * string, int * length, int * height); void ( *pfnConsolePrint ) ( const char *string ); void (* pfnConsolePrint) (const char * string); void ( *pfnCenterPrint ) ( const char *string ); void (* pfnCenterPrint) (const char * string); // Added for user input processing // Added for user input processing int ( *GetWindowCenterX ) ( void ); int (* GetWindowCenterX) (void); int ( *GetWindowCenterY ) ( void ); int (* GetWindowCenterY) (void); void ( *GetViewAngles ) ( float * ); void (* GetViewAngles) (float *); void ( *SetViewAngles ) ( float * ); void (* SetViewAngles) (float *); int ( *GetMaxClients ) ( void ); int (* GetMaxClients) (void); void ( *Cvar_SetValue ) ( char *cvar, float value ); void (* Cvar_SetValue) (char * cvar, float value); int (*Cmd_Argc) (void); int (* Cmd_Argc) (void); char *( *Cmd_Argv ) ( int arg ); char * (* Cmd_Argv) (int arg); void ( *Con_Printf ) ( char *fmt, ... ); void (* Con_Printf) (char * fmt, ...); void ( *Con_DPrintf ) ( char *fmt, ... ); void (* Con_DPrintf) (char * fmt, ...); void ( *Con_NPrintf ) ( int pos, char *fmt, ... ); void (* Con_NPrintf) (int pos, char * fmt, ...); void ( *Con_NXPrintf ) ( struct con_nprint_s *info, char *fmt, ... ); void (* Con_NXPrintf) (struct con_nprint_s * info, char * fmt, ...); const char *( *PhysInfo_ValueForKey ) ( const char *key ); const char * (* PhysInfo_ValueForKey) (const char * key); const char *( *ServerInfo_ValueForKey )( const char *key ); const char * (* ServerInfo_ValueForKey) (const char * key); float ( *GetClientMaxspeed ) ( void ); float (* GetClientMaxspeed) (void); int ( *CheckParm ) ( char *parm, char **ppnext ); int (* CheckParm) (char * parm, char ** ppnext); void ( *Key_Event ) ( int key, int down ); void (* Key_Event) (int key, int down); void ( *GetMousePosition ) ( int *mx, int *my ); void (* GetMousePosition) (int * mx, int * my); int ( *IsNoClipping ) ( void ); int (* IsNoClipping) (void); struct cl_entity_s *( *GetLocalPlayer ) ( void ); struct cl_entity_s * (* GetLocalPlayer) (void); struct cl_entity_s *( *GetViewModel ) ( void ); struct cl_entity_s * (* GetViewModel) (void); struct cl_entity_s *( *GetEntityByIndex ) ( int idx ); struct cl_entity_s * (* GetEntityByIndex) (int idx); float ( *GetClientTime ) ( void ); float (* GetClientTime) (void); void ( *V_CalcShake ) ( void ); void (* V_CalcShake) (void); void ( *V_ApplyShake ) ( float *origin, float *angles, float factor ); void (* V_ApplyShake) (float * origin, float * angles, float factor); int ( *PM_PointContents ) ( float *point, int *truecontents ); int (* PM_PointContents) (float * point, int * truecontents); int ( *PM_WaterEntity ) ( float *p ); int (* PM_WaterEntity) (float * p); struct pmtrace_s *( *PM_TraceLine ) ( float *start, float *end, int flags, int usehull, int ignore_pe ); struct pmtrace_s * (* PM_TraceLine) (float * start, float * end, int flags, int usehull, int ignore_pe); struct model_s *( *CL_LoadModel ) ( const char *modelname, int *index ); struct model_s * (* CL_LoadModel) (const char * modelname, int * index); int ( *CL_CreateVisibleEntity ) ( int type, struct cl_entity_s *ent ); int (* CL_CreateVisibleEntity) (int type, struct cl_entity_s * ent); const struct model_s * ( *GetSpritePointer ) ( HSPRITE hSprite ); const struct model_s * (* GetSpritePointer) (HSPRITE hSprite); void ( *pfnPlaySoundByNameAtLocation ) ( char *szSound, float volume, float *origin ); void (* pfnPlaySoundByNameAtLocation) (char * szSound, float volume, float * origin); unsigned short ( *pfnPrecacheEvent ) ( int type, const char* psz ); unsigned short (* pfnPrecacheEvent) (int type, const char * psz); void ( *pfnPlaybackEvent ) ( int flags, const struct edict_s *pInvoker, unsigned short eventindex, float delay, float *origin, float *angles, float fparam1, float fparam2, int iparam1, int iparam2, int bparam1, int bparam2 ); void (* pfnPlaybackEvent) (int flags, const struct edict_s * pInvoker, unsigned short eventindex, float delay, float * origin, float * angles, float fparam1, float fparam2, int iparam1, int iparam2, int bparam1, int bparam2); void ( *pfnWeaponAnim ) ( int iAnim, int body ); void (* pfnWeaponAnim) (int iAnim, int body); float ( *pfnRandomFloat ) ( float flLow, float flHigh ); float (* pfnRandomFloat) (float flLow, float flHigh); long ( *pfnRandomLong ) ( long lLow, long lHigh ); long (* pfnRandomLong) (long lLow, long lHigh); void ( *pfnHookEvent ) ( char *name, void ( *pfnEvent )( struct event_args_s *args ) ); void (* pfnHookEvent) (char * name, void (* pfnEvent) (struct event_args_s * args)); int (*Con_IsVisible) (); int (* Con_IsVisible) (); const char *( *pfnGetGameDirectory ) ( void ); const char * (* pfnGetGameDirectory) (void); struct cvar_s *( *pfnGetCvarPointer ) ( const char *szName ); struct cvar_s * (* pfnGetCvarPointer) (const char * szName); const char *( *Key_LookupBinding ) ( const char *pBinding ); const char * (* Key_LookupBinding) (const char * pBinding); const char *( *pfnGetLevelName ) ( void ); const char * (* pfnGetLevelName) (void); void ( *pfnGetScreenFade ) ( struct screenfade_s *fade ); void (* pfnGetScreenFade) (struct screenfade_s * fade); void ( *pfnSetScreenFade ) ( struct screenfade_s *fade ); void (* pfnSetScreenFade) (struct screenfade_s * fade); void *( *VGui_GetPanel ) ( ); void * (* VGui_GetPanel) (); void ( *VGui_ViewportPaintBackground ) (int extents[4]); void (* VGui_ViewportPaintBackground) (int extents [4]); byte* (*COM_LoadFile) ( char *path, int usehunk, int *pLength ); byte * (* COM_LoadFile) (char * path, int usehunk, int * pLength); char* (*COM_ParseFile) ( char *data, char *token ); char * (* COM_ParseFile) (char * data, char * token); void (*COM_FreeFile) ( void *buffer ); void (* COM_FreeFile) (void * buffer); struct triangleapi_s *pTriAPI; struct triangleapi_s * pTriAPI; struct efx_api_s *pEfxAPI; struct efx_api_s * pEfxAPI; struct event_api_s *pEventAPI; struct event_api_s * pEventAPI; struct demo_api_s *pDemoAPI; struct demo_api_s * pDemoAPI; struct net_api_s *pNetAPI; struct net_api_s * pNetAPI; struct IVoiceTweak_s *pVoiceTweak; struct IVoiceTweak_s * pVoiceTweak; // returns 1 if the client is a spectator only (connected to a proxy), 0 otherwise or 2 if in dev_overview mode // Returns 1 if the client is a spectator only (connected to a proxy), 0 otherwise or 2 if in dev_overview mode int ( *IsSpectateOnly ) ( void ); int (* IsSpectateOnly) (void); struct model_s *( *LoadMapSprite ) ( const char *filename ); struct model_s * (* LoadMapSprite) (const char * filename); // file search functions // File search functions void ( *COM_AddAppDirectoryToSearchPath ) ( const char *pszBaseDir, const char *appName ); void (* COM_AddAppDirectoryToSearchPath) (const char * pszBaseDir, const char * appName); int ( *COM_ExpandFilename) ( const char *fileName, char *nameOutBuffer, int nameOutBufferSize ); int (* COM_ExpandFilename) (const char * fileName, char * nameOutBuffer, int nameOutBufferSize); // User info // User info // playerNum is in the range (1, MaxClients) // PlayerNum is in the range (1, MaxClients) // returns NULL if player doesn't exit // Returns NULL if player does not exit // returns "" if no value is set // Returns "" if no value is set const char *( *PlayerInfo_ValueForKey )( int playerNum, const char *key ); const char * (* PlayerInfo_ValueForKey) (int playerNum, const char * key); void ( *PlayerInfo_SetValueForKey )( const char *key, const char *value ); void (* PlayerInfo_SetValueForKey) (const char * key, const char * value); // Gets a unique ID for the specified player. // Gets a unique ID for the specified player. This is the same even if you see the player on a different server. This is the same even if you see the player on a different server. // iPlayer is an entity index, so client 0 would use iPlayer=1. // IPlayer is an entity index, so client 0 would use iPlayer = 1. // Returns false if there is no player on the server in the specified slot. // Returns false if there is no player on the server in the specified slot. qboolean (*GetPlayerUniqueID)(int iPlayer, char playerID[16]); qboolean (* GetPlayerUniqueID) (int iPlayer, char playerID [16]); // TrackerID access // TrackerID access int (*GetTrackerIDForPlayer)(int playerSlot); int (* GetTrackerIDForPlayer) (int playerSlot); int (*GetPlayerForTrackerID)(int trackerID); int (* GetPlayerForTrackerID) (int trackerID); // Same as pfnServerCmd, but the message goes in the unreliable stream so it can't clog the net stream // Same as pfnServerCmd, but the message goes in the unreliable stream so it can not clog the net stream // (but it might not get there). // (But it might not get there). int ( *pfnServerCmdUnreliable )( char *szCmdString ); int (* pfnServerCmdUnreliable) (char * szCmdString); void ( *pfnGetMousePos )( struct tagPOINT *ppt ); void (* pfnGetMousePos) (struct tagPOINT * ppt); void ( *pfnSetMousePos )( int x, int y ); void (* pfnSetMousePos) (int x, int y); void ( *pfnSetMouseEnable )( qboolean fEnable ); void (* pfnSetMouseEnable) (qboolean fEnable); struct cvar_s* ( *pfnGetCvarList )( void ); struct cvar_s * (* pfnGetCvarList) (void); struct cmd_s* ( *pfnGetCmdList )( void ); struct cmd_s * (* pfnGetCmdList) (void); char* ( *pfnGetCvarName )( struct cvar_s* cvar ); char * (* pfnGetCvarName) (struct cvar_s * cvar); char* ( *pfnGetCmdName )( struct cmd_s* cmd ); char * (* pfnGetCmdName) (struct cmd_s * cmd); float ( *pfnGetServerTime )( void ); float (* pfnGetServerTime) (void); float ( *pfnGetGravity )( void ); float (* pfnGetGravity) (void); const struct model_s* ( *pfnPrecacheSprite )( HSPRITE spr ); const struct model_s * (* pfnPrecacheSprite) (HSPRITE spr); void ( *OverrideLightmap )( int override ); void (* OverrideLightmap) (int override); void ( *SetLightmapColor )( float r, float g, float b ); void (* SetLightmapColor) (float r, float g, float b); void ( *SetLightmapDarkness )( float dark ); void (* SetLightmapDarkness) (float dark); //this will always fail with the current engine // This will always fail with the current engine int ( *pfnGetSequenceByName )( int flags, const char* seq ); int (* pfnGetSequenceByName) (int flags, const char * seq); void ( *pfnSPR_DrawGeneric )( int frame, int x, int y, const wrect_t *prc, int blendsrc, int blenddst, int unknown1, int unknown2 ); void (* pfnSPR_DrawGeneric) (int frame, int x, int y, const wrect_t * prc, int blendsrc, int blenddst, int unknown1, int unknown2); //this will always fail with engine, don't call // This will always fail with engine, do not call //it actually has paramenters but i dunno what they do // It actually has paramenters but i dunno what they do void ( *pfnLoadSentence )( void ); void (* pfnLoadSentence) (void); //localizes hud string, uses Legacy font from skin def // Localizes hud string, uses Legacy font from skin def // also supports unicode strings // Also supports unicode strings int ( *pfnDrawLocalizedHudString )( int x, int y, const char* str, int r, int g, int b ); int (* pfnDrawLocalizedHudString) (int x, int y, const char * str, int r, int g, int b); //i can't get this to work for some reason, don't use this // I can not get this to work for some reason, do not use this int ( *pfnDrawLocalizedConsoleString )( int x, int y, const char* str ); int (* pfnDrawLocalizedConsoleString) (int x, int y, const char * str); //gets keyvalue for local player, useful for querying vgui menus or autohelp // Gets keyvalue for local player, useful for querying vgui menus or autohelp const char *(*LocalPlayerInfo_ValueForKey)( const char* key ); const char * (* LocalPlayerInfo_ValueForKey) (const char * key); //another vgui2 text drawing function, i dunno how it works // Another vgui2 text drawing function, i dunno how it works //it doesn't localize though // It does not localize though void ( *pfnDrawText_0 )( int x, int y, const char* text, unsigned long font ); void (* pfnDrawText_0) (int x, int y, const char * text, unsigned long font); int ( *pfnDrawUnicodeCharacter )( int x, int y, short number, int r, int g, int b, unsigned long hfont ); int (* pfnDrawUnicodeCharacter) (int x, int y, short number, int r, int g, int b, unsigned long hfont); //checks sound header of a sound file, determines if its a supported type // Checks sound header of a sound file, determines if its a supported type int ( *pfnCheckSoundFile )( const char* path ); int (* pfnCheckSoundFile) (const char * path); //for condition zero, returns interface from GameUI // For condition zero, returns interface from GameUI void* ( *GetCareerGameInterface )( void ); void * (* GetCareerGameInterface) (void); void ( *pfnCvar_Set )( const char* cvar, const char* value ); void (* pfnCvar_Set) (const char * cvar, const char * value); //this actually checks for if the CareerGameInterface is found // This actually checks for if the CareerGameInterface is found //and if a server is being run // And if a server is being run int ( *IsSinglePlayer )( void ); int (* IsSinglePlayer) (void); void ( *pfnPlaySound )( const char* sound, float vol, float pitch ); void (* pfnPlaySound) (const char * sound, float vol, float pitch); void ( *pfnPlayMp3 )( const char* mp3, int flags ); void (* pfnPlayMp3) (const char * mp3, int flags); //get the systems current time as a float // Get the systems current time as a float float ( *Sys_FloatTime )( void ); float (* Sys_FloatTime) (void); void ( *pfnSetArray )( int* array, int size ); void (* pfnSetArray) (int * array, int size); void ( *pfnSetClearArray )( int* array, int size ); void (* pfnSetClearArray) (int * array, int size); void ( *pfnClearArray )( void ); void (* pfnClearArray) (void); void ( *pfnPlaySound2 )( const char* sound, float vol, float pitch ); void (* pfnPlaySound2) (const char * sound, float vol, float pitch); // Same like pfnFillRGBA - with other mode (substractive) // Same like pfnFillRGBA - with other mode (substractive) int ( *pfnFillRGBA2) ( int x, int y, int w, int h, int r, int g, int b, int a ); int (* pfnFillRGBA2) (int x, int y, int w, int h, int r, int g, int b, int a); } cl_enginefunc_t; } Cl_enginefunc_t;
Получение: Preparation:
Самое корректное - получать структуру через Initialize. The most correct - to get through the structure Initialize. Но если вы не хукаете функции клиента, либо применяете свои хуки после инициализации этой функции, придётся использовать автоматический поиск указателя или статичный оффсет (если используете вполне конкретный патч - в интернете есть куча архивов оффсетов под каждый патч). But if you do not hook the function of the client, or to apply their hooks after initialization of this function, it is necessary to use an automatic search index or a static offset (if you use very specific patch - there are plenty of online archives offsets for each patch).
Код автоматического поиска указателя (точно не скажу до какого патча работает - возможно надо расширить диапазон поиска): The automatic search indicator (do not tell to what the patch works - possible need to extend the search range):
net_api_s *pNetAPI; net_api_s * pNetAPI;
demo_api_s *pDemoAPI; demo_api_s * pDemoAPI;
efx_api_s *pEfxAPI; efx_api_s * pEfxAPI;
triangleapi_s *pTriAPI; triangleapi_s * pTriAPI;
event_api_s *pEventAPI; event_api_s * pEventAPI;
IVoiceTweak_s *pVoiceTweak; IVoiceTweak_s * pVoiceTweak;
cl_enginefuncs_s *pEngfuncs; cl_enginefuncs_s * pEngfuncs; int a; int a;
for(a=0x01D00000;a<0x01D1FFFF;a++) for (a = 0x01D00000; a <0x01D1FFFF; a ++)
{ {
if(*(PBYTE)(a) == 0x68 && *(PBYTE)(a + 0x05) == 0xE8 && if (* (PBYTE) (a) == 0x68 && * (PBYTE) (a + 0x05) == 0xE8 &&
*(PBYTE)(a + 0x0A) == 0x6A && *(PBYTE)(a + 0x0B) == 0x07 && * (PBYTE) (a + 0x0A) == 0x6A && * (PBYTE) (a + 0x0B) == 0x07 &&
*(PBYTE)(a + 0x0C) == 0x68 && *(PBYTE)(a + 0x11) == 0xFF && * (PBYTE) (a + 0x0C) == 0x68 && * (PBYTE) (a + 0x11) == 0xFF &&
*(PBYTE)(a + 0x12) == 0x15 && *(PBYTE)(a + 0x17) == 0x68) * (PBYTE) (a + 0x12) == 0x15 && * (PBYTE) (a + 0x17) == 0x68)
{ {
pEngfuncs = (cl_enginefunc_t*)*(DWORD*)(a+0x0D); pEngfuncs = (cl_enginefunc_t *) * (DWORD *) (a + 0x0D);
pNetAPI = pEngfuncs->pNetAPI; pNetAPI = pEngfuncs-> pNetAPI;
pEfxAPI = pEngfuncs->pEfxAPI; pEfxAPI = pEngfuncs-> pEfxAPI;
pTriAPI = pEngfuncs->pTriAPI; pTriAPI = pEngfuncs-> pTriAPI;
pDemoAPI = pEngfuncs->pDemoAPI; pDemoAPI = pEngfuncs-> pDemoAPI;
pEventAPI = pEngfuncs->pEventAPI; pEventAPI = pEngfuncs-> pEventAPI;
pVoiceTweak = pEngfuncs->pVoiceTweak; pVoiceTweak = pEngfuncs-> pVoiceTweak; } } } }
; ;
Copyright (c) Troll Copyright (c) Troll