A map rotation mutation that allows the users to have alot of control of the game. Read below to install
MapVote Version 4.00 beta 11 for Unreal Tournament 2003 Created By BDB (Bruce Bickar) Please visit my web site http://www.planetunreal.com/BDBUnreal You can post questions, problem reports, and comments on the message board/forum. Please check the message board for solutions to problems instead of emailing me directly. Note: This version will ONLY work on a dedicated server (started from the command line) and SinglePlayer (InstantAction). This Version Will NOT work correctly if used on a server started from within the game using the menus, sorry. Installation instructions: =========================== 1. Save MapVote400b11.int, MapVote400b11.u, and MapVoteServer.bat in the \UT2003\System directory. 2. Copy and paste these ini settings into your \UT2003\System\UT2003.ini (at the bottom) ----------------------------------------------------------- [MapVote400b11.MapVote] VoteTimeLimit=70 ScoreBoardDelay=10 bAutoOpen=True MidGameVotePercent=50 MinMapCount=2 RepeatLimit=4 bScoreMode=False bAccumulationMode=False bEliminationMode=False DefaultGameConfig=0 bDefaultToCurrentGameType=True bKickVote=True KickPercent=51 bRestartWithLastMap=False bAnonymousKicking=False MapVoteHistoryType=MapVote400b11.MapVoteHistory1 MapListLoaderType=MapVote400b11.DefaultMapListLoader ; Note: the following GameConfig lines are just examples. You can remove any lines that you dont want or add any ; new ones. See the instruction in the ReadMe.txt file for details. GameConfig=(GameClass="XGame.xDeathMatch",Prefix="DM",Acronym="DM",GameName="DeathMatch",Mutators="",Options="") GameConfig=(GameClass="XGame.xTeamGame",Prefix="DM",Acronym="TDM",GameName="Team DeathMatch",Mutators="",Options="") GameConfig=(GameClass="XGame.xDoubleDom",Prefix="DOM",Acronym="DOM",GameName="Double Domination",Mutators="",Options="") GameConfig=(GameClass="XGame.xCTFGame",Prefix="CTF",Acronym="CTF",GameName="Capture The Flag",Mutators="",Options="") GameConfig=(GameClass="XGame.xBombingRun",Prefix="BR",Acronym="BR",GameName="Bombing Run",Mutators="",Options="") [MapVote400b11.DefaultMapListLoader] bUseMapList=False MapNamePrefixes="DM,CTF,DOM,BR" ; Note: MapListTypeLists are not needed if bUseMapList is set to False. They will be ignored. ; Also, if bUseMapList is set to True and there are no MapListTypeLists MapVote will load maps ; from the default maplists that belong to the GameTypes specified in the GameConfigs. ; The following are just examples and would not be used under this configuration. MapListTypeList=XInterface.MapListDeathMatch MapListTypeList=XInterface.MapListBombingRun ------------------------------------------------------------ You can delete any "GameConfig" lines that you don't want. See the "MapVote INI Settings explaination" section later in this document for details. 3. Add "ServerPackages=MapVote400b11" to your UT2003.ini file in the "[Engine.GameEngine]" section. Example: (* Dont copy this section, yours may be different.) Note: if you had a previous version of MapVote installed be sure to reuse or delete the old ServerPackage entry. ------------------------------------------------------------ [Engine.GameEngine] CacheSizeMegs=32 UseSound=True ServerActors=IpDrv.MasterServerUplink ServerActors=UWeb.WebServer ServerPackages=Core ServerPackages=Engine ServerPackages=Fire ServerPackages=Editor ServerPackages=IpDrv ServerPackages=UWeb ServerPackages=GamePlay ServerPackages=UnrealGame ServerPackages=XEffects ServerPackages=XPickups ServerPackages=XGame ServerPackages=XWeapons ServerPackages=XInterface ServerPackages=Vehicles ServerPackages=TeamSymbols_UT2003 *->ServerPackages=MapVote400b11 MainMenuClass=XInterface.UT2MainMenu ConnectingMenuClass=XInterface.MenuConnecting DisconnectMenuClass=XInterface.UT2NetworkStatusMsg UseStaticMeshBatching=True ------------------------------------------------------------ 4. Start the server from the command line. The mutator name is "MapVote400b11.MapVote" Windows Example: ------------------------------------------------------------ ucc server CTF-Citadel.ut2?game=XGame.xCTFGame?mutator=MapVote400b11.MapVote ------------------------------------------------------------ Note: you can use the example batch file supplied. MapVoteServer.bat *** Linux server require the "-nohomedir" command line option to tell UT2003 to look at the ini settings. Linux Example: ------------------------------------------------------------ ucc server CTF-Citadel.ut2?game=XGame.xCTFGame?mutator=MapVote400b11.MapVote -nohomedir ------------------------------------------------------------ Upgrading from a previous version: ================================== - I would suggest deleting the old version. Delete the MapVote400XX.int and MapVote400xx.U files. - Edit the MapVoteHistory1.ini file and change [MapVote400xx.MapVoteHistory1] to [MapVote400b11.MapVoteHistory1]. This will allow you to keep using the map history data from the previous version. - The GameConfig settings can be copied from the previous versions ini section, BUT the bUseMapList will be ignored and you need to add the Acronym setting to each. MapVote INI Settings explaination: ================================== VoteTimeLimit - A number between 1 and 500. The number of seconds to allow for voting at the end of the game or after a Mid-Game vote. After this time limit has been reached the votes are counted and the map with the highest score wins. Default is 70 ScoreBoardDelay - A number between 1 and 500. The number of seconds to delay before automatically opening the voting window after the end of the current game is reached. This time is given to the players so that they can look at the score board. Default is 10. bAutoOpen - True or False. If true then the voting windows will be automatically opened at the end of each game. If False then the normal cycle maplist is used to select the next map. Players can initiat a Mid-Game vote only. They would have to open the voting window by pressing the MapVote HotKey. Default hotkey is the HOME key. This can be changed on the "Configuration" tab window. Default is True. MidGameVotePercent - A number between 1 and 100. The percentage of players that are required to vote before a Mid-Game vote is initated. Set to 100 to virtually disable Mid-Game voting by requiring all of the players to vote. Default is 50. Note: Mid-Game Voting is semi-disabled if there are only have 2 players unless both players vote. RepeatLimit - A number between 0 and the total number of maps on the server. The number of games to disabe voting for a map after it has been played. Default is 4 Warning: Make sure the RepeatLimit is less than the total number of maps in the First GameConfig list. MapVoteHistoryType - The code class that manages the map history data. This can be set to one of 10 settings. MapVoteHistoryType=MapVote400b11.MapVoteHistory1 MapVoteHistoryType=MapVote400b11.MapVoteHistory2 MapVoteHistoryType=MapVote400b11.MapVoteHistory3 MapVoteHistoryType=MapVote400b11.MapVoteHistory4 MapVoteHistoryType=MapVote400b11.MapVoteHistory5 MapVoteHistoryType=MapVote400b11.MapVoteHistory6 MapVoteHistoryType=MapVote400b11.MapVoteHistory7 MapVoteHistoryType=MapVote400b11.MapVoteHistory8 MapVoteHistoryType=MapVote400b11.MapVoteHistory9 MapVoteHistoryType=MapVote400b11.MapVoteHistory10 The default is "MapVoteHistoryType=MapVote400b11.MapVoteHistory1" MapVoteHistory1 will create a file in the system directory named MapVoteHistory1.ini where the history data is stored. MapVoteHistory2 will create MapVoteHistory2.ini etc... If you run more than one UT server session on the same physical server then change this setting in each ini file so that each UT server session uses a different/unique MapVoteHistoryType. MapListLoaderType - This is a pointer to a code file and code class that is to be used to load the maplist with mapnames. MapVote400b10.DefaultMapListLoader is the default and should not be changes unless you know what you are doing. bScoreMode - True or False, Default is False. Setting this to True will give players move votes based on their score. Example: At the end of a DeathMatch game you have 10 frags and then you vote for DM-Phobos2 then it will place 10 votes for DM-Phobos2. bAccumulationMode - True or False, Default is False. Setting this to True will cause non-winning and unused votes to carry over to the next game. If the map you voted for wins then you will not carry over votes to the next game. If the Map you voted for does NOT win then the ammount of votes you currently have will carry over. Sorry, Currently MapVote does not have the ability to show you the ammount of accumulated votes that you have. That will be added in a future version. bEliminationMode - True or False, Default is False. Setting this to True will disable voting for previously played maps until there are only N enabled maps left in the map list. N is MinMapCount (see below). This is accomplished by incrementing the RepeatLimit after each game. You can use this mode to force players to play all the maps instead of just the popular ones. DefaultGameConfig - (NEW in version b11) - A number from 0 to the number of GameConfig lines - 1. This is an index number that tells MapVote which GameConfig to use when all of the players leave the game. This is only used if bDefaultToCurrentGameType is set to False, otherwise it is ignored. The index starts at 0, so the first GameConfig line in you ini file would be 0, the next would be 1 and so on. bDefaultToCurrentGameType -(NEW in version b11) - True/False. If set to True MapVote will stay on the current GameType (GameConfig) when all players leave the server and it switches to a random map. The random map will be one that has a prefix in the GameConfig.Prefix. Set to False and it will switch to the DefaultGameConfig (above). MinMapCount - A numeric value from 1 to the total number of maps the server. This option is only applicable when bEliminationMode is set to True. It represents the minimum number of enabled maps that will trigger an Elimination Mode MapList Reset. Elimination Mode Maplist Reset is when the all of the maps in the maps list are reenabled for voting. (see bEliminationMode description also) bKickVote - True or False, Default is True. True = Allow players to place kick votes against other players. False = Do not allow players to place kick votes against other players. KickPercent - A numeric value from 1 to 100. Default is 50. The percentage of players that are required to place kick votes against one player before that player is kicked from the server. bAnonymousKicking - True or False, Default is True. True = Does Not includes the Voters name in the broadcasted kick vote message. Ex. A Kick Vote has been placed against PlayerB False = Includes the Voters name in the broadcasted kick vote message. Ex. PlayerA has placed a kick vote against PlayerB bRestartWithLastMap - True or False, Default is False. True = When the server is restarted it will automatically switch to the last played map. False = when the server is restarted it will not switch to the last played map. GameConfig settings explaination: ================================= Note: You can add an infinite number of GameConfig lines in you ini file. GameClass - This is the name of the package and the name the game class separated by a period. Example: "XGame.xCTFGame". Here are the out-of-the-box game classes: DeathMatch is "XGame.xDeathMatch" Team DeathMatch is "XGame.xTeamGame" Double Domiation is "XGame.xDoubleDom" Capture The Flag is "XGame.xCTFGame" Bombing Run is "XGame.xBombingRun" For new games/Mods the gameclass can be found in the *.int file that comes with it. Look for something similar to this: This Example is from the DeathBall.int ==================================================================== Object=(Class=Class,MetaClass=Engine.GameInfo,Name=DeathBall.DB_Deathball,Description="DB|Deathball V1.3b|Deathball.DB_RulesTab|Deathball.DB_MapList|true") ###################### ==================================================================== Example DeathBall GameConfig: GameConfig=(GameClass="DeathBall.DB_Deathball",Prefix="DB",GameName="DeathBall",bUseMapList=false,Mutators="",Options="") Prefix - The MapName Prefixes to associate with this gametype. If you want to list more than one separate each with a comma. This tells MapVote which maps to load in the maplist for this gametype. example: "CTF,DM,DOM,BR" Acronym - Short text acronym or abreviation that will be appended to map names in messages to help identify game type for map. Example: Acronym=MUT - "JoePlayer voted for DM-MapName(MUT)" GameName - This is the name or title of the game type. For example: "Capture The Flag". Note: You can make this anything you like. Example: "Dont Touch My Flag" or "CTF with InstaGib & BigHeads" Mutators - List of Mutators to load with this game type. If more than one separate each with a comma. Example: "MapVote400b11.MapVote,XGame.MutInstaGib,UnrealGame.MutBigHead,UnrealGame.MutLowGrav" If this is set blank ("") then only the current mutators are loaded. WARNING: If you set mutators for any GameConfig you MUST include the base mutators in ALL of the GameConfigs. This does NOT includes MapVote, it will be added automatically. If you leave all of them blank then the base mutators will stay. Mutators available out of the box - UnrealGame.MutBigHead UnrealGame.MutLowGrav XGame.MutInstaGib XGame.MutZoomInstaGib XGame.MutRegen XGame.MutVampire XGame.MutSlomoDeath XGame.MutHeliumCorpses XGame.MutNoAdrenaline XGame.MutQuadJump XWeapons.MutArena XWeapons.MutNoSuperWeapon Options - List of Game configuration Options. If more than one separate each with a "?". Example: "WeaponStay=True?Translocator=True?TimeLimit=5" Some GameOptions available (Note: this is an incomplete list) - GameSpeed, AccessControl, AdminName, AdminPassword, GameRules, GamePassword, AllowThrowing, AllowBehindview, GameStats, DemoRec, Translocator, bAutoNumBots, AutoAdjust PlayersMustBeReady, DMTeam, WeaponStay, QuickStart, RedTeamAI BlueTeamAI, RedTeam, BlueTeam, RedTeamSymbol, BlueTeamSymbol FF, FriendlyFireScale, BalanceTeams Example GameConfig: GameConfig=(GameClass="XGame.xCTFGame",Prefix="CTF",Acronym="CTF",GameName="Dont Touch My Flag",Mutators="MapVote400b10.MapVote,KickIdlersUT2003V1b.KickIdlers",Options="WeaponStay=True?Translocator=True?TimeLimit=15") GameConfig=(GameClass="XGame.xCTFGame",Prefix="CTF",Acronym="CTF",GameName="CTF LowGrav/InstaGib",Mutators="MapVote400b10.MapVote,KickIdlersUT2003V1b.KickIdlers,XGame.MutInstaGib,UnrealGame.MutBigHead,UnrealGame.MutLowGrav",Options="Translocator=False?TimeLimit=5") GameConfig=(GameClass="XGame.xBombingRun",Prefix="BR",Acronym="BR",GameName="Bombing Run",Mutators="MapVote400b10.MapVote,KickIdlersUT2003V1b.KickIdlers",Options="") GameConfig=(GameClass="XGame.xBombingRun",Prefix="BR",Acronym="BR",GameName="BR LowGrav/InstaGib",Mutators="MapVote400b10.MapVote,KickIdlersUT2003V1b.KickIdlers,XGame.MutInstaGib,UnrealGame.MutBigHead,UnrealGame.MutLowGrav",Options="") Default Map List Loader INI Explaination: [MapVote400b11.DefaultMapListLoader] Section ======================================================== Example: [MapVote400b11.DefaultMapListLoader] bUseMapList=True MapNamePrefixes=DM,CTF,DOM,BR MapListTypeList=XInterface.MapListDeathMatch MapListTypeList=XInterface.MapListBombingRun bUseMapList - True or False. If True then the map names are loaded from the MapList that is in the UT2003 ini file. If you configure any "MapListTypeList" settings then it will load from those specific maplists, if not then it will load from the maplists that are associated with each gametype that you configured in the GameConfig settings. (Example: CTF would use the XInterface.MapListCaptureTheFlag maplist.) If False then all available maps (that have the specified Prefixes) are loaded. Example: If the game type is CTF and bUseMapList is True then map names will be loaded for this: (if this was your servers ini file) \UT2003\System\UT2003.ini ============================================================== [XInterface.MapListCaptureTheFlag] MapNum=1 Maps=CTF-Chrome Maps=CTF-Citadel Maps=CTF-December Maps=CTF-Face3 Maps=CTF-Geothermal Maps=CTF-LostFaith Maps=CTF-Magma Maps=CTF-Orbital2 ============================================================== MapNamePrefixes - List of Map Prefixes to use to filter the maps in the maps directory when loading map names into the mapvote maplist. This is ignored when bUseMapList is True MapListTypeList - Name of a map list to read map names from. This is ignored if bUseMapList is False. To list more than one repeat the line. See example above. UT2003 MapLists: - XInterface.MapListDeathMatch - XInterface.MapListTeamDeathMatch - XInterface.MapListCaptureTheFlag - XInterface.MapListDoubleDomination - XInterface.MapListBombingRun MapVote Hot-Key setting: ======================== A MapVote Hot-Key is a key on your keyboard that you can press that will open the voting window. The Default MapVote Hot-Key will show on your HUD when you join the server (bottom left). If you have not configured a key then it will choose one that is not in use. If the HOME key is not in use then it will be used first, otherwise it searches the alphabetic keys (A,B,C,D,E,F,etc...) util it finds an unused one. If there are no unused keys then you will have to use the "mutate mapvote menu" console command to open the voting window. The current MapVote Hot-Key setting will be displayed to the left of the players HUD (just above the MapVote Logo) for 10 seconds after joining the server as a reminder. You can change the Hot-Key in the MapVote window in the "Configuration" Tab. Just select the key you want to use by scrolling the list and clicking the key you want. Also pressing the desired keyboard key it will auto-select that key in the list. Then click the "Set/Save" button. The HotKey setting is written to your \UT2003\System\User.ini file: example: ----------------------------------- [MapVote400b11.MapVoteInteraction] MapVoteHotKey=IK_B ----------------------------------- Note: As a safty precaution, you can not set a key that is already registered (bound) to another function. (The key bind must be blank). This was done because too many players accidentally bound the hotkey to a key that was used for some other critical function and then they blamed MapVote because it no longer worked. You can also modify the HotKey setting by editing your User.ini file (when UT2003 is not running): (Note: It is NOT required to edit your user.ini file to change the hotkey, use the Config window.) ----------------------------------- [MapVote400b11.MapVoteInteraction] MapVoteHotKey=<KeyName> ----------------------------------- Replace <KeyName> with one of these values below: --------------------------------------------------- IK_MiddleMouse IK_Backspace IK_Tab IK_Enter IK_Shift IK_Ctrl IK_Alt IK_Pause IK_CapsLock IK_Space IK_PageUp IK_PageDown IK_End IK_Home IK_Left IK_Up IK_Right IK_Down IK_Select IK_Print IK_Execute IK_PrintScrn IK_Insert IK_Delete IK_Help IK_0 IK_1 IK_2 IK_3 IK_4 IK_5 IK_6 IK_7 IK_8 IK_9 IK_A IK_B IK_C IK_D IK_E IK_F IK_G IK_H IK_I IK_J IK_K IK_L IK_M IK_N IK_O IK_P IK_Q IK_R IK_S IK_T IK_U IK_V IK_W IK_X IK_Y IK_Z IK_NumPad0 IK_NumPad1 IK_NumPad2 IK_NumPad3 IK_NumPad4 IK_NumPad5 IK_NumPad6 IK_NumPad7 IK_NumPad8 IK_NumPad9 IK_GreyStar IK_GreyPlus IK_Separator IK_GreyMinus IK_NumPadPeriod IK_GreySlash IK_F1 IK_F2 IK_F3 IK_F4 IK_F5 IK_F6 IK_F7 IK_F8 IK_F9 IK_F10 IK_F11 IK_F12 IK_NumLock IK_ScrollLock IK_LShift IK_RShift IK_LControl IK_RControl IK_Unicode IK_Semicolon IK_Equals IK_Comma IK_Minus IK_Period IK_Slash IK_Tilde IK_LeftBracket IK_Backslash IK_RightBracket IK_SingleQuote -------------------------------------------------------- The keybinder in MapVote actually does bind "mapvotemenu" to the key you select but this is just used as a place holder, the "mapvotemenu" console command does not actually do anything.' The actual key press detection is done with "Interaction" code that is plugged into the console code. Also, you can now open the MapVote window using the console command MUTATE MAPVOTE MENU. Client Side INI Settings: ========================== Example: [MapVote400b11.MapVoteInteraction] MapVoteHotKey=IK_B bShowLogo=True LogoScale=0.400000 LogoX=40 LogoY=375 - bShowLogo - set to False to prevent MapVote from displaying the MapVote Logo when you join a game. NOTE: this can be changed in the Configuration window also. - LogoScale - This is the scale used when drawing the logo on the HUD. Set to 1 for normal image size, or 0.4 for reduced size. Range from 0.0 to 100.0 - LogoX - This is the Horizontal location of the upper left corner of the logo on the HUD. Note: positions are scaled t0 640 x 480 regardless of current resolution. - LogoY - This is the Vertical location of the upper left corner of the logo on the HUD. Note: positions are scaled t0 640 x 480 regardless of current resolution. MapVoteDebug Logging: ===================== By default MapVote will Log all debug log data to the log file on the server. To turn this off so that your log file will stay smaller add "Suppress=MapVoteDebug" to the UT2003.ini file under the "[Core.System]" section. If you start having any types of server problems that you think maybe related to MapVote, please turn MapVoteDebug back on by deleting Suppress=MapVoteDebug from the ini file before contacting me about the problem. Per-Map Mutators and GameOptions: ================================= Warning: This is a new feature and therefore has only been tested with a small number of mutators. You could see certain side effects when combining diffent custom made mutators. This version of MapVote now has Per-Map mutators and gameoptions capablities. Note: The per-gametype mutators and game options will be added to the per-map mutators and game options. There are two ways to config this: 1. Edit the MapVoteHistory1.ini file and add mutators and gameoptions beside each map name. 2. Use the Map cycle list in the ini file and add the mutators and gameoptions. (This method was only added to satisify users that are already using this method.) Method # 1 ========== 1. The first time a UT2003 server is started with MapVote it will write-out all of the mapnames to MapVoteHistory1.ini file. So, Start your server with MapVote once and then stop it. 2. Edit the MapVoteHistory.ini file with a text editor Example: --------------------------------------------------------- [MapVote400b11.MapVoteHistory1] LastMapIndex=15 H=(M="BR-Anubis",P=1,S=10,G="",U="") H=(M="BR-Bifrost",P=1,S=15,G="",U="") H=(M="CTF-Chrome",P=5,S=1,G="WeaponStay=True?Translocator=True?TimeLimit=5",U="XGame.MutZoomInstaGib,XGame.MutSlomoDeath") H=(M="CTF-Citadel",P=0,S=5,G="",U="") H=(M="CTF-DE-ElecFields",P=0,S=5,G="",U="") H=(M="CTF-DE-LavaGiant2",P=0,S=5,G="",U="") H=(M="CTF-December",P=0,S=5,G="",U="") H=(M="CTF-Face3",P=2,S=3,G="WeaponStay=False?Translocator=False?TimeLimit=10",U="XGame.MutQuadJump,UnrealGame.MutLowGrav") H=(M="CTF-Geothermal",P=1,S=2,G="WeaponStay=False?Translocator=False?TimeLimit=5",U="XGame.MutNoAdrenaline,XGame.MutHeliumCorpses") H=(M="CTF-Lostfaith",P=0,S=5,G="",U="") H=(M="CTF-Magma",P=1,S=12,G="WeaponStay=True?Translocator=True?TimeLimit=5",U="UnrealGame.MutLowGrav") H=(M="CTF-Maul",P=0,S=5,G="",U="") H=(M="CTF-Orbital2",P=0,S=5,G="",U="") H=(M="DM-Insidious",P=1,S=7,G="",U="") H=(M="DOM-Core",P=1,S=10,G="",U="") H=(M="DOM-Ruination",P=1,S=14,G="",U="") --------------------------------------------------------- Note: MapNames have to be listed in alphabetic order. Undesirabled results will occure if you add a map in the wrong order. M = MapName P = PlayCount (number of times the map has been played) S = Sequence (the sequence that the map was played. Eg. 1 is the last map that was played) G = Game Options (game options that you want applied to this map) U = mUtators (mutators that you want added to this map when played) Sorry about the short names. I wanted to keep this file small to prevent I/O related performance problems. To add mutators to a specific map: 1. Find the map in the list 2. Insert the mutator(s) names into the "" beside the U option. If there is more than one mutator separate each with a comma. Example: U="XGame.MutZoomInstaGib,XGame.MutSlomoDeath" Note: It is NOT nessessary to add MapVote400b11.MapVote. MapVote will add it self automatically now. To add game options to a specific map: 1. Find the map in the list 2. Insert the gameoptions along with their setting value into the "" beside the G option. If there is more than one separate each with a Question Mark "?". (Sorry, maybe the next version will allow commas for more consistancy) Example:G= "WeaponStay=False?Translocator=False?TimeLimit=10" Warning: During testing I discovered that if you go from a map that has per-map mutators to a map that has NO per-map mutators that the previous map's mutators will be kept active. So, You might want to add mutators to each and every map to prevent this. The same probably goes for GameOptions also. Managing Per-Map Settings via in game: -------------------------------------- You can use the following two console command to manage per-map mutators and game options while in-game and logged in as an administrator. - This command will show you the current mutator and option settings for CTF-Face3. MUTATE MAPVOTE GET CTF-FACE3 - This command will set the mutators for CTF-Face3 to ZoomInstagib and Slomo death and the game options to WeaponsStay and turn on translocators. MUTATE MAPVOTE SET MAPNAME=CTF-FACE3 MUTATORS=XGame.MutZoomInstaGib,XGame.MutSlomoDeath OPTIONS=WeaponStay=True?Translocator=True Method # 2 ========== 1. Edit your UT2003.ini file (or server specified ini) 2. Find the MapList for the game type you are using. Example: ---------------------------------------------------------------- [XInterface.MapListCaptureTheFlag] MapNum=1 Maps=CTF-Chrome?Game=XGame.xCTFGame?mutator=XGame.MutZoomInstaGib,XGame.MutSlomoDeath?WeaponStay=True?Translocator=True?TimeLimit=5 Maps=CTF-Magma?Game=XGame.xCTFGame?mutator=UnrealGame.MutLowGrav?WeaponStay=True?Translocator=True?TimeLimit=5 Maps=CTF-Face3?Game=XGame.xCTFGame?mutator=XGame.MutQuadJump,UnrealGame.MutLowGrav?WeaponStay=False?Translocator=False?TimeLimit=10 Maps=CTF-Geothermal?Game=XGame.xCTFGame?mutator=XGame.MutNoAdrenaline,XGame.MutHeliumCorpses?WeaponStay=False?Translocator=False?TimeLimit=5 Maps=CTF-Citadel Maps=CTF-December Maps=CTF-Lostfaith Maps=CTF-Maul Maps=CTF-Orbital2 Maps=CTF-DE-ElecFields Maps=CTF-Chrome ---------------------------------------------------------------- 3. Append mutators and GameOptions beside each mapname in the following format: Maps=<mapname>?Game=<gameclass>?mutators=<mutator list>?<gameoption1 name>=<gameoption1 setting>?<gameoption2 name>=<gameoption2 setting> Example: Maps=CTF-Magma?Game=XGame.xCTFGame?mutator=UnrealGame.MutLowGrav?WeaponStay=True?Translocator=True?TimeLimit=5 4. In the MapVote GameConfig line, set bUseMapList to True. Example: GameConfig=(GameClass="XGame.xCTFGame",Prefix="CTF",GameName="Capture The Flag",bUseMapList=True,Mutators="",Options="") When the server is started, MapVote will read the maplist from the ini file and parse the MapName, Mutators, and GameOptions out and store them in the MapVoteHistory1.ini file. Known Bugs/Problems: ===================== - Intermittantly when connecting to the server or when switching between maps the player will connect but not be able to enter the game. Increase the ConnectionTimeout value from the default of 15 to 30 (or higher) in the UT2003.ini under the "[IpDrv.TcpNetDriver]". - If you configure too many mutators and/or options with both the GameConfig and the per map setting then you may experience players who can not connect to the server after a map wins and it switches to the next map. I'm told that the limit is 485 characters. To avoid this avoid using the Options when not nessessary. Change the setting in the ini file under the gametype instead. Questions & Answers: ===================== Q: What do the number beside each mapname mean ?: A: The first number is the Sequence. (The number of previous games that the map was played. 1 being the current map, 2 the previous map, 3 the map before that etc..... The second number is the total number of times the map has been played. Q: When will the next release of MapVote be ? A: When it is done. (Dont ask) Trouble Shooting: ----------------- Q: I've installed MapVote and the voting window does Not open. A: It is critial that you follow the installation instructions containted in this file. Make sure you have added "ServerPackages=MapVote400b10" to your UT2003.ini file. Also, if you are running Linux you must add "-nohomedir" to the command line UCC server startup script. Q: Intermittantly when connecting to the server or when switching between maps the player will connect but not be able to enter the game. A: Try increasing the ConnectionTimeout value from the default of 15 to 30 in the UT2003.ini under the "[IpDrv.TcpNetDriver]". Q: When Switching from one gametype to another the games settings (example: GoalScore) stays the same. A: Do not specify game config options in the command line parameters for UCC. Also, Do not start the server via the UT2003 menus. The settings specified in the menus will override the default settings Q: MapVote will not let me vote for the last couple of maps that have been played on my server. How do I make it not do that ? A: Change the RepeatLimit setting in the INI file to zero. Eg. RepeatLimit=0 Q: I'm having a problem with MapVote. What should I do ? A: Re-read this whole document and make sure there isnt a misconfiguration. Also check your servers log file. Then post the details of your problem to my message board. There is a link on the left of my webpage (http://www.mapvote.com) Please post your MapVote configuration settings from your ini file and the Command line parameters used to start the server (eg. UCC server map?game=blahblah....) and a snipet from the Log file if appropriate. Version History: ---------------------------------------------------------------- 4.00 b6 - First publicly released version. 4.00 b7 - Added kick voting. - Added Score, Accumulation, and Elimination voting modes. - Added an "About MapVote" window. - Fixed a compatiblity problem with unpatched clients that was causeing crashes. - Made the MapList and GameConfig replications more efficient. - Fixed a bug that prevented the removal of a players MapVoteReplicationInfo object when the player disconected a server that has bots. - Added the display of the MapVote HotKey setting on the players HUD (just below the crosshair) for 20 seconds after the player joins the server. - Added the options to have the server automatically travel to the last played map when the server is restarted. - Added a configuration option for Anonymous kicking. - fixed a array diminsion bug in the MapList loading code that cause "Accessed None" log errors when using bUseMapList option. - Added safe gaurds for infinite loops in the maplist loading code. - Added Admin voting. If you are logged in as Admin then your votes will win automatically (Maps and Kicking). Admins can not be kicked and they can also vote for eliminated maps. - Fixed a problem that cause the old version of the MapVote window to open instead of the new version when you connect to different servers with differing versions of MapVote. - Fixed the Font size problem with different screen resolutions. - Fixed the Disabled icon size problem with different screen resolutions. 4.00 b8 - Fixed compatiblity problem that caused unpatched UT2003 clients to crash when using the Set/Save button in the Configuration window. - Added a new MapVote Logo image to the HUD that displays for 10 seconds after joining the server. Thanks to Rival*Q for creating the Logo. Also, Thanks to Major_Wilson for helping. - Decreased the amount of time that the logo and the MapVote HotKey reminder display on the HUD from 20 to 10 seconds. - Replaced the picture of me on an ATV in the "About" tab window with the new MapVote Logo. (Trying to keep the size of the file small.) - Fix the HotKey binder so that you can Re-Set the same previous key. This problem was preventing the player from setting the HotKey when connected to a server with a new version of MapVote. - Replaces the GameTypes combo list box with a button. GameTypes are now listed in the main MapList. When you click a game type in the list the maplist is cleared and loaded with mapnames for the selected game type. You can click the GameTypes button at the top to select a different gametype. - Moved server RestartWithLastMap detection to before the writing of the pretty box to the log so that it doenst look like a mid-mapvote load crash when it server travels to the last map. - Fixed the problem with bRestartWithLastMap that prevented the use of admin initiated server travels (via webadmin or console commands). - Added message sending recalling, just hit up or down arrow to cycle thru previously sent messages. - Added more MapVoteHistory Classes, 10 of them, So you can run 10 UT servers on one physical server and have each keep separate history data. - Added an invalid RepeatLimit safeguard check. If RepeatLimit is set higher than or equal to the number of maps for the first GameType then it will restet it to 0. - Fixed Admin Double-Clicking disabled mapname in list to force vote. - All MapVote messages are now sent via the standard GameInfo->BroadcastHandler, so other message mods/mutators should get them. - Pressing the Esc key will now close the voting window. - Added the ability to pass console commands thru the message box. In the message text box enter CMD then the console command you want to execute. MapVote will send the command to the console. - Changed the MVRI array index value from the PlayerID to just an incremented number. This was done because I discovered that spectators do not get a PlayerID assigned to them, which resulted in the inablity to kick them. You should now be able to kick spectators. - Sepectators can open the voting window but can not vote. However, Admins that are spectators can vote. - Modified MapVoteHistory. * Added per Map Mutators and Game Option variables (G and U). * removed some obsolete functions * Added PlayMap function * Per-Map Mutators and GameOptions are parsed from map list mapname (if bUseMapList = True) and Stored in MapVoteHistory on start up of each game. - Added "Mutate MapVote Set" and "Mutate MapVote Get" commands for admins to manage per-map settings. - Fixed the disconnection problem when closing the MapVote window with the 2192 patch. - MapVote will added it-self to the Mutators string for the next map if it is not already listed. - Added bDebugLog config setting to the MapVoteReplication object. It is defaulted to false and therefore does not log MapVoteDebug information from the Replication oject. (this was the game types and map names being replicated to each player that used to get written to the log file.) 4.00 b9 - Fixed the bug that was introduced in b8 that caused MapVoteHistory to incrementing the sequence of unplayed maps and cause all maps to be unvotable. - Moved MapVote Logo down on HUD so that it doesnt cover the MOTD. 4.00 b10 - Reduced the size of the Logo and moved it to an unused location on the screen. Also made the location and size modifable on the client side via user.ini settings and reduced the the amount of time it is displayed to 5 seconds. - Added bShowLogo client side configuration variable and Check box on Config tab to change it. Allows players to turn off the MapVote Logo. - Fixed failed server travel (because of bad map) inifinite loop problem when bRestartWithLastMap=True. - Player list box no longer contains Admins - Fixed Top 10 List click event. It now properly selects the correct gametype, map, and makes the map selection visible in the maplist when you click a map name in the Top 10 list box. - Map names are now sorted in alphabetic order on the client side in the map list box. - The Kick Voting tab is now removed if Kick voting is disabled (bKickVote=False) - The default HotKey is no longer set to the home key. If you do not have a key set or bound it will search keys A - Z for an unused key and automatically set it to the first available. If no available keys are found then it does not set any default. - Added "Mutate MapVote Menu" console command for opening the MapVote window. Alternative in above case were no available keys are found. Note: Clients and server must be patched to 2153 or higher for this to work. - It will now use the HotKey setting from the previous version so you dont have to reconfigure the key everytime there is a MapVote upgrade. - Added Acronym variable to GameConfig settings which will be appended to map names in messages to help identify game type for map. Example: Acronym=MUT - "JoePlayer voted for DM-MapName(MUT)" - Added support for RoAR UT2k3Assault game type. Doenst open the voting window at the end of the 1st half of the game. - Change GUI background from transparent to the background image from the InstantAction menu. - Added a message list box, which changes its width automatically. If the "Say" text box or the message listbox has focus then the listbox will expand to the right moving the Top10List up over the Map Screen shot image. Clicking the Map list box will cause the message listbox to reduce its width bringing the top10list back down. The message list box will hold the last 10 messages sent. - Map list is now loaded by a maplist loader. Independant from the Game types. No more duplicated map names. - Moved bUseMapList from the GameConfig ini settings and Default Maplist loader. - Prefix settings can now have multiple prefixes separated by commas. 4.00 b11 - Fixed bug that prevented players from changing their votes. (could only vote once) - Fixed bug that cause the server to switch to the first map in the list (usually DM-1on1-Crash) when all player left the server. - Fix the bug that prevented the loading of mapnames if bUseMapList=False and MapNamePrefixes has only one Prefix. - Removed unnessessary call to GetDefaultMap function - Moved the display position of the HotKey setting to above the Logo on the HUD so that it could be seen easier. Also increased the logo display time back to 10 seconds to make sure players see their HotKey setting. - Changed the default HotKey back to HOME key. If HOME key is being used for something else then it will search for an unused key. - Double clicking the Top10 Map ListBox will submit a vote now. - Added DefaultGameConfig and bDefaultToCurrentGameType to configuration. * DefaultGameConfig is a number that corresponds to the GameConfig you want the server to default to when all players leave. 0 is default. Does NOT apply when bDefaultToCurrentGameType=True. * bDefaultToCurrentGameType can be True or False. Set to True and the server will change to a map belonging to the current GameConfig instead of the DefaultGameConfig when all players leave. - Added additional code for choosing default maps/gametypes when all players leave the server. 1. Randomly choose map for default gametype, map must be enabled and have a prefix that belongs to the default GameConfig. 2. If after 100 attempts it doesn't find a matching map then it will scan from the top of the map list util it finds a map that is enabled and has a prefix that belongs to the default GameConfig. 3. If that fails (Elimination mode probably), then it scans the map list from the top and finds the first enabled map. It then sets the gametype to the first GameConfig that has the same prefix as the map. - Modified network replication for MapVoteReplicationInfo class. * Added bNetInitial to variable replication statements * Change NetPriority from 3 to 1 * Change NetUpdateFrequency from the default of 10 to 1 Thanks To: Rival*Q for making the MapVote Logo image Major_Wilson for helping with the MapVote Logo image [CTCR]TheCatcher coding help (End of game code and more), and for setting up a test server. [CTCR]Nemisis for providing a server for testing and new web site www.mapvote.com. Everyone else who had downloaded and installed these beta versions of MapVote. Copyright / Permissions ----------------------- Copyright Bruce D. Bickar 2003 Authors may NOT use code from this package with out my permission. You are NOT allowed to commercially exploit this release, i.e. put it on a CD or any other electronic medium that is sold for money without my explicit permission! You MAY distribute this release through any electronic network (internet, FIDO, local BBS etc.), provided you include this file and leave the archive intact.
There are no comments yet. Be the first!