
The new voting plugin is a big and complex one, with many configuration options. To fully understand it, you should really take your time to read through the features list below as well as the comments in the init_votes function, but it was built to be very flexible to meet different admins' needs, and to be easy to use, so the default options should work fine in most cases and there's no need to feel daunted.

So, dig in: http://www.gamers.org/tmn/Features_084.html
- New features and other changes in the v0.84 release of ASECO/RASP:
* new and sophisticated chat-based voting; by including plugin.rasp_votes.php and setting $feature_votes in rasp.settings.php to true, normal CallVotes are disabled and the following features become available:
- # new /helpvote command to display usage info and the actual voting ratios for the new voting commands
# new /endround vote to end a round (only enabled in Rounds/Team modes)
# new /ladder vote to restart the current track immediately when the ladder is down
# new /replay vote to replay the current track after it's done (prepends it to jukebox)
# new /skip vote to skip the current track immediately
# new /kick vote to kick a player
# new /cancel command for a player to cancel his/her own vote (also works with TMX /add votes; admins can /cancel any vote)
# extensive configuration options:
- - separate voting ratios per type of vote, so e.g. a kick vote is harder to pass than an endround vote
- option to enable /kick vote (default: on) and enable kicking of admins (default: off); if disabled, /kick also isn't listed in the /helpvote output
- option to perform /ladder restart via quick ChallengeRestart or by prepending track to jukebox and doing NextChallenge
- option to automatically vote for the vote starter, otherwise the old way remains where the starter also has to vote /y
- vote expiration options:
in Rounds/Team modes all votes (except /endround) expire within 3 rounds (default);
in TimeAttack/Laps/Stunts modes all votes expire after approximately 120 seconds / 2 minutes (default);
expiration is necessary, otherwise unpassed votes will linger on until the end of the track, preventing players from starting another vote
- vote reminder options:
in Rounds/Team modes a reminder can be shown after every round until the vote passes or expires;
in TimeAttack/Laps/Stunts modes a reminder can be shown approximately every 30 seconds (default) until the vote passes or expires;
reminders help players not forget about ongoing votes after the last vote message has scrolled out of the chat window
- optional limits to the number of /ladder, /replay & /skip votes per track (default max: 2); if a limit is 0, that particular vote is disabled
- optional limits to when /ladder, /replay & /skip votes are allowed in Rounds and TimeAttack mode:
in Rounds the limit is based on the number of points that the first player already has, compared to the server's points limit;
in TimeAttack the limit is based on the time the track is already running, compared to the server's time limit;
/ladder is disabled after 40%, /replay is disabled before 50%, and /skip is disabled after 70% of those limits (all percentages configurable)
- the rationale behind these optional limits is that it's: annoying to go through the same type of vote more than twice; annoying to go through a ladder restart vote when the track is already a few minutes under way; too early to decide whether to play a track again if when it's not even halfway done; and annoying to go through a skip vote when a track is close to completion
- there's no limit to the number of endround and kick votes per track, because you may need more than a few of them J
- there are no /ladder, /replay & /skip limits in Team, Laps & Stunts modes
# in determining the required number of votes, spectators are not included; this now also applies to TMX /add votes
# if chat-based voting is enabled, the /server output will show a pointer to /helpvote instead of the CallVote timeout and ratio
# in Rounds/Team modes a running /endround vote is automatically terminated by the EndRound event, i.e. when all players 'Enter' as yet or by an /admin endround/er command
# the vote expiration and reminder options, and the automatic vote for starter option, also work with TMX /add votes
# all votes terminate automatically at the start of a new track
# when a new player connects, an explanatory message that chat-based voting is in effect is shown to that player, or optionally to all players; you can use the latter during an introduction period until most players are familiar with the new voting system
# integrates properly with TMX /add votes whether or not those are enabled, and whether or not chat-based votes are enabled
# voting messages use a new pink color (<vote> in config.xml) that's sufficiently distinct from the colors of all other message types (but /add related messages retain their normal orange color)
# for further understanding of the features and configuration options, study the detailed comments in function init_votes() in plugins.rasp_votes.php - - separate voting ratios per type of vote, so e.g. a kick vote is harder to pass than an endround vote
* updated /admin cancel to cancel TMX & chat votes too
* added more aliases to /admin nextmap command, for consistency with the /skip vote: /admin skipmap and /admin skip
* long lines in the /chatlog pop-up window are now split up with a continuation symbol (...) at the start of the second and following parts
* if <log_all_chat> is true, non-existent chat commands - lines starting with '/' that cannot be executed - are also logged (but they're not shown in /chatlog)
* (almost) all function calls were updated to remove the deprecated pass-by-reference '&' from parameters
* tweaked various jukebox related messages
Bug fixes in the v0.84 release of ASECO/RASP:
* in the /chatlog output, strip wide font ($w) from nicknames so that the window width isn't stretched out too far by players with long wide nicks and lengthy chat lines
* with a large number of long chat lines in the /chatlog output, it could hang up the TMN client – fixed
* all player tests w.r.t. jukebox/add actions are done against nickname, potentially causing conflicts between players with identical nicknames – fixed by changing those tests to logins
* if a player voted /y in one TMX /add vote, he/she wouldn't be able to vote for another /add vote during the same track – fixed
* if a player tries to /add an existing track, the preceding track in the server's track list would be jukeboxed instead of that requested one – fixed
* if a player tries to /add the same track that was just /add-ed (but not yet loaded), another vote would be started – fixed
* /add doesn't properly insert the track into the jukebox such that it can be dropped again – fixed
* if /add finds the requested track is already present on the server, the temporary track file wouldn't be deleted – fixed
* using '$z' to clear text attributes after track names and player nicknames in various messages would also turn off the default 'shadowed' style for the remainder of those messages – fixed by replacing '$z' with '$g$m' - # new /helpvote command to display usage info and the actual voting ratios for the new voting commands
http://www.gamers.org/tmn/
Enjoy!
Xymph