3 * =============================================================================
4 * SourceMod Base Extension Code
5 * Copyright (C) 2004-2008 AlliedModders LLC. All rights reserved.
6 * =============================================================================
8 * This program is free software; you can redistribute it and/or modify it under
9 * the terms of the GNU General Public License, version 3.0, as published by the
10 * Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but WITHOUT
13 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
17 * You should have received a copy of the GNU General Public License along with
18 * this program. If not, see <http://www.gnu.org/licenses/>.
20 * As a special exception, AlliedModders LLC gives you permission to link the
21 * code of this program (as well as its derivative works) to "Half-Life 2," the
22 * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
23 * by the Valve Corporation. You must obey the GNU General Public License in
24 * all respects for all other code used. Additionally, AlliedModders LLC grants
25 * this exception to all derivative works. AlliedModders LLC defines further
26 * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
27 * or <http://www.sourcemod.net/license.php>.
34 #include "smsdk_ext.h"
38 * @brief Contains wrappers for making Extensions easier to write.
41 IExtension *myself = NULL; /**< Ourself */
42 IShareSys *g_pShareSys = NULL; /**< Share system */
43 IShareSys *sharesys = NULL; /**< Share system */
44 ISourceMod *g_pSM = NULL; /**< SourceMod helpers */
45 ISourceMod *smutils = NULL; /**< SourceMod helpers */
47 #if defined SMEXT_ENABLE_FORWARDSYS
48 IForwardManager *g_pForwards = NULL; /**< Forward system */
49 IForwardManager *forwards = NULL; /**< Forward system */
51 #if defined SMEXT_ENABLE_HANDLESYS
52 IHandleSys *g_pHandleSys = NULL; /**< Handle system */
53 IHandleSys *handlesys = NULL; /**< Handle system */
55 #if defined SMEXT_ENABLE_PLAYERHELPERS
56 IPlayerManager *playerhelpers = NULL; /**< Player helpers */
57 #endif //SMEXT_ENABLE_PLAYERHELPERS
58 #if defined SMEXT_ENABLE_DBMANAGER
59 IDBManager *dbi = NULL; /**< DB Manager */
60 #endif //SMEXT_ENABLE_DBMANAGER
61 #if defined SMEXT_ENABLE_GAMECONF
62 IGameConfigManager *gameconfs = NULL; /**< Game config manager */
63 #endif //SMEXT_ENABLE_DBMANAGER
64 #if defined SMEXT_ENABLE_MEMUTILS
65 IMemoryUtils *memutils = NULL;
66 #endif //SMEXT_ENABLE_DBMANAGER
67 #if defined SMEXT_ENABLE_GAMEHELPERS
68 IGameHelpers *gamehelpers = NULL;
70 #if defined SMEXT_ENABLE_TIMERSYS
71 ITimerSystem *timersys = NULL;
73 #if defined SMEXT_ENABLE_ADTFACTORY
74 IADTFactory *adtfactory = NULL;
76 #if defined SMEXT_ENABLE_THREADER
77 IThreader *threader = NULL;
79 #if defined SMEXT_ENABLE_LIBSYS
80 ILibrarySys *libsys = NULL;
82 #if defined SMEXT_ENABLE_PLUGINSYS
83 SourceMod::IPluginManager *plsys;
85 #if defined SMEXT_ENABLE_MENUS
86 IMenuManager *menus = NULL;
88 #if defined SMEXT_ENABLE_ADMINSYS
89 IAdminSystem *adminsys = NULL;
91 #if defined SMEXT_ENABLE_TEXTPARSERS
92 ITextParsers *textparsers = NULL;
94 #if defined SMEXT_ENABLE_USERMSGS
95 IUserMessages *usermsgs = NULL;
97 #if defined SMEXT_ENABLE_TRANSLATOR
98 ITranslator *translator = NULL;
101 /** Exports the main interface */
102 PLATFORM_EXTERN_C IExtensionInterface *GetSMExtAPI()
104 return g_pExtensionIface;
107 SDKExtension::SDKExtension()
109 #if defined SMEXT_CONF_METAMOD
110 m_SourceMMLoaded = false;
111 m_WeAreUnloaded = false;
112 m_WeGotPauseChange = false;
116 bool SDKExtension::OnExtensionLoad(IExtension *me, IShareSys *sys, char *error, size_t maxlength, bool late)
118 g_pShareSys = sharesys = sys;
121 #if defined SMEXT_CONF_METAMOD
122 m_WeAreUnloaded = true;
124 if (!m_SourceMMLoaded)
128 snprintf(error, maxlength, "Metamod attach failed");
133 SM_GET_IFACE(SOURCEMOD, g_pSM);
135 #if defined SMEXT_ENABLE_HANDLESYS
136 SM_GET_IFACE(HANDLESYSTEM, g_pHandleSys);
137 handlesys = g_pHandleSys;
139 #if defined SMEXT_ENABLE_FORWARDSYS
140 SM_GET_IFACE(FORWARDMANAGER, g_pForwards);
141 forwards = g_pForwards;
143 #if defined SMEXT_ENABLE_PLAYERHELPERS
144 SM_GET_IFACE(PLAYERMANAGER, playerhelpers);
146 #if defined SMEXT_ENABLE_DBMANAGER
147 SM_GET_IFACE(DBI, dbi);
149 #if defined SMEXT_ENABLE_GAMECONF
150 SM_GET_IFACE(GAMECONFIG, gameconfs);
152 #if defined SMEXT_ENABLE_MEMUTILS
153 SM_GET_IFACE(MEMORYUTILS, memutils);
155 #if defined SMEXT_ENABLE_GAMEHELPERS
156 SM_GET_IFACE(GAMEHELPERS, gamehelpers);
158 #if defined SMEXT_ENABLE_TIMERSYS
159 SM_GET_IFACE(TIMERSYS, timersys);
161 #if defined SMEXT_ENABLE_ADTFACTORY
162 SM_GET_IFACE(ADTFACTORY, adtfactory);
164 #if defined SMEXT_ENABLE_THREADER
165 SM_GET_IFACE(THREADER, threader);
167 #if defined SMEXT_ENABLE_LIBSYS
168 SM_GET_IFACE(LIBRARYSYS, libsys);
170 #if defined SMEXT_ENABLE_PLUGINSYS
171 SM_GET_IFACE(PLUGINSYSTEM, plsys);
173 #if defined SMEXT_ENABLE_MENUS
174 SM_GET_IFACE(MENUMANAGER, menus);
176 #if defined SMEXT_ENABLE_ADMINSYS
177 SM_GET_IFACE(ADMINSYS, adminsys);
179 #if defined SMEXT_ENABLE_TEXTPARSERS
180 SM_GET_IFACE(TEXTPARSERS, textparsers);
182 #if defined SMEXT_ENABLE_USERMSGS
183 SM_GET_IFACE(USERMSGS, usermsgs);
185 #if defined SMEXT_ENABLE_TRANSLATOR
186 SM_GET_IFACE(TRANSLATOR, translator);
189 if (SDK_OnLoad(error, maxlength, late))
191 #if defined SMEXT_CONF_METAMOD
192 m_WeAreUnloaded = true;
200 bool SDKExtension::IsMetamodExtension()
202 #if defined SMEXT_CONF_METAMOD
209 void SDKExtension::OnExtensionPauseChange(bool state)
211 #if defined SMEXT_CONF_METAMOD
212 m_WeGotPauseChange = true;
214 SDK_OnPauseChange(state);
217 void SDKExtension::OnExtensionsAllLoaded()
222 void SDKExtension::OnExtensionUnload()
224 #if defined SMEXT_CONF_METAMOD
225 m_WeAreUnloaded = true;
230 const char *SDKExtension::GetExtensionAuthor()
232 return SMEXT_CONF_AUTHOR;
235 const char *SDKExtension::GetExtensionDateString()
237 return SMEXT_CONF_DATESTRING;
240 const char *SDKExtension::GetExtensionDescription()
242 return SMEXT_CONF_DESCRIPTION;
245 const char *SDKExtension::GetExtensionVerString()
247 return SMEXT_CONF_VERSION;
250 const char *SDKExtension::GetExtensionName()
252 return SMEXT_CONF_NAME;
255 const char *SDKExtension::GetExtensionTag()
257 return SMEXT_CONF_LOGTAG;
260 const char *SDKExtension::GetExtensionURL()
262 return SMEXT_CONF_URL;
265 bool SDKExtension::SDK_OnLoad(char *error, size_t maxlength, bool late)
270 void SDKExtension::SDK_OnUnload()
274 void SDKExtension::SDK_OnPauseChange(bool paused)
278 void SDKExtension::SDK_OnAllLoaded()
282 #if defined SMEXT_CONF_METAMOD
284 PluginId g_PLID = 0; /**< Metamod plugin ID */
285 ISmmPlugin *g_PLAPI = NULL; /**< Metamod plugin API */
286 SourceHook::ISourceHook *g_SHPtr = NULL; /**< SourceHook pointer */
287 ISmmAPI *g_SMAPI = NULL; /**< SourceMM API pointer */
289 IVEngineServer *engine = NULL; /**< IVEngineServer pointer */
290 IServerGameDLL *gamedll = NULL; /**< IServerGameDLL pointer */
292 /** Exposes the extension to Metamod */
293 SMM_API void *PL_EXPOSURE(const char *name, int *code)
295 #if defined METAMOD_PLAPI_VERSION
296 if (name && !strcmp(name, METAMOD_PLAPI_NAME))
298 if (name && !strcmp(name, PLAPI_NAME))
305 return static_cast<void *>(g_pExtensionIface);
310 *code = IFACE_FAILED;
316 bool SDKExtension::Load(PluginId id, ISmmAPI *ismm, char *error, size_t maxlen, bool late)
320 #if !defined METAMOD_PLAPI_VERSION
321 GET_V_IFACE_ANY(serverFactory, gamedll, IServerGameDLL, INTERFACEVERSION_SERVERGAMEDLL);
322 GET_V_IFACE_CURRENT(engineFactory, engine, IVEngineServer, INTERFACEVERSION_VENGINESERVER);
324 GET_V_IFACE_ANY(GetServerFactory, gamedll, IServerGameDLL, INTERFACEVERSION_SERVERGAMEDLL);
325 GET_V_IFACE_CURRENT(GetEngineFactory, engine, IVEngineServer, INTERFACEVERSION_VENGINESERVER);
328 m_SourceMMLoaded = true;
330 return SDK_OnMetamodLoad(ismm, error, maxlen, late);
333 bool SDKExtension::Unload(char *error, size_t maxlen)
335 if (!m_WeAreUnloaded)
339 snprintf(error, maxlen, "This extension must be unloaded by SourceMod.");
344 return SDK_OnMetamodUnload(error, maxlen);
347 bool SDKExtension::Pause(char *error, size_t maxlen)
349 if (!m_WeGotPauseChange)
353 snprintf(error, maxlen, "This extension must be paused by SourceMod.");
358 m_WeGotPauseChange = false;
360 return SDK_OnMetamodPauseChange(true, error, maxlen);
363 bool SDKExtension::Unpause(char *error, size_t maxlen)
365 if (!m_WeGotPauseChange)
369 snprintf(error, maxlen, "This extension must be unpaused by SourceMod.");
374 m_WeGotPauseChange = false;
376 return SDK_OnMetamodPauseChange(false, error, maxlen);
379 const char *SDKExtension::GetAuthor()
381 return GetExtensionAuthor();
384 const char *SDKExtension::GetDate()
386 return GetExtensionDateString();
389 const char *SDKExtension::GetDescription()
391 return GetExtensionDescription();
394 const char *SDKExtension::GetLicense()
396 return SMEXT_CONF_LICENSE;
399 const char *SDKExtension::GetLogTag()
401 return GetExtensionTag();
404 const char *SDKExtension::GetName()
406 return GetExtensionName();
409 const char *SDKExtension::GetURL()
411 return GetExtensionURL();
414 const char *SDKExtension::GetVersion()
416 return GetExtensionVerString();
419 bool SDKExtension::SDK_OnMetamodLoad(ISmmAPI *ismm, char *error, size_t maxlength, bool late)
424 bool SDKExtension::SDK_OnMetamodUnload(char *error, size_t maxlength)
429 bool SDKExtension::SDK_OnMetamodPauseChange(bool paused, char *error, size_t maxlength)
436 /* Overload a few things to prevent libstdc++ linking */
437 #if defined __linux__ || defined __APPLE__
438 extern "C" void __cxa_pure_virtual(void)
442 void *operator new(size_t size)
447 void *operator new[](size_t size)
452 void operator delete(void *ptr)
457 void operator delete[](void * ptr)