[The Resident]

Players Votes (1.5.0)

say votekick, voteban, votemap & votemute for use by players.

Changes in 1.5.0: (new CVARs, Polish translation)

• Added BETA-test team-based voting. Kick, Mute, and Ban voting can be restricted to within a team.
• Added CVAR to control vote menu timeout.
• Added updated Polish translations (thanks FrozenHaxor!)
• Allow non-admins to use "!votemap" , "!votemute", etc chat triggers. Admins cannot use them because then it interferes with the identical stock SM triggers.
• Fixed bug / exploit causing wrong names to be shown in voteban menu.

ANNOUNCEMENT:

The Players Votes plugin is now essentially in maintenance mode. I will continue to fix bugs and add some features, but I will not be adding "major" new features (such as cvar votes, session-based votes, essentially anything requiring substantial re-design), because Players Votes has since been surpassed in that area by Chundo's very flexible Custom Votes. I encourage admins that would like new major features to check out Custom Votes.

HOWEVER:

Input/feedback is more than welcome. I'll definitely investigate reasonable suggestions.

Features:

Voteban resiliance: Tired of griefers and hackers evading voteban by disconnecting and reconnecting while voting is underway? Players Votes now makes it hard for those scoundrels to get away with it.

SourceBans notification: If Players Votes is running alongside SourceBans, it will notify and let SB handle the banning.

Voteban reasons: Optionally make players specify a reason for votebanning someone. The most-selected reason is then logged when the ban takes effect.

Admin menu integration: It allows admins to cancel any existing votes for all or any particular type of vote. It allows admins to disable/re-enable all or any particular type of vote. The menu name for adminmenu_sorting.txt and admin overrides is "pv_menu"

Immunity: Admins can be excluded from votekick, ban, and mute by configurable immunity levels or group membership:

sm_playersvotes_immunity:
Admins with equal or higher immunity level will not be affected by votekick and voteban. 0 to immunize all admins. -1 to disable numeric immunity levels.

sm_playersvotes_immunegroups:
Semicolon-delimited list of admin groups. Any members of these groups are immune. Any admin that is NOT a member of these groups will have their numeric immunity level checked against the _immunity cvar.

Basic config 1: use the following to immunize based only on numeric immunity levels:

sm_playersvotes_immunity "50.0" (or whatever number you like)
sm_playersvotes_immunegroups ""

Basic config 2: use the following to immunize based only on group membership: (note only Full Admins and Clan Members are immune in this example. Donors or any other "admins" would NOT be immune)

sm_playersvotes_immunity "-1.0"
sm_playersvotes_immunegroups "Full Admins; Clan Members"

Configurable votemap list: votemap uses the map cycle by default. Server admins may optionally specify a different maplist by adding a playersvotes section to maplists.cfg:

 /* For playersvotes plugin */
    "playersvotes"
    {
        "file"            "maplist.txt"
    }

Map extension votes: If map extensions are enabled, when players do a votemap, the first item in the vote menu lets them extend the current map's timelimit.

Team-restricted voting: (BETA FEATURE) When enabled, this restricts voting to within teams, and ratios are affected. A votekick ratio of 0.5 will mean "half of all players within the team" as opposed to "half of players in the whole server."

Please note this can cause undesired side-effects. If this is enabled, someone is hacking, and their team doesn't do anything about it, then the other team is helpless to kick/ban them. Use at your own risk.

Known Issues:

- votekick, ban, and mute menus may not appear if there's only one player on server, or if all players are immune.

Changelog:

1.5.0: Aug 09, 2009 (new CVARS)
- Added BETA-test team-based voting. Kick, Mute, and Ban voting can be restricted to within a team.
- Added CVAR to control vote menu timeout.
- Added updated Polish translations (thanks FrozenHaxor!)
- Allow non-admins to use "!votemap" , "!votemute", etc chat triggers. Admins cannot use them because then it interferes with the identical stock SM triggers.
- Fixed bug / exploit causing wrong names to be shown in voteban menu.

1.4.1: May 30, 2009 (new CVARs, translations)
- Added voteban reasons.
- Added ability for votemap to set the nextmap, rather than change immediately.

1.4.0: Apr 20, 2009 (new CVAR, translations)
- Added German translation (thanks Guggie)
- Added group-based immunity. See the Features section.
- Organized the config file a little more clearly.

1.3.2: Feb 23, 2009
- Removed the "[Vote(Etc)] " tags from the notification messages. I agree they seemed pretty redundant.
- Repackaged data file archive to include the source code.

1.3.1: Jan 04, 2009 (new translation phrases)
- Added rudimentary Admin menu. (named "pv_menu")
- Allow votemuted players to be manually unmuted through standard Admin->PlayerCommands->Mute menu.
- Fixed nickname not appearing in SourceBans... as long as player is connected at the time of the ban. Otherwise, nickname appears in the ban reason.
- Fixed potential wrong player being muted if a votemuted player is banned.

1.3.0: Dec 29, 2008 (new CVARS, major exploit fix)
- Voteban redesign to fix long-standing exploit!
- Added votemute
- Added per-player, per-map vote limits for each vote type.
- Changed menu ordering so that items with any votes are promoted to the top of the menu.
- Added Hungarian translation (Thanks KhyrOO)
- Voteban will notify SourceBans of player bans, if SB is installed.
- Fixed bug preventing votemap from working when more than 100 maps are up for voting.
- Fixed some minor bugs when voting is disabled

1.2.6:
- Updated cvar sm_playersvotes_immunity so that 0 = all admins immune, -1 = no one is immune. (thanks r3recon) Default is 0. Otherwise, behavior is the same.
- Upped cvar sm_playervotes_interval maximum to 10000. (thanks MaKTaiL)
- Updated cfg file - default sm_playersvotes_immunity to 0.

1.2.5: (NOTE: anyone upgrading from 1.2.4 or prior, take note: NEW CVARS. Please check out the latest data files.)
- Added map extension votes and cvars sm_votemap_extend and sm_votemap_max_extends.
- Prevent immune admins from even showing up in votekick and voteban menus
- Fix votekick and voteban vote resets, in case multiple people are being kicked / banned around the same time.

1.2.4:
- Eliminate 64 map limitation and potential crash on servers w/ > 64 maps
- Minor fix to lastmap logic

1.2.3:
- Make vote ratio cvars dictate a minimum ratio, rather than approx. ratio.
- Fix stale votes - all votes are now cleared after map change; kick and ban votes are now cleared after the vote passes.
- Eliminated cvar sm_votemap_mapsfile.
- Use maplists.cfg and ReadMapList to obtain maps for votemap
- Update to avoid deprecated functions.
1.2.2:
- Compatibility with newest sourcemod
1.2.1:
- cvar to prevent adding X last played maps to votemap menu
- few minor fixes
- added auto config execution
- Added german translation (thx Isias)
1.2:
- Added votemap
- More options
1.0.1:
- More cvar options
1.0: First release

CVARS: New 1.5.0 CVARS are RED

sm_votekick_ratio - ratio required for successful votekick
sm_voteban_ratio - ratio required for successful voteban
sm_votemap_ratio - ratio required for successful votemap
sm_votemute_ratio - ratio required for successful votemute

sm_votekick_minimum - minimum votes required for successful votekick, -1 for disable votekick
sm_voteban_minimum - minimum votes required for successful voteban, -1 for disable voteban
sm_votemap_minimum - minimum votes required for successful votemap, -1 for disable votemap
sm_votemute_minimum - minimum votes required for successful votemute, -1 for disable votemute

sm_votekick_delay - time in seconds before votekick is allowed after map start
sm_voteban_delay - time in seconds before voteban is allowed after map start
sm_votemap_delay - time in seconds before votemap is allowed after map start
sm_votemute_delay - time in seconds before votemute is allowed after map start

sm_votekick_limit - number of kick votes allowed per player, per map. Useful for controlling spam. 0 to disable voting. -1 for no limit
sm_voteban_limit - number of ban votes allowed per player, per map. Useful for controlling spam. 0 to disable voting. -1 for no limit
sm_votemap_limit - number of map votes allowed per player, per map. Useful for controlling spam. 0 to disable voting. -1 for no limit
sm_votemute_limit - number of mute votes allowed per player, per map. Useful for controlling spam. 0 to disable voting. -1 for no limit

sm_votekick_team_restrict - restrict kick votes to teams. 1 to enable, 0 to disable.
sm_voteban_team_restrict - restrict ban votes to teams. 1 to enable, 0 to disable.
sm_votemute_team_restrict - restrict mute votes to teams. 1 to enable, 0 to disable.

sm_playersvotes_interval - time in seconds between another vote cast

sm_playersvotes_menu_timeout - number of seconds to display voting menus. 0 for no limit


sm_voteban_time - ban time. 0 for permanent bans

sm_voteban_reasons - semi-colon delimited list of ban reasons. (ex: "Hacking; Spamming; Griefing")

sm_playersvotes_immunity - admins with equal or higher immunity level will not be affected by votekick and voteban. 0 to immunize all admins. -1 to disable immunity levels

sm_playersvotes_immunegroups - Semicolon-delimited list of Admin Groups whose members are all immune. "" to disable group-based immunity

sm_votemap_lastmaps - last number of played maps that will not show in votemap list

sm_votemap_extend - number of minutes to add to the timelimit if the players vote to extend. -1 to disable

sm_votemap_max_extends - number of extensions to allow per map. -1 for no limit

sm_votemap_immediate - 1 to change map immediately after a map wins a votemap. 0 for setting nextmap

Credits:

This plugin is originally by pVz!. It was abandoned until I fixed some bugs, creating version 1.2.3. See the original, previously-approved plugin thread here.

Thanks to ferret, some things are based on his solutions from plugins in sourcemod base.

Installation:

.cfg goes in cfg\sourcemod
.sp goes in addons\sourcemod\scripting
.smx goes in addons\sourcemod\plugins
.txt goes in addons\sourcemod\translations

The .zip file includes all the current stock files already stored in relative paths.