Difference between revisions of "SMAC Plugin"

Latest revision as of 21:17, 1 April 2017

This plugin comes as a set of plugins/modules that make it a very useful and very helpful plugin for both administrative and security purposes. On top of helping to identify cheaters, it also guards against several server exploits and issues that are found commonly throughout the Source engine. This plugin has been specifically updated to 0.8.6.1 with most of the modules supporting the current version of ZPS alongside other games as well as having the correct GPL/GNU license headers. This also should work for other games as well, but it has not been tested.

How It Works

The best way to describe how it works is to link the wiki resource for SMAC. It has all the details and information on the plugin modules that are still relevant for its overall function. You can find that here:

http://web.archive.org/web/20150521190758/http://smac.sx/wiki/doku.php

The summary for it would be to say that this plugin helps to mitigate/stop some very common source-based exploits as well as punish users who use exploits and hacks. In short, its a security plugin with administrative capabilities to help manage a server.

Because this is both a security and administrative plugin, it does have the potential to kick/ban users. If set incorrectly, it could prove disastrous, so use this plugin at your own risk! Read the above wiki and understand how the plugin is supposed to work before throwing it into your server! Also, be aware that these plugins are not perfect and some of these plugins might not work correctly for ZPS. See the How to Install Plugin section for details on what plugins are recommended for ZPS.

Code and Plugin Download

Below is the download link and code for the plugin:

• SMAC Plugin

How To Install Plugin

To install the plugins, simply download the files, unzip them, and then copy the addons and cfg folders into your game server's main directory. This will add ALL of the files into your game's addons/sourcemod and the cfg/sourcemod directories. Please be aware that this means all plugins will be installed! If you want to remove/disable any of them, simply delete them or move them into the "disabled" directory in your plugins folder.

The wiki has all the details on the overall functionality, cvars, and function of each plugin. Not all plugins are good/useful for ZPS, but they can be used in other games if it supports Sourcemod. So what is the optimal set of plugins to use for ZPS? I recommend the following plugins:

• smac.smx (You MUST have this plugin in order for SMAC and its associated plugins to work!)
• smac_aimbot.smx
• smac_client.smx
• smac_commands.smx
• smac_rcon.smx
• smac_speedhack.smx

The above plugins all work and have been tested for ZPS. Generally, these plugins are used in other games as well to stop common exploits and hacks in Source games. The plugin also generates its own SMAC configuration file in the cfg/sourcemod directory and each plugin that has cvars associated to it will add its own cvars to the configuration file. I have added a pre-made configuration file for convenience that works as-is, but it will be up to you to know what you'd prefer in terms of settings. You can also let the plugins generate the configuration file and any cvars associated to the plugins, but keep in mind that you will need to restart the server after the configuration file is generated. SMAC also has the ability to integrate with Sourcebans so you can manage bans made by the plugin that way as well. For plugin settings, what they do, and how to adjust them, please read the SMAC wiki pages for more information.

All associated SMAC files have been included in the download. Also, aside from the plugins, I have also included the socket extension, which is also used for SMAC. This is necessary for some parts of the plugin to function properly, so it must be included! Finally, keep in mind that you should use these plugins with caution. Failure to properly configure them could lead to unintentional kicks/bans of players!

This guide also assumes you are using Sourcemod/Metamod, so if you haven't installed those, do so before adding the plugin files to your server! This version of the plugin was compiled on SM 1.7.3, so it should work for Sourcemod 1.7.3 or later. If you need this for an older/specialized version of Sourcemod, you may want to compile the plugin (script files are included) for your version of Sourcemod.

All of this is provided "as is". While this plugin should not cause harm, any harm caused by the plugin, user handling, or anything else Vertigo Gaming and all associated coders are not responsible for it. Use at your own risk!