2 * vim: set ts=4 sw=4 tw=99 noet :
3 * ======================================================
5 * Copyright (C) 2004-2009 AlliedModders LLC and authors.
7 * ======================================================
9 * This software is provided 'as-is', without any express or implied warranty.
10 * In no event will the authors be held liable for any damages arising from
11 * the use of this software.
13 * Permission is granted to anyone to use this software for any purpose,
14 * including commercial applications, and to alter it and redistribute it
15 * freely, subject to the following restrictions:
17 * 1. The origin of this software must not be misrepresented; you must not
18 * claim that you wrote the original software. If you use this software in a
19 * product, an acknowledgment in the product documentation would be
20 * appreciated but is not required.
21 * 2. Altered source versions must be plainly marked as such, and must not be
22 * misrepresented as being the original software.
23 * 3. This notice may not be removed or altered from any source distribution.
26 #ifndef _INCLUDE_METAMOD_SOURCE_PLUGIN_EXT_H_
27 #define _INCLUDE_METAMOD_SOURCE_PLUGIN_EXT_H_
31 // Interface return status, binary-compatible with HL2SDK's IFACE_OK and IFACE_FAILED.
39 * @file ISmmPluginExt.h Provides an alternate method for loading plugins,
40 * without needing to include the default headers and all their Half-Life baggage.
42 * @brief Definitions for extended plugin loading.
45 #define SOURCE_ENGINE_UNKNOWN 0 /**< Could not determine the engine version */
46 #define SOURCE_ENGINE_ORIGINAL 1 /**< Original Source Engine (used by The Ship) */
47 #define SOURCE_ENGINE_EPISODEONE 2 /**< Episode 1 Source Engine (second major SDK) */
48 #define SOURCE_ENGINE_ORANGEBOX 3 /**< Orange Box Source Engine (third major SDK) */
49 #define SOURCE_ENGINE_LEFT4DEAD 4 /**< Left 4 Dead */
50 #define SOURCE_ENGINE_DARKMESSIAH 5 /**< Dark Messiah Multiplayer (based on original engine) */
51 #define SOURCE_ENGINE_ORANGEBOXVALVE_DEPRECATED 6 /**< Orange Box Source Engine for Valve games (TF2/DOD:S/HL2DM) */
52 #define SOURCE_ENGINE_LEFT4DEAD2 7 /**< Left 4 Dead 2 */
53 #define SOURCE_ENGINE_ALIENSWARM 8 /**< Alien Swarm */
54 #define SOURCE_ENGINE_BLOODYGOODTIME 9 /**< Bloody Good Time */
55 #define SOURCE_ENGINE_EYE 10 /**< E.Y.E Divine Cybermancy */
56 #define SOURCE_ENGINE_PORTAL2 11 /**< Portal 2 */
57 #define SOURCE_ENGINE_CSGO 12 /**< Counter-Strike: Global Offensive */
58 #define SOURCE_ENGINE_CSS 13 /**< Counter-Strike: Source (sometimes older version of Orange Box Valve) */
59 #define SOURCE_ENGINE_DOTA 14 /**< Dota 2 */
60 #define SOURCE_ENGINE_HL2DM 15 /**< Half-Life 2 Deathmatch */
61 #define SOURCE_ENGINE_DODS 16 /**< Day of Defeat: Source */
62 #define SOURCE_ENGINE_TF2 17 /**< Team Fortress 2 */
63 #define SOURCE_ENGINE_NUCLEARDAWN 18 /**< Nuclear Dawn */
64 #define SOURCE_ENGINE_SDK2013 19 /**< Source SDK 2013 */
65 #define SOURCE_ENGINE_BLADE 20 /**< Blade Symphony */
66 #define SOURCE_ENGINE_INSURGENCY 21 /**< Insurgency */
67 #define SOURCE_ENGINE_CONTAGION 22 /**< Contagion */
69 #define METAMOD_PLAPI_VERSION 15 /**< Version of this header file */
70 #define METAMOD_PLAPI_NAME "ISmmPlugin" /**< Name of the plugin interface */
78 * @brief Used to uniquely identify plugins.
82 #define METAMOD_FAIL_API_V1 7 /**< Minimum API version to detect for V1 */
83 #define METAMOD_FAIL_API_V2 14 /**< Minimum API version to detect for V2 */
86 * Use this to instantiate a plugin that will always fail.
87 * This class definition works against major API versions 1 and 2.
93 * @brief You must return METAMOD_FAIL_API_V1 or METAMOD_FAIL_API_V2 here,
94 * depending on which Metamod:Source version you detected.
96 virtual int GetApiVersion() = 0;
99 * @brief Do not change.
101 virtual ~ISmmFailPlugin()
106 * @brief Return false here -- fill in the error buffer appropriately.
108 * Do not ever return true. If you do, MM:S will crash because the class layout is
109 * incomplete against ISmmPlugin.
112 * @param ismm Ignore.
113 * @param error Error buffer (must be filled).
114 * @param maxlength Maximum size of error buffer.
115 * @param late Ignore.
116 * @return Must return false.
118 virtual bool Load(PluginId id, ISmmAPI *ismm, char *error, size_t maxlength, bool late) =0;
122 typedef SourceMM::ISmmPlugin METAMOD_PLUGIN;
125 * @brief Contains version information.
127 struct MetamodVersionInfo
129 int api_major; /**< ISmmAPI major version */
130 int api_minor; /**< ISmmAPI minor version */
131 int sh_iface; /**< SourceHook interface version */
132 int sh_impl; /**< SourceHook implementation version */
133 int pl_min; /**< Plugin API minimum version */
134 int pl_max; /**< Plugin API maximum version */
135 int source_engine; /**< Source Engine version (SOURCE_* constants) */
136 const char *game_dir; /**< Game directory name */
139 * @brief Returns the game folder.
141 * @return Game folder, or NULL if not available on this version
144 inline const char *GetGameDir() const
153 * @brief Contains information about loading a plugin.
155 struct MetamodLoaderInfo
157 const char *pl_file; /**< File path to the plugin being loaded. */
158 const char *pl_path; /**< Folder path containing the plugin. */
162 * @brief If a function of this type is exposed as "CreateInterface_MMS", then
163 * Metamod:Source will attempt to call this function before calling
164 * CreateInterface. If this function returns a valid ISmmPlugin pointer, then
165 * CreateInterface will not be called.
167 * This is useful for implementing a mini-loader plugin for multiple versions.
169 * @param mvi MetamodVersionInfo structure.
170 * @param mli MetamodLoaderInfo structure.
171 * @return ISmmAPI pointer, or NULL if none.
173 typedef METAMOD_PLUGIN *(*METAMOD_FN_LOAD)(const MetamodVersionInfo *mvi,
174 const MetamodLoaderInfo *mli);
177 * @brief If a function of this type is exposed as "UnloadInterface_MMS", then
178 * Metamod:Source will attempt to call this function after calling
179 * ISmmAPI::Unload(), and before closing the library. This lets loader plugins
180 * clean up before exiting.
182 * Note: This function will be ignored unless CreateInterfce_MMS was exposed.
183 * It may be called even if ISmmAPI::Unload() could not be called.
185 typedef void (*METAMOD_FN_UNLOAD)();
188 * @brief Original type of load function. CreateInterfaceFn from Valve.
190 * Plugins will expose this as "CreateInterface".
192 typedef void *(*METAMOD_FN_ORIG_LOAD)(const char *, int *);
194 #endif //INCLUDE_METAMOD_SOURCE_PLUGIN_EXT_H_