CS2SimpleVote

A lightweight, robust, and feature-rich map voting plugin for Counter-Strike 2, built on the CounterStrikeSharp framework. It provides a seamless experience for players to nominate and vote for the next map from a Steam Workshop collection, with powerful administrative controls.

---

🚀 Key Features

• ✅ Automated Voting: Trigger a map vote automatically at a specific round in the match.
• 🔥 Rock The Vote (RTV): Allow players to initiate a vote to change the map immediately.
• 🗳️ Nomination System:
  • Players can nominate specific maps from the collection.
  • Search Support: Use nominate <term> (with or without !) to filter maps by name.
  • Auto-Selection: If a search term matches only one map, it is nominated instantly.
• 📜 Recent Map History: Prevents recently played maps from appearing in the automated vote pool for a set number of rounds.
• 🛠️ Workshop Integration: Automatically fetches and caches maps from a specified Steam Workshop Collection.
• 📢 Interactive HUD: Displays a "VOTE NOW!" alert in the center of the screen for players who haven't voted yet.
• 💬 Smart Announcements: Customizable server name and recurring messages showing the current map.
• 🛡️ Admin Controls: Force map changes or votes transparently.

---

📂 Configuration & Data

The configuration file is generated at .../configs/plugins/CS2SimpleVote/CS2SimpleVote.json.

Options

Option	Type	Default	Description
steam_api_key	string	""	Your Steam Web API key (Required for Workshop fetching).
collection_id	string	"123456789"	The Steam Workshop Collection ID used as the map pool.
vote_round	int	10	The round number when the automated map vote starts.
vote_open_for_rounds	int	1	Number of rounds a scheduled vote remains open before closing.
enable_rtv	bool	true	Enables or disables the !rtv command.
rtv_percentage	float	0.60	The percentage of human players required to trigger an RTV (0.0 - 1.0).
rtv_change_delay	float	5.0	Seconds to wait before switching maps after a successful RTV.
enable_nominate	bool	true	Enables or disables the !nominate command.
nominate_per_page	int	6	Number of maps to display per page in the nomination menu.
vote_options_count	int	8	Total number of maps that appear in a single vote (max 10).
vote_reminder_enabled	bool	true	Whether to send chat reminders to players who haven't voted.
vote_reminder_interval	float	30.0	How often (in seconds) to send vote reminders.
enable_recent_maps	bool	true	Enables filtering to prevent recent maps from being auto-picked for votes.
recent_maps_count	int	5	How many previous maps to remember and exclude from the vote pool.
server_name	string	"CS2 Server"	The server name displayed in map broadcast messages.
show_map_message	bool	true	Enables a recurring chat message showing the current map.
map_message_interval	float	300.0	Interval in seconds between map info broadcasts.
admins	List<ulong>	[]	List of SteamID64s allowed to use admin commands.

Admin Configuration Example

To grant admin access, add your SteamID64 (decimal format, starts with 7) to the admins array:

"admins": [
    76561198012345678,
    76561197960287930
]

---

⌨️ Player Commands

Commands can be used with or without the ! prefix.

!help

Lists all available commands in chat.

--- CS2SimpleVote Commands ---
!help - List available commands
!nextmap - Show next map
!nominate - Nominate a map (Usage: nominate [name])
!nominatelist - List nominated maps
!revote - Recast vote
!rtv - Rock the Vote

!rtv

Add your vote to change the current map.

PlayerName wants to change the map! (1/5)

!nominate

Open the menu to nominate a map from the collection.

Page 1/2. Type number to select (or 'cancel'):
[1] de_dust2
[2] de_mirage
[3] cs_office
[4] de_nuke
[5] de_inferno
[6] de_vertigo
[0] Next Page

!nominate [name]

Search and nominate a map. If only one map matches, it is auto-nominated.

PlayerName nominated de_dust2.

!nominatelist

Shows the Maps currently nominated for the next vote and who nominated them.

--- Nominated Maps (2/8) ---
 - PlayerOne - de_dust2
 - PlayerTwo - de_mirage

!revote

Re-open the current vote options menu if you want to change your vote.

Redisplaying vote options. You may recast your vote.
Type the number to vote:
[1] de_dust2
[2] de_mirage

!nextmap

Displays the result of the voting process once it has finished.

The next map will be: de_dust2

---

🛡️ Admin Commands

Requires your SteamID to be in the admins configuration list.

!forcemap [name]

Forcefully changes the map immediately. Use with a search term to find a map.

• One match: Changes map immediately.
• Multiple matches: Opens a selection menu.

Admin AdminName forced map change to de_dust2.

!forcevote

Manually starts the map vote process.

• If no vote has occurred: Starts a standard map vote.
• If a vote has already finished: Triggers a 30-second "Revote".

Admin AdminName initiated a map vote.
--- Vote for the Next Map! ---
Vote will remain open until the round ends.
Type the number to vote:
[1] de_dust2
[2] de_mirage
[3] cs_office
...

---

🛠 Installation

1. Install CounterStrikeSharp.
2. Place the CS2SimpleVote.dll in the game/csgo/addons/counterstrikesharp/plugins/CS2SimpleVote/ folder.
3. Configure your steam_api_key, collection_id, and admins in the generated config file.
4. Restart your server or load the plugin.