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;
100 #if defined SMEXT_ENABLE_PLUGINSYS
101 SourceMod::IPluginManager *plsys;
103 #if defined SMEXT_ENABLE_MENUS
104 IMenuManager *menus = NULL;
106 #if defined SMEXT_ENABLE_ADMINSYS
107 IAdminSystem *adminsys = NULL;
109 #if defined SMEXT_ENABLE_TEXTPARSERS
110 ITextParsers *textparsers = NULL;
112 #if defined SMEXT_ENABLE_USERMSGS
113 IUserMessages *usermsgs = NULL;
115 #if defined SMEXT_ENABLE_TRANSLATOR
116 ITranslator *translator = NULL;
119 /** Exports the main interface */
120 PLATFORM_EXTERN_C IExtensionInterface *GetSMExtAPI()
122 return g_pExtensionIface;
125 SDKExtension::SDKExtension()
127 #if defined SMEXT_CONF_METAMOD
128 m_SourceMMLoaded = false;
129 m_WeAreUnloaded = false;
130 m_WeGotPauseChange = false;
134 bool SDKExtension::OnExtensionLoad(IExtension *me, IShareSys *sys, char *error, size_t maxlength, bool late)
136 g_pShareSys = sharesys = sys;
139 #if defined SMEXT_CONF_METAMOD
140 m_WeAreUnloaded = true;
142 if (!m_SourceMMLoaded)
146 snprintf(error, maxlength, "Metamod attach failed");
151 SM_GET_IFACE(SOURCEMOD, g_pSM);
153 #if defined SMEXT_ENABLE_HANDLESYS
154 SM_GET_IFACE(HANDLESYSTEM, g_pHandleSys);
155 handlesys = g_pHandleSys;
157 #if defined SMEXT_ENABLE_FORWARDSYS
158 SM_GET_IFACE(FORWARDMANAGER, g_pForwards);
159 forwards = g_pForwards;
161 #if defined SMEXT_ENABLE_PLAYERHELPERS
162 SM_GET_IFACE(PLAYERMANAGER, playerhelpers);
164 #if defined SMEXT_ENABLE_DBMANAGER
165 SM_GET_IFACE(DBI, dbi);
167 #if defined SMEXT_ENABLE_GAMECONF
168 SM_GET_IFACE(GAMECONFIG, gameconfs);
170 #if defined SMEXT_ENABLE_MEMUTILS
171 SM_GET_IFACE(MEMORYUTILS, memutils);
173 #if defined SMEXT_ENABLE_GAMEHELPERS
174 SM_GET_IFACE(GAMEHELPERS, gamehelpers);
176 #if defined SMEXT_ENABLE_TIMERSYS
177 SM_GET_IFACE(TIMERSYS, timersys);
179 #if defined SMEXT_ENABLE_ADTFACTORY
180 SM_GET_IFACE(ADTFACTORY, adtfactory);
182 #if defined SMEXT_ENABLE_THREADER
183 SM_GET_IFACE(THREADER, threader);
185 #if defined SMEXT_ENABLE_LIBSYS
186 SM_GET_IFACE(LIBRARYSYS, libsys);
188 #if defined SMEXT_ENABLE_PLUGINSYS
189 SM_GET_IFACE(PLUGINSYSTEM, plsys);
191 #if defined SMEXT_ENABLE_MENUS
192 SM_GET_IFACE(MENUMANAGER, menus);
194 #if defined SMEXT_ENABLE_ADMINSYS
195 SM_GET_IFACE(ADMINSYS, adminsys);
197 #if defined SMEXT_ENABLE_TEXTPARSERS
198 SM_GET_IFACE(TEXTPARSERS, textparsers);
200 #if defined SMEXT_ENABLE_USERMSGS
201 SM_GET_IFACE(USERMSGS, usermsgs);
203 #if defined SMEXT_ENABLE_TRANSLATOR
204 SM_GET_IFACE(TRANSLATOR, translator);
206 #if defined SMEXT_ENABLE_PLUGINSYS
207 SM_GET_IFACE(PLUGINSYSTEM, plsys);
209 #if defined SMEXT_ENABLE_MENUS
210 SM_GET_IFACE(MENUMANAGER, menus);
212 #if defined SMEXT_ENABLE_ADMINSYS
213 SM_GET_IFACE(ADMINSYS, adminsys);
215 #if defined SMEXT_ENABLE_TEXTPARSERS
216 SM_GET_IFACE(TEXTPARSERS, textparsers);
218 #if defined SMEXT_ENABLE_USERMSGS
219 SM_GET_IFACE(USERMSGS, usermsgs);
221 #if defined SMEXT_ENABLE_TRANSLATOR
222 SM_GET_IFACE(TRANSLATOR, translator);
225 if (SDK_OnLoad(error, maxlength, late))
227 #if defined SMEXT_CONF_METAMOD
228 m_WeAreUnloaded = true;
236 bool SDKExtension::IsMetamodExtension()
238 #if defined SMEXT_CONF_METAMOD
245 void SDKExtension::OnExtensionPauseChange(bool state)
247 #if defined SMEXT_CONF_METAMOD
248 m_WeGotPauseChange = true;
250 SDK_OnPauseChange(state);
253 void SDKExtension::OnExtensionsAllLoaded()
258 void SDKExtension::OnExtensionUnload()
260 #if defined SMEXT_CONF_METAMOD
261 m_WeAreUnloaded = true;
266 const char *SDKExtension::GetExtensionAuthor()
268 return SMEXT_CONF_AUTHOR;
271 const char *SDKExtension::GetExtensionDateString()
273 return SMEXT_CONF_DATESTRING;
276 const char *SDKExtension::GetExtensionDescription()
278 return SMEXT_CONF_DESCRIPTION;
281 const char *SDKExtension::GetExtensionVerString()
283 return SMEXT_CONF_VERSION;
286 const char *SDKExtension::GetExtensionName()
288 return SMEXT_CONF_NAME;
291 const char *SDKExtension::GetExtensionTag()
293 return SMEXT_CONF_LOGTAG;
296 const char *SDKExtension::GetExtensionURL()
298 return SMEXT_CONF_URL;
301 bool SDKExtension::SDK_OnLoad(char *error, size_t maxlength, bool late)
306 void SDKExtension::SDK_OnUnload()
310 void SDKExtension::SDK_OnPauseChange(bool paused)
314 void SDKExtension::SDK_OnAllLoaded()
318 #if defined SMEXT_CONF_METAMOD
320 PluginId g_PLID = 0; /**< Metamod plugin ID */
321 ISmmPlugin *g_PLAPI = NULL; /**< Metamod plugin API */
322 SourceHook::ISourceHook *g_SHPtr = NULL; /**< SourceHook pointer */
323 ISmmAPI *g_SMAPI = NULL; /**< SourceMM API pointer */
325 IVEngineServer *engine = NULL; /**< IVEngineServer pointer */
326 IServerGameDLL *gamedll = NULL; /**< IServerGameDLL pointer */
328 /** Exposes the extension to Metamod */
329 SMM_API void *PL_EXPOSURE(const char *name, int *code)
331 #if defined METAMOD_PLAPI_VERSION
332 if (name && !strcmp(name, METAMOD_PLAPI_NAME))
334 if (name && !strcmp(name, PLAPI_NAME))
341 return static_cast<void *>(g_pExtensionIface);
346 *code = IFACE_FAILED;
352 bool SDKExtension::Load(PluginId id, ISmmAPI *ismm, char *error, size_t maxlen, bool late)
356 #if !defined METAMOD_PLAPI_VERSION
357 GET_V_IFACE_ANY(serverFactory, gamedll, IServerGameDLL, INTERFACEVERSION_SERVERGAMEDLL);
358 GET_V_IFACE_CURRENT(engineFactory, engine, IVEngineServer, INTERFACEVERSION_VENGINESERVER);
360 GET_V_IFACE_ANY(GetServerFactory, gamedll, IServerGameDLL, INTERFACEVERSION_SERVERGAMEDLL);
361 GET_V_IFACE_CURRENT(GetEngineFactory, engine, IVEngineServer, INTERFACEVERSION_VENGINESERVER);
364 m_SourceMMLoaded = true;
366 return SDK_OnMetamodLoad(ismm, error, maxlen, late);
369 bool SDKExtension::Unload(char *error, size_t maxlen)
371 if (!m_WeAreUnloaded)
375 snprintf(error, maxlen, "This extension must be unloaded by SourceMod.");
380 return SDK_OnMetamodUnload(error, maxlen);
383 bool SDKExtension::Pause(char *error, size_t maxlen)
385 if (!m_WeGotPauseChange)
389 snprintf(error, maxlen, "This extension must be paused by SourceMod.");
394 m_WeGotPauseChange = false;
396 return SDK_OnMetamodPauseChange(true, error, maxlen);
399 bool SDKExtension::Unpause(char *error, size_t maxlen)
401 if (!m_WeGotPauseChange)
405 snprintf(error, maxlen, "This extension must be unpaused by SourceMod.");
410 m_WeGotPauseChange = false;
412 return SDK_OnMetamodPauseChange(false, error, maxlen);
415 const char *SDKExtension::GetAuthor()
417 return GetExtensionAuthor();
420 const char *SDKExtension::GetDate()
422 return GetExtensionDateString();
425 const char *SDKExtension::GetDescription()
427 return GetExtensionDescription();
430 const char *SDKExtension::GetLicense()
432 return SMEXT_CONF_LICENSE;
435 const char *SDKExtension::GetLogTag()
437 return GetExtensionTag();
440 const char *SDKExtension::GetName()
442 return GetExtensionName();
445 const char *SDKExtension::GetURL()
447 return GetExtensionURL();
450 const char *SDKExtension::GetVersion()
452 return GetExtensionVerString();
455 bool SDKExtension::SDK_OnMetamodLoad(ISmmAPI *ismm, char *error, size_t maxlength, bool late)
460 bool SDKExtension::SDK_OnMetamodUnload(char *error, size_t maxlength)
465 bool SDKExtension::SDK_OnMetamodPauseChange(bool paused, char *error, size_t maxlength)
472 /* Overload a few things to prevent libstdc++ linking */
473 #if defined __linux__ || defined __APPLE__
474 extern "C" void __cxa_pure_virtual(void)
478 void *operator new(size_t size)
483 void *operator new[](size_t size)
488 void operator delete(void *ptr)
493 void operator delete[](void * ptr)