-------------------------------------------------------------------------------
DESCRIPTION:
-------------------------------------------------------------------------------
MapVoteLAv2_Big21a is a UT'99 mutator that allows players on a server to vote
for the maps that will be played.  This particular version, _Big21a, just
contains some additions and fixes for the earlier version MapVoteLAv2 released
by JackGriffin here: https://ut99.org/viewtopic.php?t=3801

My intention was to continue with more fixes and maybe some more additions
before releasing this but it seems I never got around to it.  It is now 5 years
later and I'm finally making this readme for release because I received an
email asking about the Big21a version.  Check the changelog below to see what
has been changed.


--------------------------------------------------------------------------------
INSTALLATION:
--------------------------------------------------------------------------------
Shut down the server

Copy the following files to your server's System folder:
MapVoteLAv2_Big21a.ini
MapVoteLAv2_Big21a.int
MapVoteLAv2_Big21a.u

If you use a redirect with compression copy the MapVoteLAv2_Big21a.u.uz file to
the redirect server.

Edit your server's UnrealTournament.ini file and add the following line to the
appropriate section:
[Engine.GameEngine]
ServerPackages=MapVoteLAv2_Big21a

In your server's mutator startup line add the following:
MapVoteLAv2_Big21a.BDBMapVote

Restart your server


--------------------------------------------------------------------------------
UPDATING:
--------------------------------------------------------------------------------
Updating from MapVoteLAv2:

Shut down the server

Copy the following files to your server's System folder:
MapVoteLAv2_Big21a.ini
MapVoteLAv2_Big21a.int
MapVoteLAv2_Big21a.u

If you use a redirect with compression copy the MapVoteLAv2_Big21a.u.uz file to
the redirect server.

Edit your server's UnrealTournament.ini file and change the LAv2 server
packages line to the following in its appropriate section:
[Engine.GameEngine]
ServerPackages=MapVoteLAv2_Big21a

In your server's mutator startup line change MapVoteLAv2.BDBMapVote to the
following:
MapVoteLAv2_Big21a.BDBMapVote

Copy all of the settings from your MapVoteLA.ini that are under the
[MapVoteLAv2.BDBMapVote] section and paste them into the new
MapVoteLAv2_Big21a.ini file overwriting the config lines that come before the
MinPlayersForKick=2 option.

Finally, you can edit the header in your current MapListTemp.ini from
[MapVoteLAv2.MapListTemp] and change it to [MapVoteLAv2_Big21a.MapListTemp]
or you can just start the server and reload the map configuration as you
normally would.

Start the server if you didn't already do so in the previous step.

If you configured any NewMaps[] options and enabled bColorNewMaps=True,
detailed in the CONFIGURATION section below, the green font color will show on
those maps after the first map switch if everything was configured correctly.


--------------------------------------------------------------------------------
CONFIGURATION:
--------------------------------------------------------------------------------
Please refer to the ReadMe-MapvoteLA13.txt file, which is included in the
archive, for the bulk of your configuration.  Also, the most complete
documentation I have seen for this mapvote variety (BDBMapVote) is on Hook's
forum here:
https://hooksutplace.freeforums.net/thread/8/mapvotela13-mapvotelav2-mapvote-
explained


Configuration of the Big21a version specifically:

The UT and Epic Logos have been included in the package so you can set them for
your mapvote logo if you want using either one of the following in the
MapVoteLAv2_Big21a.ini:

LogoTexture=MapVoteLAv2_Big21a.Ulogo
LogoTexture=MapVoteLAv2_Big21a.Elogo

You can now set the minimum number of players that must be on the server for
kick voting to actually kick someone.  The default is set to 2.  This was
necessary because certain players would come in during low traffic times and
kick spectators out thereby locking them out of the server for the duration of
the map.  You can adjust this setting to your needs with this config option:

MinPlayersForKick=2

An option has been added to color new maps in green font and add a note in the
screenshot area of mapvote stating it is a recently added map.  If you want
this functionality you must first enable it with the following config line:

bColorNewMaps=True

And then you need to specify each new map name in the following lines
NewMaps[0]=
...
NewMaps[63]=

There is currently only 64 total slots for new maps and the mapname specified
for each needs to match the exact map name you use in the List filter section
including any prefix if you use them:
List1Filter[0]=sCTF-Dreary      <--example list filter entry with prefix
NewMaps[0]=sCTF-Dreary          <--example new maps entry including the prefix

Note: The font colors that were added in the LAv2 mapvote for the different
game types does not function if you are using prefixes.  I added this NewMaps
font coloring because I wanted the players to vote new maps more often.  My
server has always used prefixes and I can't remember how this change might
affect font colors if you don't use prefixes.  Most likely, the green font for
new maps will work fine and make new maps stand out for any gametype other than
DM, which I believe already uses the green font, if prefixes aren't used.

Finally, you can set URLs for Server Rules which will show up in the new Rules
tab and a map vote tips URL if you want to provide any mapvote tips:
ServerRulesURL=
MapVoteTipsURL=


--------------------------------------------------------------------------------
CHANGELOG:
--------------------------------------------------------------------------------
Big21a:
--added option to color font of recently added maps to green
--added note in map screenshot area "Recently Added Map" if map is configured as
  a new map shown in green --added a rules tab with ability to configure the
  URL for the rules.
--embedded the utlogo and an epic games logo to use for mapvote logotexture
--made URL configurable for mapvote tips
--greyed out serverInfo, MapInfo, and Mapvote Tips buttons if URLs are not
  confiugred
--updated the about page and button with new mapvote version name and credit to
  earlier versions.
--fixed issue with player unknown showing when changing kickvotes
--added kicking oneself now erases your previous kickvote
--fixed admin tab commands not working in new 20a version
--added client message when mapvote is already open "try hitting Esc key"
--moved LAv2 and newer config variables to the bottom of mapvote.ini (easier
  ini update for admins)

Big20a:
--removed broken url from mapvote tips button
--added config variable MinPlayersForKick
--added scrollbars for low resolution and/or big font users
--changed package name to be slightly more descriptive keyword Big


--------------------------------------------------------------------------------
CONTACT:
--------------------------------------------------------------------------------
For the Big21a version only:
Author: snowguy
Contact: negruler@gmail.com


--------------------------------------------------------------------------------
CREDITS:
--------------------------------------------------------------------------------
Thanks to Epic and all those involved in making these great games.  Thanks also
to the community of players and content creators that have helped to keep these
games going for all of this time.

Huge thanks and credit to earlier mapvote versions which have done much more
work than is included in this Big21a version:

JackGriffin for his work and release of the MapVoteLAv2 version.

BDB (Bruce Bickar) and Cratos for the earlier versions.


--------------------------------------------------------------------------------
LICENSE:
--------------------------------------------------------------------------------
All code and changes made in the Big21a version are free to use however you
want.  JackGriffin said essentially the same for his additions in LAv2 but keep
in mind permission was never granted for use of the original MapVoteLA versions.

