VoteControl
Democratic Moderation. One Vote At A Time.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
VoteMute ◆ VoteKick ◆ Interactive GUI ◆ MySQL + SQLite + YAML ◆ Discord Webhooks ◆ Paper 1.21
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What VoteControl Solves
Staff teams are not online 24/7. Toxic players ruin the experience and there is nothing the community can do about it except wait and report.
VoteControl fixes that. It puts moderation power directly into the hands of your players through a democratic voting system. No staff needed. No delays. Your community decides who deserves a mute or a kick, casting their votes through a polished interactive GUI with real-time results.
Every value is configurable. Every mechanic is tunable. One plugin, zero compromises.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Core Features
Core Features
◆ VoteMute System
- Start a vote to temporarily mute disruptive players
- Configurable mute duration with escalation tiers for repeat offenders
- Immunity period after a vote ends to prevent harassment
◆ VoteKick System
- Start a vote to remove troublemakers from the server
- Requires a reason with configurable minimum length
- Custom kick message showing vote results to the removed player
◆ Interactive Voting GUI
- Beautiful inventory GUI with YES / NO buttons
- Real-time vote count updates displayed on the buttons
- Detailed info panel showing target, initiator, duration, time remaining, and required threshold
- Configurable refresh interval for live vote tracking
◆ Boss Bar + Title Notifications
- Live boss bar showing vote question, YES/NO counts, and remaining time
- Animated title and subtitle on vote start and end
- Configurable colors, styles, and MiniMessage formatting
◆ Discord Webhook Integration
- Rich embed notifications for vote start, vote end, and punishment applied
- Separate webhook URLs per event type or use one for all
- Customizable embed colors, footer, thumbnail, and timestamps
- Role mention support for instant staff alerts
◆ Punishment Escalation
- Progressive punishment tiers for repeat offenders
- Configurable multipliers per offense count
- Automatic reset after a configurable period
◆ Vote Configuration
- Per-type threshold mode: percentage of online players or percentage of participants
- Separate pass thresholds for mute (60%) and kick (75%)
- Configurable vote duration, cooldowns, and maximum concurrent votes
- Minimum voters required to prevent abuse on empty servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
How VoteControl Compares
How VoteControl Compares
| Feature | VoteControl | Typical Vote Plugin |
| Voting interface | Interactive GUI with real-time updates | Chat-based voting or command only |
| Real-time display | Boss bar + GUI + Titles | None or basic action bar |
| Storage options | MySQL (HikariCP), SQLite, or YAML | Flat file only or no persistence |
| Discord integration | Rich embeds with customizable webhooks | None or simple text message |
| Threshold system | Per-type modes and percentages | Fixed percentage for all types |
| Punishment escalation | Progressive tiers with auto-reset | None or static duration |
| Sound effects | Configurable sounds for every event | None |
| Multi-language | English + Polish with easy translation | Hardcoded messages |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Who This Is For
Who This Is For
- Anarchy and semi-anarchy servers Let the community self-moderate when no staff are online. VoteControl fills the gap between chaos and order.
- Survival and SMP servers Give players a fair way to deal with griefers and toxic members without admin intervention. The escalation system ensures repeat offenders face harsher consequences.
- Small to medium networks No dedicated moderation team? No problem. Your player base becomes the jury with a clean, intuitive voting GUI.
- Minigame servers Quick votekick for abusive players mid-game without interrupting the action. Configurable cooldowns keep things balanced.
- Network owners Drop VoteControl into any Paper 1.21 server. Single-command install, full reload support, no restarts needed for config changes. Discord webhooks keep your off-server staff informed in real time.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Technical Specs
Technical Specs
| Server | Paper 1.21, Java 21 |
| Dependencies | None. All storage drivers are shaded into the jar. |
| Storage | MySQL via HikariCP, SQLite, or YAML flat-file |
| Languages | en_US, pl_PL (customizable via messages.yml) |
| Discord | Rich embeds, separate webhooks per event, role mentions |
◆ Commands
| Command | Description | Permission |
| /votemute <player> [duration] | Start a vote to mute a player | votecontrol.mute.create |
| /votekick <player> <reason> | Start a vote to kick a player | votecontrol.kick.create |
| /votegui | Open the active vote GUI | votecontrol.vote |
| /voteadmin history | View vote history | votecontrol.admin |
| /voteadmin stats <player> | View player vote statistics | votecontrol.admin |
| /voteadmin active | List all active votes | votecontrol.admin |
| /voteadmin cancel | Cancel the most recent vote | votecontrol.admin |
| /voteadmin reload | Reload configuration without restart | votecontrol.admin |
◆ Permissions
| Permission | Description | Default |
| votecontrol.mute.create | Create vote to mute players | true |
| votecontrol.kick.create | Create vote to kick players | true |
| votecontrol.vote | Cast votes via /votegui | true |
| votecontrol.admin | Access to all admin commands | op |
| votecontrol.exempt | Cannot be targeted by votes | op |
| votecontrol.bypass.cooldown | Bypass vote cooldowns | false |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Get VoteControl
Your community already knows who the problem players are.
Give them the tools to do something about it.
Interactive GUI. Live boss bar. Discord webhooks. Full configuration. One plugin.
Download and have it running in under 5 minutes.
Questions? Ask in our Discord. Feature requests are reviewed.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Get VoteControl
Your community already knows who the problem players are.
Give them the tools to do something about it.
Interactive GUI. Live boss bar. Discord webhooks. Full configuration. One plugin.
Download and have it running in under 5 minutes.
Questions? Ask in our Discord. Feature requests are reviewed.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
