Files
UT99-Mod-MapVoteUL/Help/MVU3.txt
2022-07-25 00:12:23 +02:00

203 lines
8.7 KiB
Plaintext

======================================================
Map Vote Ultimate 3 for UT by Deepu, Spectra & Nelsona
======================================================
Release Date 08/03/2019
Map Vote Ultimate needs minimum 960 Width X 720 Height or more resolutions for fitting column width on the screen.
What is Map Vote Ultimate?
=========================
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 8192 maps
- 12 Customizable Map Lists+
- Search option
- 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 8x64 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
3) If you are using XC_Engine, won't need to add "MVU3" to the ServerPackages list.
[Engine.GameEngine]
ServerPackages=MVU3
Configuration
=============
The configuration is done in the file MVU_Config.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 MVU_Config.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 "MVU_MapList.ini" file.
UPDATE FROM MapVoteULv2_4 TO MVU3
=================================
In MapVoteULv2_4 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 3" from the Mutator Tab
or
Add this line to server startup mutator list "MVU3.BDBMapVote"
Hints:
======
* to open the votemenu midgame use the following keybinding: "mutate bdbmapvote votemenu" or say !v, !vote, !mapvote and !kickvote.
* 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 MVU_Config.ini?
===============================================
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, settings and packages 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="",Packages="Test1")
CustomGameConfig[1]=(bEnabled=True,GameClass="Botpack.DeathMatchPlus",NewPrefix="proDM",Mutators="",Settings="FriendlyFireScale=1.0",Packages="Test2")
CustomGameConfig[2]=(bEnabled=True,GameClass="BotPack.CTFGame",NewPrefix="iCTF",Mutators="BotPack.InstaGibDM",Settings="",Packages="Test3")
CustomGameConfig[3]=(bEnabled=True,GameClass="LeagueAS140.LeagueAssault",NewPrefix="iAS",Mutators="BotPack.InstaGibDM",Settings="",Packages="Test4")
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.: Settings="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"
* Packages:
You can use several custom packages by seperating them with a comma. E.g.: Packages="SoldierSkins,CommandoSkins,FCommandoSkins,SGirlSkins,BossSkins,Botpack"
IMPORTANT: You must need atleast XC_Engine version 15 or more version to load Packages for each CustomGameConfig.
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:
================
MVU3:
-----
* Added : 8192 maps support
* Added : Packages loading ability with the help of XC_Engine for each CustomGameConfig
* Added : Self package loading ability if XC_Engine installed
* Added : Window stay at center of the screen when resolution changed
* Changed : All config .ini files to "MVU_" prefix & Map Vote package name
* Increased: Map Vote History cache number to 1024
* Reduced : List Filters to 8x64
* Reduced : Exclude Filter to 512
* Fixed : Most of the accessed nones
* Added : (!) say commands, not required any custom command loader for MVU
MapVoteULv2_4:
--------------
* Added : Search option
* Enhanced : Loading state
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/