This will be quite an involved readme, but it will be broken into sections. Skip ahead if you know what you want.

THIS WILL NOT WORK WITH VAL AVATAR. I have provided alternate skin packs to allow custom colors into regular MH games. See the downloads section at www.gopostals.com/forum to get them. Also bots are not supported in this mod. If you use them it will cause MH2 to malfunction.

Some personal notes:
In case you have never used this controller you have to understand that in form and function it works much like UTJMH (which was the base for the code). However many issues concerning MH could only be addressed by slipping in a replaced MonsterHunt core that has lots of fixes inserted. It’s not a perfect mod, ideally I’d like to recode MH from the ground up but that would break the maps that exist. Instead I went this route, creating a new gametype that “piggybacks” on existing MH but makes as many of the necessary corrections as I could make without breaking things. It’s pretty thorough and you’ll find a nice selection of options to use. The server log still tosses occasional errors but I squelched as much as I could get. Some maps create access none error lines and there just isn’t anything I can do about it. As always I included source codes so feel free to improve/change/alter as you like. It’s really not that hard and I’d gladly help you out. In fact Nelsona is currently working on a “bot-friendly” release of MH2.

1. Setting up a server (quick start guide)
This mod is run as an actual gametype, *not* a monsterhunt mod. Loading the gametype will load the mod, they are not independent of each other. First add these lines into the unrealtournament.ini:

ServerActors=MonsterHunt2Gold.LinkActor
ServerActors=MonsterHunt2Gold.ServerAdds
ServerPackages=MonsterHunt
ServerPackages=MonsterHunt2Gold

Add this section to the end of your UnrealTournament.ini and make your edits as you desire. The following is simply a copy of my adds, you are welcome to use none of them and replace with anything you like. It’s a good idea to add something about score limits and stats limits so players know. This is just like the normal ServerAdds mod, it’s just embedded into MH2 now. fDelay is how long between pop-in ads are displayed:

//Code start
[MonsterHunt2Gold.ServerAdds]
fDelay=60.000000
iRepeat=1
iGroupSize=2
iAddType=3
bDontWrapList=False
bEnabled=True
cAdminMessageColor=(R=131,G=211,B=255,A=0)
sLines[0]=][ Welcome to MonsterHunt 2 ][
sLines[1]=][ Check here for important information ][
sLines[2]=][ Certain commands can be put into console ][
sLines[3]=][ MUTATE LIGHT     -for a personal lamp ][
sLines[4]=][ MUTATE DARK     -turns light off ][
sLines[5]=][ MUTATE HEALGUN   -spawns a healing gun ][
sLines[6]=][ www.gopostals.com][
sLines[7]=][ Team damage is disabled ][
sLines[8]=][ Personal stats will be saved ][
sLines[9]=][ Have a good time and play fair ][
sLines[10]=][ MUTATE OPEN  -opens any door or mover ][
sLines[11]=][ MUTATE CLOSE   -closes any door ][
sLines[12]=][ If you force doors, it could mess map up ][
sLines[13]=][ Need HEALTH? Hit your "F" key and do feign death ][
sLines[14]=][ A Liandri Corp server ][
sLines[15]=][ If you die you lose 10% of your score ][
sLines[16]=
sLines[17]=
sLines[18]=
sLines[19]=
sLines[20]=
sLines[21]=
sLines[22]=
sLines[23]=
sLines[24]=
//Code end

This mod requires NO other packages aside from the original MH (and the tiny music file I attached). All included mutators and toys are fully contained. Additional mods should be used with extreme care, I have not tested compatibility with very much. If you add mods, it is at your own risk. I do not openly support other mods to be used with MH2Gold. It is VERY server intensive and is subject to problems if other mods are added. 

Sample Mapvote line:

CustomGameConfig[1]=(bEnabled=True,GameClass="MonsterHunt2Gold.MonsterHunt",NewPrefix="MH",mutators="MonsterHunt2Gold.IP2Country,MonsterHunt2Gold.Stats,MonsterHunt2Gold.MH2PlayerLog,MonsterHunt2Gold.RelicDefense,MonsterHunt2Gold.RelicSpeed,MonsterHunt2Gold.RelicStrength,MonsterHunt2Gold.RelicDeath,MonsterHunt2Gold.RelicInvulnerable,MonsterHunt2Gold.RelicRadiation,MonsterHunt2Gold.ShutUp",Settings="")

Sample ActorCLP section:

[ActorCLP.ActorCLP]
Mutators=MapVoteLA13.BDBMapVote
DefaultMap=MH-Cliffs2
DefaultGametype=MonsterHunt2Gold.MonsterHunt

Mod explanations-
MonsterHunt2Gold.IP2Country loads the country text in the scoreboard. You can also use the default “mutate iptocountry” commands.
MonsterHunt2Gold.Stats loads the stats tracking. 
MonsterHunt2Gold.MH2PlayerLog is an "AKA" style mod for tracking players on server.
MonsterHunt2Gold.ShutUp limits the ability of players to spam taunts on the server.
Mods are explained in detail in a later section.

Remember this is an entire gametype. It will list in the MH tab but it is not a normal MH game. Don't try to run this as a mod, it won't work.

2. Gameplay
Play as normal MH. Enjoy the many new toys you have access to. I added a bunch of commands that can be entered into console (the ~ key). Any player who knows the passwords can use these, admin or not.

mutate open    -opens any mover.  
mutate close   -closes any mover
mutate light     -personal light, very handy, never runs out.
mutate dark    -turns it off
mutate healgun   -summons a healing gun, you'll figure it out (alt fire each other :)

Anyone using the mover command will have the action logged to the server. This will prevent abuse. These passwords can be changed in the ini. Just use  "mutate <newpassword>" to make the new one work after you update the ini with your chosen password.

The MHStats ini will track your player stats and can be edited if you feel like removing someone. Stats are updated ONLY at map end so maps not ended will not count. There are two lines in the ini you need to think about: MaxScorePerMap and MapBonus. Max score is what the max stats are you can earn per game. Map bonus is a bonus you get for playing more games. The formula is like this:
Total score= Score + (mapbonus X number of games played). This rewards players who play lots of games and prevents maps like ATAA ruining the leaderboard.

The MH2PlayerList.ini will keep a running tab of all players accessing your server. It makes a nice history file and allows you to see quickly if people are using alias names.

A little side-note: If you really need health RIGHT NOW, you can "feign death" and your health will recover 3X faster than the standard rate. It will return to the normal rate once you stand back up.

3. Controller Enhancements
The alt sniper available in the ini has incredible range, an increased fire rate and a headshot that must be seen to be appreciated (wear a raincoat if you are close by).

 The 2k4 redeemer is a hybrid of the UT redeemer, the nuclear warhead from 2004, and many bits of code I added. The HUD is improved, range to monster is added, in-flight lag is reduced, the rocket will go in very tight spots now, and the shell is really fucking cool too. You can also select how fast you’d like it to travel by altering the included ini file.

The EndGameFun comes when you finish a map and kill every single monster in the map (the monster count on the HUD must read zero). The dancers will spawn so long as there is room for them and I attempted to stop the player from sliding away if gravity pulls him. It’s not perfect but it will help some.

The HUD has lots of good information and is pretty self-explanatory. I removed most of the coloration and it assumes the colors you select for your local HUD.

MH2PLayerLog is pretty much AKA rewritten to be embedded into the mod (used with permission of TheCatcher). Both stats and playerlogs are set to 5000 players. I think that's enough for now. Some AKA mods don’t work with MH but I assure you this one does just fine.

4. INI file explained
[MonsterHunt2Gold.MH2Base]
AmpSpawnTime=300
DeemerSpawnTime=433
HealthAwardTime=515
bUseRandomWeapon=False
bGiveArmor=True       SPAWN WITH ARMOR
bUseRegenAmmo=True
AmmoInterval=2        SMALLER NUMBER IS FASTER, 20 IS VERY SLOW
bUseRegenHealth=True
HealthRegenPerSec=5
MaxRegenHealth=500
MaxHealth=500
HealthRegenPerKill=15
DefaultHealth=100
bUseAntiBoost=True       TRUE ANTIBOOST, NOT EVEN REDEEMERS MOVE YOU
bGhostCarcass=True     KILLED MONSTERS HAVE SEE-THROUGH CARCASS
bHitsounds=True
bAltScoring=True            SCORING IS AWARDED BY DAMAGE YOU DO
bCheckMonsterAttack=True      STOPS MONSTERS FIGHTING EACH OTHER
stopPlayerCollision=True        NO BUMPING OF PLAYERS, HELPS LAG
replaceinvis=True              REPLACES THE INVISIBILTY WITH A MED BOX
VisibleMonsterEnds=True
DoubleJump=True
maxJumps=3
jumpType=2
jumpHeight=1.50
GiveAllWeapons=True           SPAWN WITH LOADED
bServerInfo=Add your message here     ADD YOUR MESSAGE
bDropWeaponsOnDeath=True              PINATA MOD
retainScoreOnDeathPercent=0.75        IF YOU GET KILLED YOU KEEP THIS MUCH SCORE (DEATH PENALTY)
HitVolume=16.000000
bUseSpawnProt=True
SpawnProtDuration=20
UseMHTranslocator=True     NO TELEFRAGGING MONSTERS :)
bFixCrushingMover=False
CommandOpen=open         FORCEMOVER MOD
CommandClose=close
UseAltSniper=True            SPAWN WITH IMPROVED SNIPER
Use2k4Deemer=True       REPLACES THE UT DEEMER WITH MINE
UseLimeLight=True       REPLACES SHITTY FLASHLIGHTS WITH THE LIMELIGHT
HealGunSummon=healgun         SUMMONS THE HEALING GUN
UseMH2JumpBoots=False  REPLACE THE UNREAL1 BOOTS WITH THE UT ONES
MaxDamage=1000   MAXIMUM DAMAGE (AND ALSO SCORE) ANY WEAPON CAN DO WITH ONE SHOT. HERE IS WHERE YOU CAN MAKE YOUR SERVER A 10 BILLION POINT PER GAME ONE IF YOU WANT.
AdjustFactories=False  BUGGY BUT WORKS, SEE BELOW
bCapacity=500            MAX  MONSTERS EACH FACTORY CAN MAKE
ChangeCovertToFalse=True  DETAILED BELOW

[MonsterHunt2Gold.HGPBolt]
HGHealingAmount=20     <-Healing per second from the HealGun

[MonsterHunt2Gold.MH2Rifle]
RifleDamage=500      <-Damage per shot from the MH2 Rifle (Default is 45)

[MonsterHunt2Gold.ShutUp]
MaxMsg=20   <-Max voice taunts per person per game
bReinforce=True  <-True reinforces the ban if the player leaves and returns same match
bPlayerMsg=True  <-Tell the player he is silenced?
MsgToPlayer="You have reached the maximum amount of taunts allowed for this match."
bBroadcast=True  <-Tell everyone that player is silenced
MsgToBroadcast="The voice message capabilities of %Player% have been revoked."
bTeamGames=True   <-Use on team games? (leave this True!)
bDisableTaunts=False  <-Just stops ALL taunts completely all the time

++++++++++++++++++++++++++++++++++++++++++++
**NOTES: Adjust factories: This I'm still trying out. What it does is limit factories to "X" number of monsters. This works fine *BUT* if a trigger is called by completion of the factory, it fails and you are stuck. It's on my to-do list to see if I can work that out.

ChangeCovertToFalse: If you elect to use AdjustFactories you have the option to set this. What it does is force factories to spawn monsters even if they are set to spawn when you aren't looking. Here's an example: You know in MH-Winter when you go down the commode and you are at the waterfall's edge? The slith below will not spawn if you are looking at them. It screws up the whole map. With this setting you will force the monsters to spawn even if they are set not to (and this should always be this way).
++++++++++++++++++++++++++++++++++++++++++++

[MonsterHunt2Gold.MH2ScoreBoard1]
UseCountry=True   TURNS ON/OFF THE COUNTRY FEATURE IN SCOREBOARD

[MonsterHunt2Gold.MH2WarShell]
MissileSpeed=800   SPEED OF THE MH2 MISSILE. DEFAULT IS 600, 3000 IS *VERY* FAST

[MonsterHunt2Gold.MH2MonsterEnd]
EnableDancers=True     ENABLES DANCERS AT MAP END (IF YOU CLEAR *ALL* MONSTERS)

[MonsterHunt2Gold.MH2NaliFruit]
MaxHealth=500

[MonsterHunt2Gold.MH2Health]
MaxHealth=500

[MonsterHunt2Gold.MH2UnrealHealth]
MaxHealth=500

[MonsterHunt2Gold.MH2Bandages]
MaxHealth=500

[MonsterHunt2Gold.MH2SuperHealth]
MaxHealth=500

[MonsterHunt2Gold.MHPoweredMonster]
StrongLevel=5
DrawScaleMultiplier=5
ExcludeMaps[0]=
ExcludeMaps[1]=
ExcludeMaps[2]=
ExcludeMaps[3]=
ExcludeMaps[4]=
***SNIP***
ExcludeMaps[127]=
PowerUpPercent=150.000000
maxMonsterHealth=20000.000000

[Botpack.TeamGamePlus]
bBalanceTeams=False
bPlayersBalanceTeams=False

[Botpack.DeathMatchPlus]
MinPlayers=0
AirControl=0.350000
bChangeLevels=True
bHardCoreMode=True
bMegaSpeed=False
bAltScoring=False
bTournament=False
NetWait=2
RestartWait=5
InitialBots=0

[Engine.GameInfo]
bMuteSpectators=False
bLowGore=False
bVeryLowGore=False
bNoCheating=True
bAllowFOV=False
bExternalBatcher=False
AutoAim=0.930000
GameSpeed=1.0000
MaxSpectators=2
AdminPassword=
GamePassword=
MaxPlayers=10
ServerLogName=server.log
bLocalLog=False
bWorldLog=False
bBatchLocal=False
DemoBuild=0
DemoHasTuts=0
PlayerViewDelay=1.000000
PlayerSpeechDelay=0.300000
PlayerTauntDelay=2.000000
bLogAdminActions=True
LoginDelaySeconds=0.000000
MaxLoginAttempts=2
ActionToTake=DO_KickPlayer
IPPolicies[0]=ACCEPT,*
IPPolicies[1]=
IPPolicies[2]=
***SNIP***
IPPolicies[254]=
IPPolicies[255]=

[MonsterHunt2Gold.MonsterHunt]
maxMonsterHealth=5000.00  IMPORTANT! THIS IS THE NEW CHECK FOR MAX MONSTER HEALTH, SET YOUR MAX AMOUNT HERE TO LIMIT ANY MONSTER IN THE MAP.
bUseTeamSkins=False
MonsterSkill=7
Lives=999
bNoTeamChanges=False
FriendlyFireScale=0.000000
MaxTeams=1
GoalTeamScore=30.000000
MaxTeamSize=10
FragLimit=0
TimeLimit=999
bMultiWeaponStay=True
bForceRespawn=False
bUseTranslocator=False
MaxCommanders=2
bNoMonsters=False
bHumansOnly=False
bCoopWeaponMode=True
bClassicDeathMessages=False
StartUpMessage=Work with your teammates to defeat the monsters!

***LEAVE THIS SECTION ALONE*****
[MonsterHunt2Gold.LinkActor] 

5. Some assorted stuff you should know
MonsterHunt2 is very server intensive. You may not be happy trying to run it from a home server if you have many slots. It likes to have room to breathe and also to have a solid processor with lots of RAM to run it. If your home server has to page file a lot, you won’t like how it feels. If you use a dedicated server or are renting, this is the way to go to play MH. No other public MH controller offers what this has. It’s really a “server in a mod” and you just need to add maps.    

CREDITS
TheDane. A VERY large portion of this came directly from him and his work. He was gracious enough to allow its import into my mod and help me make it function. Best. Guy. Ever.
POTS. My peerless betatester. I wonder if he knows I do things just to see if he will catch them? He does. Always. I hope you are well my friend.
Nelsona for his fixes to my fixes. And my fixes for his fixes of my fixes. And his fixing those…
PaperCoffee for his outstanding work on the logo. I sure wish I had that talent.
And last but not least FeraliDragon for his tireless answers to my questions. Go NW3!!

Thanks guys. Please enjoy yourselves!!!
Kelly
agutgopostal@hotmail.com