add files

Help/MapVoteULv2_3ReadMe.txt

@@ -0,0 +1,174 @@
+=========================================================================================
+Map Vote Ultimate v2.3 for UT by Deepak O V, SpEcTra_7 & Sektor2111 (admin@ultimateut.tk) 
+=========================================================================================
+
+Release Date 22/04/2016
+
+Map Vote Ultimate needs 1024 X 768 or more resolutions for fitting column width on the screen.
+
+What is Map Vote Ultimate v2.3? 
+===============================
+Map Vote Ultimate is a Map vote Mutator that allows the players to vote for the next map being played
+
+Main Features:
+==============
+
+- Voting for up to 4096 maps
+- 8 Customizable Map Lists+
+- Customizable background, boxes, boxes text & titles color
+- Up to 60 Custom gametypes where you can assign Prefixes, Mutators and Settings
+- Filter system (supporting Wildcards) to implement detailed Map list assignments (up to 8x512 Filters)
+- Predefined Map list if noone voted (return to default maps)
+- Automatically map switch to a predefinded Map list if server is empty for a certain time (return to default maps)
+- Priority System for Map lists
+- Re-Vote limit (avoidable for certain map lists)
+- Kick Vote to kick players
+- Displaying a Clanlogo within the votemenu
+- Support for Assault and League Assault
+- Automatic removal of crashed maps (to prevent them to be revoted)
+- Map play count report and Map sequence report
+- Detailed in-game Admin page for most of the configuration
+
+Installation (Server)
+=====================
+1) copy the .u, .int and .ini files to the UT\System folder
+2) add to the UnrealTournament.ini in section [Engine.GameEngine] the following entry
+
+[Engine.GameEngine] 
+ServerPackages=MapVoteULv2_3
+
+Configuration
+=============
+The configuration is done in the file MapVoteULv2_3.ini
+Most of the settings can be changed in-game too. If you log in as admin and open the Map Vote you will get an additional Admin Tab.
+Make sure about (bReloadMapsOnRequestOnly=True in MapVoteULv2_3.ini) or (Check "Reload Maps on request only" option in Admin tab)
+This option can prevent all time maps loading in server side. This option reduce CPU load & faster server restart.
+If you added a new map in server click on "Reload Maps" button. It updates map names to "MapListTemp.ini" file.
+
+UPDATE FROM MapVoteULv2_2 TO MapVoteULv2_3
+==========================================
+In MapVoteULv2_2 the MutatorActorConfig[] has been removed and merged into the CustomGameConfig[]. 
+Remove the MutatorActorConfig[] entries and start the server and do a servertravel. The CustomGameConfig[] settings should now 
+have been expanded and you can apply the Mutators there.
+
+Starting up Map Vote
+====================
+Fire up your server and choose "Map Vote Ultimate 2.3" from the Mutator Tab
+
+Hints:
+======
+* to open the votemenu midgame use the following keybinding: "mutate bdbmapvote votemenu" or say !v (Command Utility installed).
+* to adjust color settings for background, boxes, boxes text & titles, open the votemenu then click on "Config" tab to get color configuration.
+* to adjust settings in-game log in as admin and open the votemenu, you will get an additional "Admin" tab for configuration.
+
+FAQ: What settings do I need in MapVoteULv2_3.ini?
+==================================================
+
+1) Step 1: Loading Maps
+-----------------------
+
+   For default gametypes there are predefined keys to enable the maps:
+	bDM=True
+	bLMS=True
+	bTDM=True
+	bDOM=True
+	bCTF=True
+	bAS=True
+	
+   To load cusom gametypes, mutators and settings you can use up to 60 'CustomGameConfig's. 
+   Here some examples to load iDM, iCTF, iAS, RocketArena and Bunnytrack:
+   
+   	DefaultSettings="FriendlyFireScale=0.0"
+   	CustomGameConfig[0]=(bEnabled=True,GameClass="Botpack.DeathMatchPlus",NewPrefix="iDM",Mutators="BotPack.InstaGibDM",Settings="")
+   	CustomGameConfig[1]=(bEnabled=True,GameClass="Botpack.DeathMatchPlus",NewPrefix="proDM",Mutators="",Settings="FriendlyFireScale=1.0")
+	CustomGameConfig[2]=(bEnabled=True,GameClass="BotPack.CTFGame",NewPrefix="iCTF",Mutators="BotPack.InstaGibDM",Settings="")
+	CustomGameConfig[3]=(bEnabled=True,GameClass="LeagueAS140.LeagueAssault",NewPrefix="iAS",Mutators="BotPack.InstaGibDM",Settings="")
+	CustomGameConfig[4]=(bEnabled=True,GameClass="RocketArena.RocketArenaGame",NewPrefix="")
+	CustomGameConfig[5]=(bEnabled=True,GameClass="BunnyTrack.BunnyTrackGame",NewPrefix="")
+	
+   * Mind: to distinct Maps with same name but different gametype/mutators/settings you have to change the prefix.
+   	 E.g.: to load Deathmatch and Insta-Deathmatch just change the prefix of the Insta-Deathmach to 'iAS'
+   	 
+   * Custom Settings:
+     You can use several custom settings by seperating them with a comma. E.g.: "FriendlyFireScale=1.0,Aircontrol=0.8"	 
+     IMPORTANT: If you use custom settings in the CustomGameConfigs you have to make sure those settings get reset to Default for all other maps:
+     E.g.: DefaultSettings="FriendlyFireScale=0.0,AirControl=0.35"
+
+2) Step 2: Assign the maps to a map list
+----------------------------------------
+
+   Tell the Map Vote in which list the maps should be displayed. Use the (up to 512 per list) 'List1FilterX[Y]' variables for this.
+   You can use wildcards in the Filters. Some Examples:
+   
+   Loading all Assault maps into List 1:
+   	List1Filter[0]=AS-*
+   	
+   Loading AS-Asthenosphere, AS-Bridge and AS-Rook into list 3:
+   	List3Filter[0]=AS-Asthenosphere
+   	List3Filter[1]=AS-Bridge
+   	List3Filter[2]=AS-Rook
+
+   Loading all TDM maps into List 4:
+   	List4Filter[0]=TDM-*
+   	
+   Loading all iDM maps into List 8:
+   	List8Filter[0]=iDM-*
+   	
+   Hint: If you have changed some prefixes you can/have to use the new prefixes in the Filters (like iDM for Insta)
+   Hint: You can use Wildcards. E.g.: DM-A* or *castle*
+
+Q: How do I add a clanlogo into Map Vote (displayed in the middle of the Vote window)?
+A: LogoTexture=ClanLogoPackage.TextureName
+   Make sure the Clanlogo is added to the Server packages as well
+   
+Q: Can I use wildcards in the filter?
+A: Yes you can. E.g.: List1Filter[0]=AS-B* will filter all AS maps that start with the letter 'B'
+
+Q: What are all the other parameters for?
+A: Support forum: http://forum.ultimateut.tk/
+
+Version History:
+================
+MapVoteULv2_3:
+--------------
+* Added    : 4096 maps support
+* Enhanced : Loading state
+* Added    : 8x512 Filters
+* Added    : 4096 Exclude Filter
+* Added    : 60 Custom Game Config in Admin tab window & MapVoteULv2_3.ini file
+* Added    : Inside Map Vote Tips html code for faster loading
+* Removed  : 140 Custom Game Config in MapVoteULv2_3.ini file
+* Removed  : Map Vote startup logo
+* Removed  : (!) say commands
+
+MapVoteULv2_2:
+--------------
+* Added    : Background, boxes, boxes text & titles color changing option
+* Added    : Map Vote logo on/off option (for client side)
+* Removed  : imvc command
+* Removed  : Background color changing window
+* Changed  : Bind option to config window
+
+MapVoteULv2_1:
+--------------
+* Changed  : Background color
+* Added    : Background color changing window
+* Added    : Map Vote logo
+* Fixed    : Log error
+
+MapVoteULv2:
+------------
+* Added    : 8 map list boxs
+* Added    : Map box text Color
+* Added    : Map Vote background color
+* Added    : (!) say commands
+* Fixed    : Map Vote Tips html file
+* Enhanced : No 256 maps limit per Map List any more. All 2024 maps can be put into one list if desired
+* Enhanced : Improved maploading/filter algorithm. Maps that get filtered off do not count for the maplimit any more. So all 2024 map slots can be used for visible maps.
+* Enhanced : Added an ExcludeFilter[2048] to remove special maps. This Filter can be enabled/disabled via admin menu
+* Enhanced : You can enabled/disabled 30 Custom Gametypes in admin window
+
+Visit
+=====
+http://forum.ultimateut.tk/
+http://ultimateut.tk/

Run.sh

@@ -0,0 +1,103 @@
+#!/bin/bash
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+OUTPUT_DIR="$2"
+CFG_FILE="$3"
+DEFAULT_CFG_FILE=UnrealTournament.ini
+function add_iniKeyEx() {
+	crudini --set $OUTPUT_DIR/System/$1 $2 __$3 $4
+	# Warning: ugly hack with sed to allow multiple key instances + to remove space around '='
+	sed -i "s/[[:space:]]*__$(echo $3 | sed -e 's/\([[\/.*]\|\]\)/\\&/g')[[:space:]]*=[[:space:]]*/$(echo $3 | sed -e 's/\([[\/.*]\|\]\)/\\&/g')=/g" 	$OUTPUT_DIR/System/$1
+}
+# !!Warning!! section is not considered
+function del_iniKeyEx() {
+	sed -i "/[[:space:]]*$(echo $3 | sed -e 's/\([[\/.*]\|\]\)/\\&/g')[[:space:]]*=[[:space:]]*$(echo $4 | sed -e 's/\([[\/.*]\|\]\)/\\&/g')/d" $OUTPUT_DIR/System/$1
+}
+function add_iniKey() {
+	add_iniKeyEx $CFG_FILE $1 $2 $3
+}
+# !!Warning!! section is not considered
+function del_iniKey() {
+	del_iniKeyEx $CFG_FILE $1 $2 $3
+}
+function add_ServerPackage() {
+	add_iniKey 'Engine.GameEngine' ServerPackages $1
+	add_iniKey 'XC_Engine.XC_GameEngine' ServerPackages $1
+}
+function del_ServerPackage() {
+	del_iniKey 'Engine.GameEngine' ServerPackages $1
+	del_iniKey 'XC_Engine.XC_GameEngine' ServerPackages $1
+}
+function add_ServerActors() {
+	add_iniKey 'Engine.GameEngine' ServerActors $1
+	add_iniKey 'XC_Engine.XC_GameEngine' ServerActors $1
+}
+function del_ServerActors() {
+	del_iniKey 'Engine.GameEngine' ServerActors $1
+	del_iniKey 'XC_Engine.XC_GameEngine' ServerActors $1
+}
+function install() {
+	rsync -a	$SCRIPT_DIR/Help/		$OUTPUT_DIR/Help/  --exclude  '.git'
+	rsync -a	$SCRIPT_DIR/System/		$OUTPUT_DIR/System/  --exclude  '.git'
+	
+	echo install ok
+}
+function enable() {
+	add_ServerPackage MapVoteULv2_3
+	echo enable ok
+}
+function disable() {
+	del_ServerPackage MapVoteULv2_3
+	
+	echo disable ok
+}
+function show_help() {
+	echo
+	echo "Usage: $0 { install | enable | disable } <UT99_INSTALL_DIR> [<UT99_CONFIG_FILE>]"
+	echo
+}
+function check_cfg_file() {
+	if [ -z ${CFG_FILE} ]
+	then
+		echo "CFG_FILE is unset, setting it to $DEFAULT_CFG_FILE"
+		CFG_FILE=$DEFAULT_CFG_FILE
+	else
+		echo "CFG_FILE is set to '$CFG_FILE'"
+	fi
+	if [ ! -f $OUTPUT_DIR/System/$CFG_FILE ]
+	then
+		echo "$OUTPUT_DIR/System/$CFG_FILE does not exist"
+		show_help
+		exit 9999 # die with error code 9999
+	fi
+}
+function check_game_dir() {
+	### Check if a directory does not exist ###
+	if [ ! -d $OUTPUT_DIR ]
+	then
+		echo "incorrect <UT99_INSTALL_DIR>"
+		show_help
+		exit 9999 # die with error code 9999
+	fi
+}
+case "$1" in
+	'install')
+			check_game_dir
+			install
+			;;
+	'enable')
+			check_game_dir
+			check_cfg_file
+			disable
+			enable
+			;;
+	'disable')
+			check_game_dir
+			check_cfg_file
+			disable
+			;;
+	*)
+			show_help
+			exit 1
+			;;
+esac
+exit 0

System/MapVoteULv2_3.int

@@ -0,0 +1,2 @@
+[Public]
+Object=(Name=MapVoteULv2_3.BDBMapVote,Class=Class,MetaClass=Engine.Mutator,Description="Map Vote Ultimate 2.3,Map Vote system for Unreal Tournament!")