Extendable SuperHero Mod
Install Instructions

Introduction

Hope Page: http://shero.rocks-hideout.com

Download Updates and Extras Here

Extract the superhero zip package anyplace on your computer, just so you know where you put it. Make sure you are extracting with the folder structure, this is on by default in most unzipping software. If after it is extracted all the files are in one folder then it did NOT extract with the folders.

The default settings for SuperHero allow a maximum of 20 levels and 100 heroes. In the past there was no way to have more than 20 levels, now there is. If you need to change these settings the plugin must be recompiled to support it. Please see the compiling documentation. See the Extras section for info on the sample ini for 20 levels.

New Installation

First thing that must be done is installing AMX and MetaMod
AMXMod Downloads | AMXMod Documentation

Please read the AMX documentation and have a working installation of AMX before attempting to install superhero.

Once AMX is fully working upload / copy the entire contents into you addons/amx folder except you do not need to copy the contrib folder. For AMX 0.9.9+ make sure that the folder "shero" is created inside the config folder or the plugin will error out and not work correctly.

Edit the plugins.ini inside the config folder (plugins folder for AMX 0.9.8a). You need to add some things to the bottom to load superhero which are shown in the block below. Don't think you are done after this step, keep reading to see how to enabled extra modules in AMXModX that superhero requires.

// ---------------------- START SUPERHERO PLUGINS -------------------------------
 
//To save XP to the VAULT file (default)
superheromodvault.amx
 
//To save XP to a mysql database (uncomment this and comment out the vault plugin) 
//superheromodmysql.amx
 
//Add these lines to enable all the stock heroes 
sh_anubis.amx
sh_aquaman.amx
sh_batman.amx
sh_bomberman.amx
sh_captaina.amx
sh_cyclops.amx
sh_daredevil.amx
sh_dazzler.amx
sh_dracula.amx
sh_flash.amx
sh_hobgoblin.amx
sh_hulk.amx
sh_humantorch.amx
sh_ironman.amx
sh_kamikaze.amx
sh_magneto.amx
sh_mystique.amx
sh_nightcrawler.amx
sh_punisher.amx
sh_skeletor.amx
sh_spiderman.amx
sh_superman.amx
sh_windwalker.amx
sh_wolverine.amx
sh_xavier.amx
sh_zeus.amx
 
// ---------------------- END SUPERHERO PLUGINS -------------------------------

Upgrade Existing Installation

Upload the contents of the plugins folder into your existing plugins folder, overwriting any existing files. If CVARS were added or changed you can look in the shconfig.cfg in this package and see the changes / additions.

Extra Modules / Plugins

* The "contribs" folder is a separate download

Example superhero.ini for 20 levels - Located in the contribs folder. Just place this file in your amx/config/shero (amx for AMX 0.9.8a) folder overwriting the existing one and you should have 20 levels available on the server when it next changes maps.

Monster - The skeletor hero needs this module to spawn monsters on campers. Look in the contrib folder and find the monster zip file. Extract this into your mod folder (cstrike) and it will put all the files in their places. It should make a folder in addons called "monster". Edit the metamod plugins.ini and add the following lines to the end of it. This will load the correct plugin for linux or widows systems.

;Monster Mod
win32 addons/monster/dlls/monster_mm.dll
linux addons/monster/dlls/monster_mm_i386.so 

VexdUM (AMX 0.9.9+ ONLY) - for superhero this module must be enabled. Edit the modules.ini in the config folder and uncomment the line to load the Vexd module. It should look something like this when enabled.

; Vexd Util.
VexdUM_mm.dll
VexdUM_mm_i586.so

Also this module must be declared in the plugins.ini for metamod. Open the plugins.ini file for metamod and add this to the bottom of it. NOTE: This may already be there but commented out, make sure it is uncommented for it to be enabled.

; Vexd Utilities (AMX module)
win32 addons/amx/modules/VexdUM_mm.dll
linux addons/amx/modules/VexdUM_mm_i586.so

VexdUM / xtrafun (AMX 0.9.8a ONLY) - a lot of the stock heroes require one of these extra modules, and the core mod itself now needs VexdUM. Look in the contrib folder and there is a zip file for each of these. Extract the *.dll and *.so files into the "dlls" folder for amx. Edit the modules.ini file in the amx folder and add the following lines. This will load the correct module for linux or windows systems.

;VexdUM
addons/amx/dlls/VexdUM_mm.dll
addons/amx/dlls/VexdUM_mm_i686.so
 
;xtrafun
addons/amx/dlls/xtrafun_mm.dll
addons/amx/dlls/xtrafun_mm_i686.so

MySQL Instructions

If you are using the mysql saving method you will want to import the shero_mysql_install.sql script (in contrib folder) into your database. You should edit it to reflect the correct database name and username for your setup. If you need to ask about how to do this then you should not be using mysql saving, stick to the vault.

Enable the "superheromodmysql.amx" and disable the vault saving plugin as shown in the example plugins.ini entries above in the New Install instructions.

Edit the modules.ini for AMX and enable the mysql module, it should look like this when enabled. (Sample is for AMX 0.9.9+)

;MySQL Support
mysql.dll
mysql_i586.so

Edit the shconfig.cfg to enable and set the mysql cvars so SuperHero knows how to connect to the database. If nothing is set for those cvars superhero will use the amx mysql settings that are used by the admin_mysql plugin.

Once you have all this done you will need to STOP your server and restart it for the mysql AMX module to load correctly.

Make sure its Working

There are a few commands to make sure everything is loaded correctly. They must be run in the server console or in rcon via HLSW (or similar software). These commands will NOT work the same with the in game console unless it is a listenserver because then the server console is actually the same as the in game console.

Command:

meta list

Example Output:

Currently loaded plugins:
      description      stat pend  file              vers      src  load  unlod
 [ 1] AMX              RUN   -    amx_mm.dll        v0.9.7    ini  ANY   ANY
 [ 2] Monster          RUN   -    monster_mm.dll    v3.00.00  ini  Chlvl Chlvl
 [ 3] CS STATS         RUN   -    csstats_mm.dll    v0.9.7 (  cmd  ANY   ANY
 [ 4] FUN              RUN   -    fun_mm.dll        v0.9.8    cmd  ANY   ANY
 [ 5] Vexd Util. Modu  RUN   -    vexdum_mm.dll     v0.2.0.7  cmd  ANY   ANY
 [ 6] XtraFun          RUN   -    xtrafun_mm.dll    v1.2      cmd  ANY   Pause
6 plugins, 6 running

Command:

amx plugins

Example Output:

 [ 23] SuperHero Mod      1.17.1   {HOJ}Batman/AssK  superheromodvau  running
 [ 24] SUPERHERO Anubis   1.17     AssKicR/JTP10181  sh_anubis.amx    running
 [ 25] SUPERHERO Aquaman  1.17     AssKicR/Lazy/JTP  sh_aquaman.amx   running
 [ 26] SUPERHERO Batman   1.17     {HOJ} Batman/JTP  sh_batman.amx    running
 [ 27] SUPERHERO Bomberm  1.14.4   AssKicR           sh_bomberman.am  running
 [ 28] SUPERHERO Captain  1.14.4   {HOJ} Batman      sh_captaina.amx  running
 [ 29] SUPERHERO Cyclops  1.14.4   AssKicR/Batman    sh_cyclops.amx   running
 [ 30] SUPERHERO Daredev  1.14.4   {HOJ} Batman      sh_daredevil.am  running
 [ 31] SUPERHERO Dazzler  1.14.4   {HOJ} Batman      sh_dazzler.amx   running
 [ 32] SUPERHERO Dracula  1.14.4   {HOJ} Batman      sh_dracula.amx   running
 [ 33] SUPERHERO Flash    1.14.4   {HOJ} Batman      sh_flash.amx     running
 [ 34] SUPERHERO Hobgobl  1.14.4   {HOJ} Batman      sh_hobgoblin.am  running
 [ 35] SUPERHERO Hulk     1.14.4   {HOJ} Batman      sh_hulk.amx      running
 [ 36] SUPERHERO Human T  1.17     {HOJ} Batman/JTP  sh_humantorch.a  running
 [ 37] SUPERHERO Ironman  1.14.4   {HOJ} Batman      sh_ironman.amx   running
 [ 38] SUPERHERO Kamikaz  1.17     AssKicR/JTP10181  sh_kamikaze.amx  running
 [ 39] SUPERHERO Magneto  1.14.4   AssKicR           sh_magneto.amx   running
 [ 40] SUPERHERO Mystiqu  1.14.4   {HOJ} Batman      sh_mystique.amx  running
 [ 41] SUPERHERO Nightcr  1.14.4   {HOJ} Batman      sh_nightcrawler  running
 [ 42] SUPERHERO Punishe  1.14.4   {HOJ} Batman      sh_punisher.amx  running
 [ 43] SUPERHERO Skeleto  1.14.4   {HOJ} Batman      sh_skeletor.amx  running
 [ 44] SUPERHERO Spiderm  1.14.4   {HOJ} Batman      sh_spiderman.am  running
 [ 45] SUPERHERO Superma  1.14.4   {HOJ} Batman      sh_superman.amx  running
 [ 46] SUPERHERO Wind Wa  1.14.4   AssKicR           sh_windwalker.a  running
 [ 47] SUPERHERO Wolveri  1.17     {HOJ}Batman/JTP1  sh_wolverine.am  running
 [ 48] SUPERHERO Xavier   1.14.4   {HOJ} Batman      sh_xavier.amx    running
 [ 49] SUPERHERO Zeus     1.14.4   {HOJ} Batman      sh_zeus.amx      running

If anything is in "BAD" or "bad load" status then something is wrong, look for errors when the server starts to try and solve the problem. A "bad load" will ALWAYS generate at least one error suring server startup. If the plugin you are trying to load does not show up anywhere in the list you did not add it to the plugins.ini. If you still need help post the EXACT ERROR MESSAGE in the Tech Support section of the forums.

If you cannot see the error in the console because it closes you need to enable server logging. See this FAQ entry to find out how.

Also you should read this for help with installing plugins: AMXMod Documentation