View source for AMX Mod X 1.8.0 Changes

AMX Mod X 1.8 is a large release with many changes, both to the development API and user-mode features.
=Per-Map Features=
You can now have per-map prefix-based configuration files for plugins and .cfg scripts.
*<tt>configs/maps/prefix_&lt;prefix&gt;.cfg</tt> <i>(for example)</i>
**<tt>configs/maps/prefix_de.cfg</tt> will run on any de_* map.
*<tt>configs/maps/plugins-&lt;prefix&gt;.ini</tt> <i>(for example)</i>
**<tt>configs/maps/plugins-de.ini</tt> will load all contained plugins on any de_* map.

=Command Flag Changing=
You can now change the access flags required by commands without recompiling or editing scripts. AMX Mod X caches all command flags in <tt>configs/cmdaccess.ini</tt>, where they can be easily edited.

A few notes:
*To disable this feature for a single command in the ini file, set its access flag in the ini file to "*"

*To disable this feature entirely, change "disableflagman 0" in core.ini to be "disableflagman 1"

*In the default state, the flag manager will try to guess which commands should be excluded. The rules are as follows:
**All commands with the default access (-1, '''not''' ADMIN_ALL) are not included
**All commands that begin with "say" are not included
**To disable flag manager for storing commands from inside of the plugin, set the new 5th parameter of register_clcmd or register_concmd to 0.
**To tell flag manager to always store your command, even if the filter would have ruled it out set the 5th parameter to 1.
**The default value of this new 5th parameter is -1, this means it will treat it as if the parameter did not exist.
**'''Note:''' Even if a plugin exclusively tells flag manager to hide the command, the admin can insert it into cmdaccess.ini and it will be used.

Also, changes to access will not take effect until a map change. Additionally, the automatic writing of newly detected commands does not occur until map change.

=Ham Sandwich=
Ham Sandwich is a very powerful module by [[User:Sawce|sawce]] which can hook and call virtual CBaseEntity functions on a variety of mods. For more information, see the [http://svn.alliedmods.net/viewvc.cgi/trunk/plugins/include/hamsandwich.inc?root=amxmodx&view=log hamsandwich.inc] file.

=Dynamic Global Arrays=
Also by [[User:Sawce|sawce]], dynamic global arrays are now available in AMX Mod X. You can read the full specs in [http://svn.alliedmods.net/viewvc.cgi/trunk/plugins/include/cellarray.inc?root=amxmodx&view=log cellarray.inc].

Additionally, the hardcoded limits of a few plugins have been lifted:
*Admins are now dynamic and not limited to <tt>MAX_ADMINS</tt>.
*Mapchooser no longer has a predefined map limit.
*Maps menu no longer has a predefined map limit.
*imessage no longer has a predefined message limit.

=Backwards Compatibility Issues=
Before AMX Mod X 1.8.0, <tt>menu_create</tt> would automatically call <tt>register_menucmd</tt>. This was, in fact, a bug, as the calling conventions between <tt>register_menucmd</tt> and new menu callbacks are entirely different. This was a serious error and it was removed in AMX Mod X 1.8.0.

This accidental functionality was not documented API. However, some plugins have been found to mistakenly abuse this property. An example is calling <tt>menu_create</tt> and having <tt>show_menu</tt> calls run through your <tt>menu_create</tt> callback instead of using <tt>menu_display</tt> properly.

The old functionality cannot be enabled globally because it is a serious error and causes many problems. The following plugins would otherwise break on AMX Mod X 1.8.0, and we have specifically inserted backwards compatibility shims for them. If your plugin's menus have broken in 1.8.0 and need the shim enabled, please contact the development team via the bug report tool.
*<tt>war3ft.amxx</tt>, versions <tt>3.0 RC1</tt> through <tt>3.0 RC8</tt>. No compatibility is provided for RC9+.

=Removed Downloads=
Downloads for AMX Mod X 0.1, 0.15, and 0.16 have been removed from the SourceForge downloads page. These builds are highly legacy and no longer used, and were removed to avoid clutter and confusion. Source code is still available via /svnroot/amxmodx/tags.

Downloads for "Bin Logging" builds have been removed. These builds had terrible performance and were fairly unusable. They also had little use to the development team in fixing actual problems. If your plugin crashes, file a bug report and the development team can work with you in determining the cause.

=Changelog=
==Overall Changes==
*Added a new module, Ham Sandwich, for hooking and calling virtual CBaseEntity functions in mods.
*Command flags are now initially dumped to disk and can be edited via <tt>configs/cmdaccess.ini</tt>.
*Added {{AMBug|48738}}: Romanian translation from X-5173.
*Added {{AMBug|50741}} and {{AMBug|43830}}: per-map plugins files can now be prefixed based.
*Added {{amb|17}}: New menu rendering is now more consistent; non-consistent controls are deprecated.
*Added {{amb|32}}: The server console commands "amxx cvars" and "amxx cmds" can now filter by plugin.
*Added {{amb|122}}: Log file names now include a four-digit year.
*Fixed {{amb|18}}: New menus are now properly destroyed if overridden.
*Fixed {{amb|46}}: <tt>is_user_bot</tt> had some false positives.
*Fixed {{amb|69}}: Fixed Metamod trying to reload AMX Mod X against a poorly configured clock.
*Fixed {{amb|207}}: New menus now display "0" instead of "10."
*Fixed {{amb|208}}: New menus did not reset callback results after each call.
*Fixed {{amb|200}}: Dynamic/fake natives were not re-entrant.
*Fixed {{amb|244}}: Run-time errors blocked forwards.
*Fixed {{amb|305}}: Core crashed on mods that removed the standard <tt>mp_timelimit</tt> cvar.
*Fixed many various internal new menu rendering and item selection bugs. This may have introduced backwards compatibility problems with plugins relying on undocumented bugs. In specific, <tt>menu_create</tt> no longer calls <tt>register_menucmd</tt> and thus new menu callbacks will now only be invoked strictly from a call to <tt>menu_display</tt>.

==Scripting Changes==
*All include files are now #pragma semicolon safe.
*New menu functions are now in a separate, newly documented include file (newmenus.inc).
*Added natives for dynamic global arrays.
*Added a new, magic <tt>any</tt> tag from [[SourceMod]].
*Added a <tt>charsmax</tt> macro for safe sizeof(string)-1 usage.
*Added <tt>set_pcvar_string</tt>().
*Added <tt>LookupLangKey</tt>().
*Added <tt>SQL_QuoteString</tt>().
*Added <tt>[g|s]et_pdata_cbase[_safe]</tt>() to the Ham Sandwich module.
*Added <tt>geoip_code[2|3]_ex</tt>(), which address a serious issue in the now deprecated <tt>geoip_code[2|3]</tt>().
*Added <tt>lookup_sequence</tt>(), <tt>set_controller</tt>(), <tt>set_pev_string</tt>(), and <tt>pev_serial</tt>() to Fakemeta.
*Added a menu property to change the numbering color.
*Added {{amb|27}}: <tt>SQL_Rewind</tt>().
*Added {{amb|37}}: <tt>cs_[g|s]et_user_submodel</tt>().
*Added {{amb|38}}: <tt>cs_[g|s]et_user_lastactivity</tt>().
*Added {{amb|39}}: <tt>cs_[g|s]et_hostage_lastuse</tt>() and <tt>cs_[g|s]et_hostage_nextuse</tt>().
*Added {{amb|63}}: <tt>floatmin</tt>(), <tt>floatmax</tt>(), and <tt>floatclamp()</tt>.
*Added {{amb|76}}: Formatting functions can now use %x or %X for hexadecimal numbers.
*Added {{amb|92}}: <tt>create_tr2</tt>() and <tt>free_tr2</tt>().
*Added {{amb|205}}: <tt>cs_[g|s]et_c4_explode_time</tt>().
*Added {{amb|216}}: <tt>SQL_MakeStdTuple</tt>() now has a timeout parameter.
*Added {{amb|237}}: Fakemeta can now call "ServerPrint."
*Added {{amb|242}}: <tt>cs_[g|s]et_user_hostagekills</tt>().
*Added {{amb|245}}: <tt>precache_sound</tt> now returns a precache index.
*Added {{amb|261}}: <tt>has_flag</tt>() and <tt>has_all_flags</tt>().
*Added {{amb|281}}: <tt>SQL_NextResultSet()</tt> for multiple result sets on MySQL.
*Added {{amb|291}}: <tt>cs_[g|s]et_c4_defusing</tt>().
*Added {{amb|673}}: <tt>regex_compile</tt>() and <tt>regex_match_c</tt> for pre-compiling expressions.
*Added {{AMBug|46213}}: <tt>player_menu_info</tt>() now returns a page number.
*Added {{AMBug|51064}}: Some parameters to <tt>get_plugin</tt> are now optional.
*Added {{AMBug|50610}}: Some parameters to <tt>get_user_weapon</tt> are now optional.
*Added {{AMBug|48841}}: <tt>tfc_is_user_feigning</tt>().
*Added {{AMBug|45664}}: <tt>tfc_is_team_ally</tt>().
*Fixed {{AMBug|49337}}: <tt>get_pcvar_float</tt>() malfunctioned on high numbers.
*Fixed {{amb|78}}: <tt>get_concmdsnum</tt> could return an incorrect result.
*Fixed {{amb|85}}: Tag mismatches on <tt>ShowSyncHudMsg</tt>().
*Fixed {{amb|90}}: <tt>set_native_filter</tt>() did not work in rare cases.
*Fixed {{amb|107}}: <tt>socket_open</tt>() didn't return an error by reference.
*Fixed {{amb|110}}: <tt>socket_change</tt>() could return 1 on certain failures.
*Fixed {{amb|116}}: <tt>DispatchKeyValue</tt>() did not work on worldspawn (entity 0).
*Fixed {{amb|230}}: <tt>radius_damage</tt>() didn't kill players on all mods.
*Fixed {{amb|257}}: <tt>get_user_origin</tt>() mode 4 had false positives.
*Fixed {{amb|343}}: <tt>TFC_ClearModel</tt>() did not function as documented.
*Fixed {{amb|421}}: <tt>get_user_weapons</tt>() could omit a weapon on Day of Defeat.
*Fixed {{amb|437}}: <tt>dod_set_user_kills</tt>() and <tt>dod_set_user_score</tt>() could mess up the scoreboard.
*Fixed {{amb|519}}: <tt>geoip_code[2|3]</tt>() buffer overflowed on error.
*Fixed {{amb|736}}: <tt>find_entity</tt>() was defined twice.
*Fixed a memory leak in <tt>SortCustom1D</tt>().
*Fixed a crash bug in <tt>fwrite_blocks</tt>().

===Natural Selection Additions===
*Added <tt>ns_get_user_team</tt>.
*Added <tt>ns_round_in_progress</tt>.
*Added <tt>ns_get_weapon</tt>.
*Added <tt>ns_takedamage</tt>.
*Added <tt>ns_get_locationname</tt>.
*Added <tt>ns_lookup_title</tt>.
*Added <tt>ns_create_ps</tt> (particle systems).
*Added <tt>ns_spawn_ps</tt>.
*Added <tt>ns_fire_ps</tt>.
*Added <tt>ns_get_ps_id</tt>.
*Added <tt>round_start</tt> and <tt>round_end</tt> forwards.

==Plugin Changes==
*There is no longer a hardcoded limit to the number of admins.
*There is no longer a hardcoded limit to the map list.
*There is no longer a hardcoded limit to the number of "imessages."
*Added {{amb|34}}: There are now plugin command/cvar menus.
*Added {{AMBug|45044}}: amx_banmenu now prints the ban time length.
*Added {{AMBug|43757}}: amx_addadmin now writes a comment with the player's name.
*Added {{AMBug|29353}}: amx_plugins now prints paginated output.
*Added {{AMBug|50742}}: admin.sma now supports prefix based per-map configs.
*Added {{amb|28}}: statscfg.sma can now use translations.
*Added {{amb|30}}: <tt>csstats_rankbots</tt> prevents bots from showing on <tt>/top15</tt>.
*Added {{amb|31}}: plmenu.sma ban and slap options are now configurable.
*Added {{amb|42}}: Added new values for <tt>amx_show_activity</tt>.
*Added {{amb|51}}: amx_vote can now take more than two options.
*Added {{amb|64}}: amx_voteban autodetects whether it should IP ban.
*Added {{amb|307}}: amx_addban now caches the last ten connections.
*Added {{amb|311}}: mapcycle file now ignores .bsp extensions.
*Added {{amb|340}}: amx_ban/amx_banip now display a reason in the activity.
*Added {{amb|427}}: Additional weapons to <tt>dod_[g|s]et_user_ammo</tt>().
*Added {{amb|743}}: plmenu for cstrike has an option to move to spectator.
*Fixed {{amb|29}}: pausecfg.sma did not translate two phrases.
*Fixed {{amb|91}}: miscstats.sma truncated some language translations.
*Fixed {{amb|94}}: amx_psay sometimes sent truncated messages.
*Fixed {{amb|109}}: mapsmenu.sma now checks <tt>mapcyclefile</tt> before reverting to <tt>mapcycle.txt</tt>.
*Fixed {{amb|118}}: amx_help would not list <tt>ADMIN_ADMIN</tt> commands.
*Fixed {{amb|130}}: Various menus did not take <tt>ADMIN_ALL</tt> or <tt>ADMIN_ADMIN</tt> into account.
*Fixed {{amb|183}}: plmenu.sma did not work on Natural Selection.
*Fixed {{amb|196}}: amx_modules did not handle invalid modules properly.
*Fixed {{amb|222}}: cl_rebuy could exploit CS weapon restrictions. This also makes CZ bots obey restrictions.
*Fixed {{amb|228}}: amxmod_compat could cause <tt>set_user_hitzones</tt>() to break.
*Fixed {{amb|350}}: <tt>traceline_set_float</tt> from the AMX Mod Compat layer was broken.
*Fixed {{amb|467}}: <tt>conmotd.txt</tt> is now removed.
*Fixed {{amb|633}}: Immune admins can now target themselves.
*Fixed {{amb|790}}: admin.sma parsed beginning spaces incorrectly in users.ini.
*Fixed a potential exploit in adminslots.sma.
*SQL cvars are now protected.

==Module Changes==
*Fixed {{amb|108}}: IP-based stats no longer include a port when saving.
*Fixed {{amb|503}}: CSX did not set a META_RESULT when paused.