Content
Description of the plugin
Plugin files and purpose
Configuration
Commands
Changelog
Bugs
Thanks
Description:
This plugin have an more advanced handling of how maps are choosen during votes and allows grouping of maps as well as player count condition for the map and "weight" which increase or decrease odds of selection. The weight can also be modified using external sources ex. use the result of "map rate" as a factor is currently included and supported by mapvote_reweight.
Example one might only want mapchooser with sound and some output then only install this modified mapchooser.
All the other plugins are however dependent on mapvote.
Plugins:
requires sourcemod 1.1
mapvote - this will create votes based on more arguments and pass it mapchooser, sourcemod or the included version
mapchooser - the one included in the package will add some vote output and possibility for sound, note that NO sound is included
rockthevote - only diffrence is that it depends on mapvote and will use mapvote selection algorithm instead of mapchooser => nominations is ignored, if you want nominations keep original rtv
mapvote_reweight - is an optional addition to mapvote and will use the result from plugin "map rate" and scale the odds for a map to be selected by multipling weight with the maps average rating but you can write one of your own and use another source or algorithm.
How to edit the mapfile (Def. $basedir/addons/sourcemod/configs/mapvote.ini ):
Here you can create groups of maps and tell how many maps to take from each group and parameters that is used when considering maps.
The structure looks like
"Groupname"
{
// Here you can add group parameters (add slots otherwise this group will not be used, all other parameters are optional)
"Mapname A"
{ // Here you add map paramaters (all parameters here are optional)
}
// Keep filling in the maps that should belong to this group with the above example of how a map entry should look like
}
You can have one map in several groups and you are guaranteed that it will not come up more than once in the vote menu.
See the included mapvote.ini for an example configuration.
Group parameters:
"slots" - number of maps to select from this group
"default weight" - if no weight is given for a map inside the group this value will be used inside instead (default is 100 if not specified). Used from this point forward. Can be used for lazy people or higher accuracy (like percentage isn't enough)
Map parameters:
"min" - min number of players
"max" - max number of players
"weight" - this is used to increase or decrease the chance of selection
Commands:
console cmds
mapvote - takes parameters and just forward to the command
sm_mapvote_print <prevmaps | maps> - used to make sure it read the files and works correctly
admin cmds
sm_mapvote_vote <now | round | map> - starts a vote that will take affect according to the argument
sm_mapvote_reloadmaps- force a reload of maps, can be used in conjunction of changing mapfile cvar by third parties since mapvote will reload maps automaticaly on mapchange if and only if the file have been modified since last read.
Changelog
1.2.1 - 1/1/2009
- another attempt to fix sounds (API is buggy)
- menu - splitted (better than a new category?)
- default sound added and enabled by default
1.2.0 - 29/12/2008
- permissions
- updated mapchooser for SM 1.1
- basic admin menu support1.1.1 - 24/10/2008
- previous map being removed in wrong order
- 1.04 support (change in translation file to import)
1.1.0 - 30/8/2008
- updated 1.1 snapshot of mapchooser
- fixed multiple votes
- fixed rtv right before mapchange causing problems next round
- small changes
1.0.7 - 21/8/2008
- removed a warning (want longer name but this will work)
- added config file for mapvote for all except one variabel
- added randomorder cvar for votes
- added possibility to disable votes
- use the same memory fix as I posted in the forum, made a max instead of min causing index out of bound
- some small changes in mapchooser and how it handles when votes can be started
- will set failstate if mapchooser is set to create end of map vote
- fixed a typo in sound for mapchooser where max was set to 1.1 instead of 1.0
1.0.6 - 20/8/2008
- probably fixed TF2 winning_panel starting a vote
- if cvar for file has changed it will reload maps on the next round, if you want to reload instantly then you need to force with command
1.0.5 - 19/8/2008
- maybe fixed index out of bound
- sound in mapchooser is disabled by default
1.0.4 - 18/8/2008
- fixed no vote if nextmap is set
- mapchooser will not set "Pending vote" when it is disabled
1.0.3 - 10/8/2008
- added reweight in print IF mapvote_reweight is loaded
1.0.2 - 11/8/2008
- fixed display
1.0.1 - 10/8/2008
- mapvote_reweight - fix float and int usage making a more accurate reweight
Thanks to:
- Sourcemod team
- Thermopyle for debugging
- people on IRC
- Sound files are under creative
common sampling plus 1.0 from
this site - votestart.wav - is made by Robinhood76
- voteend.wav - is made by reinsamba