core/ISmmPluginExt.h
author Nicholas Hastings <skamonkey@gmail.com>
Sun Mar 23 23:37:46 2014 -0400 (2014-03-23)
changeset 909 57797db1d513
parent 858 a534b75f1b59
permissions -rw-r--r--
Add support for Contagion (bug 6006).
     1 /*
     2  * vim: set ts=4 sw=4 tw=99 noet :
     3  * ======================================================
     4  * Metamod:Source
     5  * Copyright (C) 2004-2009 AlliedModders LLC and authors.
     6  * All rights reserved.
     7  * ======================================================
     8  *
     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.
    12  * 
    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:
    16  *
    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.
    24  */
    25 
    26 #ifndef _INCLUDE_METAMOD_SOURCE_PLUGIN_EXT_H_
    27 #define _INCLUDE_METAMOD_SOURCE_PLUGIN_EXT_H_
    28 
    29 #include <stddef.h>
    30 
    31 // Interface return status, binary-compatible with HL2SDK's IFACE_OK and IFACE_FAILED.
    32 enum 
    33 {
    34 	META_IFACE_OK = 0,
    35 	META_IFACE_FAILED
    36 };
    37 
    38 /**
    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.
    41  *
    42  * @brief Definitions for extended plugin loading.
    43  */
    44 
    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 */
    68 
    69 #define METAMOD_PLAPI_VERSION			15				/**< Version of this header file */
    70 #define METAMOD_PLAPI_NAME				"ISmmPlugin"	/**< Name of the plugin interface */
    71 
    72 namespace SourceMM
    73 {
    74 	class ISmmPlugin;
    75 	class ISmmAPI;
    76 
    77 	/**
    78 	 * @brief Used to uniquely identify plugins.
    79 	 */
    80 	typedef int PluginId;
    81 
    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 */
    84 
    85 	/**
    86 	 * Use this to instantiate a plugin that will always fail.
    87 	 * This class definition works against major API versions 1 and 2.
    88 	 */
    89 	class ISmmFailPlugin
    90 	{
    91 	public:
    92 		/**
    93 		 * @brief You must return METAMOD_FAIL_API_V1 or METAMOD_FAIL_API_V2 here, 
    94 		 * depending on which Metamod:Source version you detected.
    95 		 */
    96 		virtual int GetApiVersion() = 0;
    97 
    98 		/**
    99 		 * @brief Do not change.
   100 		 */
   101 		virtual ~ISmmFailPlugin()
   102 		{
   103 		}
   104 
   105 		/**
   106 		 * @brief Return false here -- fill in the error buffer appropriately.
   107 		 *
   108 		 * Do not ever return true.  If you do, MM:S will crash because the class layout is 
   109 		 * incomplete against ISmmPlugin.
   110 		 * 
   111 		 * @param id			Ignore.
   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.
   117 		 */
   118 		virtual bool Load(PluginId id, ISmmAPI *ismm, char *error, size_t maxlength, bool late) =0;
   119 	};
   120 }
   121 
   122 typedef SourceMM::ISmmPlugin METAMOD_PLUGIN;
   123 
   124 /**
   125  * @brief Contains version information.
   126  */
   127 struct MetamodVersionInfo
   128 {
   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 */
   137 
   138 	/**
   139 	 * @brief Returns the game folder.
   140 	 *
   141 	 * @return      Game folder, or NULL if not available on this version
   142 	 *              of Metamod:Source.
   143 	 */
   144 	inline const char *GetGameDir() const
   145 	{
   146 		if (pl_max < 15)
   147 			return NULL;
   148 		return game_dir;
   149 	}
   150 };
   151 
   152 /**
   153  * @brief Contains information about loading a plugin.
   154  */
   155 struct MetamodLoaderInfo
   156 {
   157 	const char *pl_file;	/**< File path to the plugin being loaded. */
   158 	const char *pl_path;	/**< Folder path containing the plugin. */
   159 };
   160 
   161 /**
   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.
   166  *
   167  * This is useful for implementing a mini-loader plugin for multiple versions.
   168  *
   169  * @param mvi				MetamodVersionInfo structure.
   170  * @param mli				MetamodLoaderInfo structure.
   171  * @return					ISmmAPI pointer, or NULL if none.
   172  */
   173 typedef METAMOD_PLUGIN *(*METAMOD_FN_LOAD)(const MetamodVersionInfo *mvi, 
   174 										   const MetamodLoaderInfo *mli);
   175 
   176 /**
   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.
   181  *
   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.
   184  */
   185 typedef void (*METAMOD_FN_UNLOAD)();
   186 
   187 /**
   188  * @brief Original type of load function.  CreateInterfaceFn from Valve.
   189  * 
   190  * Plugins will expose this as "CreateInterface".
   191  */
   192 typedef void *(*METAMOD_FN_ORIG_LOAD)(const char *, int *);
   193 
   194 #endif //INCLUDE_METAMOD_SOURCE_PLUGIN_EXT_H_
   195