Files
CS2-SimpleAdmin/CS2-SimpleAdmin-docs/docs/user/commands/basevotes.md
Dawid Bepierszcz b0d8696756 Add CS2-SimpleAdmin documentation site
Introduces a new documentation site for CS2-SimpleAdmin using Docusaurus, including developer API references, tutorials, user guides, and module documentation. Removes the CleanModule example and updates FunCommands and ExampleModule. Also updates main plugin and API files to support new documentation and module structure.
2025-10-20 01:27:01 +02:00

6.8 KiB

sidebar_position
sidebar_position
6

Vote Commands

Commands for creating polls and votes on your server.

Create Vote

Create a custom poll for players to vote on.

css_vote <question> [option1] [option2] [option3] ...

Permission: @css/generic

Parameters:

  • question - The question to ask players
  • option1, option2, ... - Vote options (at least 2 required)

Examples

Simple Yes/No Vote

css_vote "Should we change map?" "Yes" "No"

Player sees:

Vote: Should we change map?
1. Yes
2. No

Multiple Options

css_vote "Which map should we play next?" "de_dust2" "de_mirage" "de_inferno" "de_nuke"

Player sees:

Vote: Which map should we play next?
1. de_dust2
2. de_mirage
3. de_inferno
4. de_nuke

Rule Vote

css_vote "Should we allow AWPs?" "Yes" "No" "Only one per team"

Activity Vote

css_vote "What should we do?" "Surf" "Deathrun" "Competitive" "Fun Round"

How Voting Works

Player Participation

Players vote by:

  1. Opening their chat
  2. Typing the number of their choice
  3. Or using vote menu (if available)

Example:

Player: 1  (votes for option 1)
Player: 2  (votes for option 2)

Vote Duration

  • Default vote time: ~30 seconds
  • Vote timer shows on screen
  • Results shown when vote ends

Vote Results

After voting ends, results are displayed:

Vote Results:
1. Yes - 12 votes (60%)
2. No - 8 votes (40%)

Winner: Yes

Use Cases

Map Voting

css_vote "Next map?" "de_dust2" "de_mirage" "de_inferno"

Rule Changes

css_vote "Enable friendly fire?" "Yes" "No"
css_vote "Restart round?" "Yes" "No"

Player Punishment

css_vote "Ban PlayerName for cheating?" "Yes" "No"
css_vote "Kick AFK player?" "Yes" "No"

Fun Rounds

css_vote "Fun round type?" "Knife only" "Deagle only" "Zeus only" "Normal"

Server Settings

css_vote "Round time?" "2 minutes" "3 minutes" "5 minutes"
css_vote "Max players?" "10v10" "5v5" "7v7"

Best Practices

Question Clarity

Good Questions:

  • Clear and concise
  • Specific
  • Easy to understand

Examples:

✅ css_vote "Change to de_dust2?" "Yes" "No"
❌ css_vote "Map?" "Yes" "No"  # Unclear what map

✅ css_vote "Restart this round?" "Yes" "No"
❌ css_vote "Restart?" "Yes" "No"  # Restart what?

Option Limits

Recommendations:

  • 2-5 options ideal
  • Too many options confuse players
  • Keep options brief

Examples:

✅ css_vote "Next map?" "dust2" "mirage" "inferno"
❌ css_vote "Next map?" "de_dust2" "de_mirage" "de_inferno" "de_nuke" "de_vertigo" "de_ancient" "de_anubis"

Timing

When to use votes:

  • End of round
  • Between maps
  • During downtime
  • Not during active gameplay

When NOT to use votes:

  • Mid-round
  • During clutch situations
  • Too frequently

Vote Spam Prevention

Don't spam votes:

❌ Multiple votes in quick succession
❌ Overlapping votes
❌ Votes every round

Wait for current vote to finish before starting another.


Vote Types

Administrative Votes

Map change:

css_vote "Change map now?" "Yes" "No"

Server restart:

css_vote "Restart server?" "Yes" "No"

Rule enforcement:

css_vote "Kick PlayerName?" "Yes" "No"

Gameplay Votes

Weapon restrictions:

css_vote "Disable AWP?" "Yes" "No"

Team scramble:

css_vote "Scramble teams?" "Yes" "No"

Round rules:

css_vote "Knife round first?" "Yes" "No"

Event Votes

Tournament:

css_vote "Start tournament?" "Yes, start now" "Wait 5 minutes" "No, cancel"

Custom game mode:

css_vote "Game mode?" "Hide and Seek" "Gungame" "Surf" "Normal"

Limitations

Technical Limits

  • Maximum ~10 options (depends on menu system)
  • One vote at a time
  • Requires active players to participate

Permission Required

Only admins with @css/generic permission can start votes.

To grant permission:

css_addadmin STEAMID "Name" "@css/generic" 50 0

Vote Results Handling

Manual Enforcement

Votes don't automatically execute actions. Admins must:

  1. See the results
  2. Manually execute the winning option

Example:

# Start vote
css_vote "Change to de_dust2?" "Yes" "No"

# If "Yes" wins, manually change map
css_map de_dust2

Why Manual?

  • Prevents abuse
  • Allows admin oversight
  • Gives control over execution

Advanced Usage

Combining with Commands

Use votes to decide, then execute:

# Vote on map
css_vote "Next map?" "dust2" "mirage" "inferno"
# If dust2 wins:
css_map de_dust2

# Vote on player kick
css_vote "Kick PlayerName?" "Yes" "No"
# If Yes wins:
css_kick PlayerName "Voted to be kicked"

Sequential Votes

Run multiple votes for complex decisions:

# First vote: Mode
css_vote "Game mode?" "Competitive" "Casual"

# If Competitive wins, second vote:
css_vote "Round time?" "2 min" "3 min" "5 min"

Configuration

Check if vote commands are enabled in:

addons/counterstrikesharp/configs/plugins/CS2-SimpleAdmin/Commands.json
{
  "Commands": {
    "css_vote": {
      "Aliases": [
        "css_vote"
      ]
    }
  }
}

To disable votes, remove all aliases:

{
  "Commands": {
    "css_vote": {
      "Aliases": []
    }
  }
}

Troubleshooting

Vote doesn't start

Check:

  • Do you have @css/generic permission?
  • Is command enabled in Commands.json?
  • Are there at least 2 options?

Players can't vote

Check:

  • Vote menu is showing
  • Players know how to vote (type number in chat)
  • Vote hasn't already ended

Vote results not showing

Check:

  • Wait for vote to complete
  • Check server console
  • Ensure voting system is working

Permission Requirements

Command Permission Description
css_vote @css/generic Create votes/polls

Tips

Effective Polling

  1. Ask clear questions - No ambiguity
  2. Limit options - 2-4 is ideal
  3. Time it right - Between rounds
  4. Follow through - Execute winning option
  5. Don't overuse - Votes lose impact if spammed

Community Engagement

Use votes to:

  • Involve community in decisions
  • Gauge player preferences
  • Create democratic server atmosphere
  • Get feedback on changes

Example Scenarios

New map test:

css_vote "Try new map cs_office?" "Yes" "No"

Event planning:

css_vote "Tournament this weekend?" "Saturday" "Sunday" "No thanks"

Rule feedback:

css_vote "Keep no-AWP rule?" "Yes" "No" "Only limit to 2"