doc/html/release_notes.html
author Scott Ehlert <ds@alliedmods.net>
Thu Sep 26 17:00:32 2013 -0500 (2013-09-26)
changeset 284 ca90ccdb8d49
parent 275 f62b46dcf019
permissions -rw-r--r--
Fixed makefile error when issuing 'make clean' or 'make distclean'.
     1 <!-- vi: set ts=4 sw=4 : -->
     2 <!-- vim: set tw=75 : -->
     3 
     4 <HTML>
     5 <head>
     6 <title>Metamod Release Notes</title>
     7 </head>
     8 <body>
     9 
    10 <h1>Release Notes
    11 </h1>
    12 
    13 <a name=major.1.20>
    14 <h2>Major changes with Metamod 1.20
    15 </h2></a>
    16 <ul>
    17 	<p><li>New versions of HalfLife do not use '_i386' in the names of the
    18 	Linux game dll anymore. Metamod changed the lookup for game dlls in that
    19 	it first tries to strip anything after the last underscore ('_') in the
    20 	game dll and load that dll. If that file does not exist it falls back
    21 	to the old name for backwards compatibility.
    22 	<li>The HalfLife engine employs this stripping of the dll name on the
    23 	setting found in the liblist.gam file, too. That means that it will
    24 	look for metamod.so, even if the liblist.gam file lists
    25 	metamod_i386.so. Unlike Metamod, the engine will not fall back to the
    26 	old name and fail to load Metamod if it can not be found under
    27 	metamod.so. Therefore we are adding a symbolic link to the tarball.
    28 	When you unpack the tarball to your dlls directory you will get a link
    29 	of name metamod.so so that engine loading can work with the newer
    30 	engine, too. Should you install/update your Metamod dll by hand, you
    31 	will need to make sure that a newer engine can find the dll under
    32 	metamod.so, either by renameing the file or by creating a link to it.
    33 	This does only apply to Linux. The Windows file is still called
    34 	metamod.dll.
    35 </ul>
    36 
    37 <hr>
    38 
    39 <a name=major.1.19>
    40 <h2>Major changes with Metamod 1.19
    41 </h2></a>
    42 <ul>
    43 <p><li>New API version, with one new API function for client cvar querying and another
    44 for calling hook functions.
    45 </ul>
    46 
    47 <hr>
    48 
    49 <a name=major.1.18>
    50 <h2>Major changes with Metamod 1.18
    51 </h2></a>
    52 
    53 <ul>
    54 
    55 <p><li>New API version, with three new API functions for loading and
    56 unloading plugins from other plugins, and one new function for checking client cvar queries.
    57 
    58 <p><li>Support for new HLSDK API engine functions QueryClientCvarValue and CvarValue for querying client cvars.
    59 
    60 <p><li>Console command "meta version" shows the plugin interface version.
    61 
    62 </ul>
    63 
    64 <hr>
    65 
    66 <a name=major.1.17>
    67 <h2>Major changes with Metamod 1.17
    68 </h2></a>
    69 
    70 <ul>
    71 
    72 <p><li> New cvar "<b><tt>metamod_version</tt></b>" that can be queried from
    73 client game browsers.
    74 
    75 <p><li> New console commands available to clients (much like the existing
    76 server console commands):
    77 
    78 	<p><ul>
    79 	<li> <b><tt>"meta version"</tt></b> prints out version information
    80 	(date, compile type, etc).
    81 	<li> <b><tt>"meta list"</tt></b> shows a list of the plugins running on 
    82 	the server (name, author, version, etc).
    83 	</ul>
    84 
    85 <p><li> New file <a
    86 href="metamod.html#config.ini"><tt><b>config.ini</b></tt></a> to provide a
    87 more reliable and flexible method of specifying configuration options.
    88 At the moment, the recognized options mirror those from <a
    89 href="metamod.html#localinfo">+localinfo</a>, ie:
    90 
    91 	<p>
    92 	<ul>
    93 	<li> <tt><b>debuglevel</b> <i>&lt;number&gt;</i></tt>
    94 	<li> <tt><b>gamedll</b> <i>&lt;path&gt;</i></tt>
    95 	<li> <tt><b>plugins_file</b> <i>&lt;path&gt;</i></tt>
    96 	<li> <tt><b>exec_cfg</b> <i>&lt;path&gt;</i></tt>
    97 	</ul>
    98 
    99 <p>Default path is "<tt>addons/metamod/config.ini</tt>" but can be
   100 overridden with "<tt>+localinfo mm_configfile</tt>".
   101 
   102 <p>Also, new console command <tt><b>"meta config"</b></tt> to display this
   103 information.
   104 
   105 <p><li> New console command <tt><b>"meta require"</b></tt> to force the
   106 server to exit if the specified plugin isn't loaded/running.  Intended for
   107 use in server.cfg or metaexec.cfg, to keep the server from starting up if
   108 desired plugins don't load.  For example:
   109 
   110 	<p>
   111 	<ul>
   112 	<li> <tt>meta require adminmod</tt>
   113 	<li> <tt>meta require 1</tt>
   114 	</ul>
   115 
   116 <p>The former requires that a plugin with the substring "adminmod" is found
   117 loaded and running.  The latter requires that the plugin in slot 1 is
   118 loaded and running.
   119 
   120 <p><li> If an override gamedll is specified and found to be invalid or
   121 missing, Metamod will now exit with an appropriate error message, rather
   122 than just falling back to the auto-detected gamedll.  This should provide
   123 more immediate and useful feedback, and help prevent some confusion.
   124 
   125 </ul>
   126 
   127 <p>
   128 <hr>
   129 
   130 <a name=compat.1.13>
   131 <h2>Incompatible changes with Metamod 1.13
   132 </h2></a>
   133 
   134 <ul>
   135 
   136 <li> Config file <tt><b>metagame.ini</b></tt> is no longer supported.  This
   137 file was deprecated in Metamod 1.08 (2001/06/16).  Use instead the "<a
   138 href="metamod.html#localinfo">+localinfo mm_gamedll</a>" option.
   139 
   140 </ul>
   141 
   142 
   143 <a name=major.1.13>
   144 <h2>Major changes with Metamod 1.13
   145 </h2></a>
   146 
   147 <ul>
   148 
   149 <li> New config file names and locations, per the <a
   150 href="http://www.unitedadmins.com/info_addon_dev_standards.aspx">Addon
   151 Development Standard</a> rev 1.00, developed on the <a
   152 href="http://list.valvesoftware.com/mailman/listinfo/hlds_apps">hlds_apps</a>
   153 list.  
   154 
   155 	<p> Default config file locations are now:
   156 	<ul>
   157 	<li> $gamedir/addons/metamod/plugins.ini
   158 	<li> $gamedir/addons/metamod/exec.cfg
   159 	</ul>
   160 
   161 	<p> Previous config file locations are also supported for backwards
   162 	compability:
   163 
   164 	<ul>
   165 	<li> $gamedir/metamod.ini
   166 	<li> $gamedir/metaexec.cfg
   167 	</ul>
   168 
   169 	<p> Note that the pathnames in plugins.ini are unchanged, and are still
   170 	relative to the gamedir.
   171 
   172 </ul>
   173 
   174 <p>
   175 <hr>
   176 
   177 </body>
   178 </HTML>