mirror of
https://github.com/rehlds/rechecker.git
synced 2024-12-26 20:35:28 +03:00
233 lines
10 KiB
C
233 lines
10 KiB
C
// meta_api.h - description of metamod's DLL interface
|
|
|
|
/*
|
|
* Copyright (c) 2001-2003 Will Day <willday@hpgx.net>
|
|
*
|
|
* This file is part of Metamod.
|
|
*
|
|
* Metamod is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the
|
|
* Free Software Foundation; either version 2 of the License, or (at
|
|
* your option) any later version.
|
|
*
|
|
* Metamod is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with Metamod; if not, write to the Free Software Foundation,
|
|
* Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*
|
|
* In addition, as a special exception, the author gives permission to
|
|
* link the code of this program with the Half-Life Game Engine ("HL
|
|
* Engine") and Modified Game Libraries ("MODs") developed by Valve,
|
|
* L.L.C ("Valve"). You must obey the GNU General Public License in all
|
|
* respects for all of the code used other than the HL Engine and MODs
|
|
* from Valve. If you modify this file, you may extend this exception
|
|
* to your version of the file, but you are not obligated to do so. If
|
|
* you do not wish to do so, delete this exception statement from your
|
|
* version.
|
|
*
|
|
*/
|
|
|
|
#ifndef META_API_H
|
|
#define META_API_H
|
|
|
|
#include "dllapi.h" // GETENTITYAPI_FN, etc
|
|
#include "engine_api.h" // GET_ENGINE_FUNCTIONS_FN, etc
|
|
#include "plinfo.h" // plugin_info_t, etc
|
|
#include "mutil.h" // mutil_funcs_t, etc
|
|
#include "osdep.h" // DLLEXPORT, etc
|
|
|
|
// Version consists of "major:minor", two separate integer numbers.
|
|
// Version 1 original
|
|
// Version 2 added plugin_info_t **pinfo
|
|
// Version 3 init split into query and attach, added detach
|
|
// Version 4 added (PLUG_LOADTIME now) to attach
|
|
// Version 5 changed mm ifvers int* to string, moved pl ifvers to info
|
|
// Version 5:1 added link support for entity "adminmod_timer" (adminmod)
|
|
// Version 5:2 added gamedll_funcs to meta_attach() [v1.0-rc2]
|
|
// Version 5:3 added mutil_funcs to meta_query() [v1.05]
|
|
// Version 5:4 added centersay utility functions [v1.06]
|
|
// Version 5:5 added Meta_Init to plugin API [v1.08]
|
|
// Version 5:6 added CallGameEntity utility function [v1.09]
|
|
// Version 5:7 added GetUserMsgID, GetUserMsgName util funcs [v1.11]
|
|
// Version 5:8 added GetPluginPath [v1.11]
|
|
// Version 5:9 added GetGameInfo [v1.14]
|
|
// Version 5:10 added GINFO_REALDLL_FULLPATH for GetGameInfo [v1.17]
|
|
// Version 5:11 added plugin loading and unloading API [v1.18]
|
|
// Version 5:12 added util code for checking player query status [v1.18]
|
|
// Version 5:13 added cvarquery2 support and api for calling hook tables [v1.19]
|
|
#define META_INTERFACE_VERSION "5:13"
|
|
|
|
#ifdef UNFINISHED
|
|
// Version 5:99 added event hook utility functions [v.???]
|
|
#define META_INTERFACE_VERSION "5:99"
|
|
#endif /* UNFINISHED */
|
|
|
|
// Flags returned by a plugin's api function.
|
|
// NOTE: order is crucial, as greater/less comparisons are made.
|
|
typedef enum {
|
|
MRES_UNSET = 0,
|
|
MRES_IGNORED, // plugin didn't take any action
|
|
MRES_HANDLED, // plugin did something, but real function should still be called
|
|
MRES_OVERRIDE, // call real function, but use my return value
|
|
MRES_SUPERCEDE, // skip real function; use my return value
|
|
} META_RES;
|
|
|
|
// Variables provided to plugins.
|
|
typedef struct meta_globals_s {
|
|
META_RES mres; // writable; plugin's return flag
|
|
META_RES prev_mres; // readable; return flag of the previous plugin called
|
|
META_RES status; // readable; "highest" return flag so far
|
|
void *orig_ret; // readable; return value from "real" function
|
|
void *override_ret; // readable; return value from overriding/superceding plugin
|
|
} meta_globals_t;
|
|
|
|
extern meta_globals_t *gpMetaGlobals;
|
|
#define SET_META_RESULT(result) gpMetaGlobals->mres=result
|
|
#define RETURN_META(result) \
|
|
do { gpMetaGlobals->mres=result; return; } while(0)
|
|
|
|
#define RETURN_META_VALUE(result, value) \
|
|
do { gpMetaGlobals->mres=result; return(value); } while(0)
|
|
|
|
#define META_RESULT_STATUS gpMetaGlobals->status
|
|
#define META_RESULT_PREVIOUS gpMetaGlobals->prev_mres
|
|
#define META_RESULT_ORIG_RET(type) *(type *)gpMetaGlobals->orig_ret
|
|
#define META_RESULT_OVERRIDE_RET(type) *(type *)gpMetaGlobals->override_ret
|
|
|
|
// Table of getapi functions, retrieved from each plugin.
|
|
typedef struct {
|
|
GETENTITYAPI_FN pfnGetEntityAPI;
|
|
GETENTITYAPI_FN pfnGetEntityAPI_Post;
|
|
GETENTITYAPI2_FN pfnGetEntityAPI2;
|
|
GETENTITYAPI2_FN pfnGetEntityAPI2_Post;
|
|
GETNEWDLLFUNCTIONS_FN pfnGetNewDLLFunctions;
|
|
GETNEWDLLFUNCTIONS_FN pfnGetNewDLLFunctions_Post;
|
|
GET_ENGINE_FUNCTIONS_FN pfnGetEngineFunctions;
|
|
GET_ENGINE_FUNCTIONS_FN pfnGetEngineFunctions_Post;
|
|
} META_FUNCTIONS;
|
|
|
|
// Pair of function tables provided by game DLL.
|
|
typedef struct {
|
|
DLL_FUNCTIONS *dllapi_table;
|
|
NEW_DLL_FUNCTIONS *newapi_table;
|
|
} gamedll_funcs_t;
|
|
|
|
// Declared in plugin; referenced in macros.
|
|
extern gamedll_funcs_t *gpGamedllFuncs;
|
|
extern mutil_funcs_t *gpMetaUtilFuncs;
|
|
|
|
// Tell the dll that we'll be loading it as a metamod plugin, in case it
|
|
// needs to do something special prior to the standard query/attach
|
|
// procedure. In particular, this will allow for DLL's that can be used as
|
|
// both standalone DLL's and metamod plugins. (optional; not required in
|
|
// plugin)
|
|
C_DLLEXPORT void Meta_Init(void);
|
|
typedef void (*META_INIT_FN) (void);
|
|
|
|
// Get info about plugin, compare meta_interface versions, provide meta
|
|
// utility callback functions.
|
|
C_DLLEXPORT int Meta_Query(char *interfaceVersion,
|
|
plugin_info_t **plinfo,
|
|
mutil_funcs_t *pMetaUtilFuncs);
|
|
typedef int (*META_QUERY_FN) (char *interfaceVersion,
|
|
plugin_info_t **plinfo,
|
|
mutil_funcs_t *pMetaUtilFuncs);
|
|
|
|
// Attach the plugin to the API; get the table of getapi functions; give
|
|
// meta_globals and gamedll_funcs.
|
|
C_DLLEXPORT int Meta_Attach(PLUG_LOADTIME now,
|
|
META_FUNCTIONS *pFunctionTable,
|
|
meta_globals_t *pMGlobals,
|
|
gamedll_funcs_t *pGamedllFuncs);
|
|
typedef int (*META_ATTACH_FN) (PLUG_LOADTIME now,
|
|
META_FUNCTIONS *pFunctionTable,
|
|
meta_globals_t *pMGlobals,
|
|
gamedll_funcs_t *pGamedllFuncs);
|
|
|
|
// Detach the plugin; tell why and when.
|
|
C_DLLEXPORT int Meta_Detach(PLUG_LOADTIME now, PL_UNLOAD_REASON reason);
|
|
typedef int (*META_DETACH_FN) (PLUG_LOADTIME now, PL_UNLOAD_REASON reason);
|
|
|
|
// Standard HL SDK interface function prototypes.
|
|
C_DLLEXPORT int GetEntityAPI_Post(DLL_FUNCTIONS *pFunctionTable,
|
|
int interfaceVersion );
|
|
C_DLLEXPORT int GetEntityAPI2_Post(DLL_FUNCTIONS *pFunctionTable,
|
|
int *interfaceVersion );
|
|
|
|
// Additional SDK-like interface function prototypes.
|
|
C_DLLEXPORT int GetNewDLLFunctions_Post(NEW_DLL_FUNCTIONS *pNewFunctionTable, int *interfaceVersion );
|
|
C_DLLEXPORT int GetEngineFunctions(enginefuncs_t *pengfuncsFromEngine, int *interfaceVersion);
|
|
C_DLLEXPORT int GetEngineFunctions_Post(enginefuncs_t *pengfuncsFromEngine, int *interfaceVersion);
|
|
|
|
// Convenience macros for accessing GameDLL functions. Note: these talk
|
|
// _directly_ to the gamedll, and are not multiplexed through Metamod to
|
|
// the other plugins.
|
|
// DLL API functions:
|
|
#define MDLL_FUNC gpGamedllFuncs->dllapi_table
|
|
|
|
#define MDLL_GameDLLInit MDLL_FUNC->pfnGameInit
|
|
#define MDLL_Spawn MDLL_FUNC->pfnSpawn
|
|
#define MDLL_Think MDLL_FUNC->pfnThink
|
|
#define MDLL_Use MDLL_FUNC->pfnUse
|
|
#define MDLL_Touch MDLL_FUNC->pfnTouch
|
|
#define MDLL_Blocked MDLL_FUNC->pfnBlocked
|
|
#define MDLL_KeyValue MDLL_FUNC->pfnKeyValue
|
|
#define MDLL_Save MDLL_FUNC->pfnSave
|
|
#define MDLL_Restore MDLL_FUNC->pfnRestore
|
|
#define MDLL_ObjectCollsionBox MDLL_FUNC->pfnAbsBox
|
|
#define MDLL_SaveWriteFields MDLL_FUNC->pfnSaveWriteFields
|
|
#define MDLL_SaveReadFields MDLL_FUNC->pfnSaveReadFields
|
|
#define MDLL_SaveGlobalState MDLL_FUNC->pfnSaveGlobalState
|
|
#define MDLL_RestoreGlobalState MDLL_FUNC->pfnRestoreGlobalState
|
|
#define MDLL_ResetGlobalState MDLL_FUNC->pfnResetGlobalState
|
|
#define MDLL_ClientConnect MDLL_FUNC->pfnClientConnect
|
|
#define MDLL_ClientDisconnect MDLL_FUNC->pfnClientDisconnect
|
|
#define MDLL_ClientKill MDLL_FUNC->pfnClientKill
|
|
#define MDLL_ClientPutInServer MDLL_FUNC->pfnClientPutInServer
|
|
#define MDLL_ClientCommand MDLL_FUNC->pfnClientCommand
|
|
#define MDLL_ClientUserInfoChanged MDLL_FUNC->pfnClientUserInfoChanged
|
|
#define MDLL_ServerActivate MDLL_FUNC->pfnServerActivate
|
|
#define MDLL_ServerDeactivate MDLL_FUNC->pfnServerDeactivate
|
|
#define MDLL_PlayerPreThink MDLL_FUNC->pfnPlayerPreThink
|
|
#define MDLL_PlayerPostThink MDLL_FUNC->pfnPlayerPostThink
|
|
#define MDLL_StartFrame MDLL_FUNC->pfnStartFrame
|
|
#define MDLL_ParmsNewLevel MDLL_FUNC->pfnParmsNewLevel
|
|
#define MDLL_ParmsChangeLevel MDLL_FUNC->pfnParmsChangeLevel
|
|
#define MDLL_GetGameDescription MDLL_FUNC->pfnGetGameDescription
|
|
#define MDLL_PlayerCustomization MDLL_FUNC->pfnPlayerCustomization
|
|
#define MDLL_SpectatorConnect MDLL_FUNC->pfnSpectatorConnect
|
|
#define MDLL_SpectatorDisconnect MDLL_FUNC->pfnSpectatorDisconnect
|
|
#define MDLL_SpectatorThink MDLL_FUNC->pfnSpectatorThink
|
|
#define MDLL_Sys_Error MDLL_FUNC->pfnSys_Error
|
|
#define MDLL_PM_Move MDLL_FUNC->pfnPM_Move
|
|
#define MDLL_PM_Init MDLL_FUNC->pfnPM_Init
|
|
#define MDLL_PM_FindTextureType MDLL_FUNC->pfnPM_FindTextureType
|
|
#define MDLL_SetupVisibility MDLL_FUNC->pfnSetupVisibility
|
|
#define MDLL_UpdateClientData MDLL_FUNC->pfnUpdateClientData
|
|
#define MDLL_AddToFullPack MDLL_FUNC->pfnAddToFullPack
|
|
#define MDLL_CreateBaseline MDLL_FUNC->pfnCreateBaseline
|
|
#define MDLL_RegisterEncoders MDLL_FUNC->pfnRegisterEncoders
|
|
#define MDLL_GetWeaponData MDLL_FUNC->pfnGetWeaponData
|
|
#define MDLL_CmdStart MDLL_FUNC->pfnCmdStart
|
|
#define MDLL_CmdEnd MDLL_FUNC->pfnCmdEnd
|
|
#define MDLL_ConnectionlessPacket MDLL_FUNC->pfnConnectionlessPacket
|
|
#define MDLL_GetHullBounds MDLL_FUNC->pfnGetHullBounds
|
|
#define MDLL_CreateInstancedBaselines MDLL_FUNC->pfnCreateInstancedBaselines
|
|
#define MDLL_InconsistentFile MDLL_FUNC->pfnInconsistentFile
|
|
#define MDLL_AllowLagCompensation MDLL_FUNC->pfnAllowLagCompensation
|
|
|
|
// NEW API functions:
|
|
#define MNEW_FUNC gpGamedllFuncs->newapi_table
|
|
|
|
#define MNEW_OnFreeEntPrivateData MNEW_FUNC->pfnOnFreeEntPrivateData
|
|
#define MNEW_GameShutdown MNEW_FUNC->pfnGameShutdown
|
|
#define MNEW_ShouldCollide MNEW_FUNC->pfnShouldCollide
|
|
#define MNEW_CvarValue MNEW_FUNC->pfnCvarValue
|
|
#define MNEW_CvarValue2 MNEW_FUNC->pfnCvarValue2
|
|
|
|
#endif /* META_API_H */
|