Testet only on mc version 1.21.11<\/p>\n
flexible in-game voting and polling system for Bukkit\/Spigot\/Paper servers.
\nAdmins can create command-based polls, while regular players can create restricted, silent polls from admin-approved templates. Polls are displayed in a GUI, support repetition, reminders, persistence, and multilingual messages.<\/p>\n
—<\/p>\n
## Features<\/p>\n
* In-game YES \/ NO voting
\n* Admin-controlled polls with full configuration
\n* Player-created polls limited to whitelisted templates
\n* Optional repeating polls
\n* Silent polls (no broadcast or reminders)
\n* GUI-based poll list and detailed view
\n* Persistent storage (survives restarts)
\n* Configurable reminders
\n* Language and message customization
\n* Vote history tracking<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Place the plugin JAR into the `plugins\/` folder
\n2. Start the server once to generate config files
\n3. Configure:<\/p>\n
* `config.yml`
\n * `lang.yml`
\n * `polls.yml`
\n * `history.yml`
\n4. Reload configuration with:<\/p>\n
“`
\n \/votepoll reload
\n “`<\/p>\n
—<\/p>\n
## Core Concepts<\/p>\n
### Poll<\/p>\n
A poll represents a vote with the following properties:<\/p>\n
* Unique ID (random or specified)
\n* Display name
\n* Description
\n* Console command to execute on success
\n* Duration (seconds)
\n* Minimum YES \/ NO votes
\n* Optional repeat interval
\n* Silent flag
\n* Creator (player, admin, or console)<\/p>\n
Supported command placeholders:<\/p>\n
* `{target}`
\n* `{creator}`<\/p>\n
—<\/p>\n
### Templates (`customCommands`)<\/p>\n
Poll templates defined in `config.yml`.
\nThey are reusable and safe predefined commands.<\/p>\n
Only templates listed in `playerAllowedCommands` can be used by non-admin players.<\/p>\n
—<\/p>\n
### Player-Created Polls<\/p>\n
* Can only be created from allowed templates
\n* Always receive a random poll ID
\n* Always silent
\n* No global notifications or reminders
\n* Visible only via GUI<\/p>\n
Example:<\/p>\n
“`
\n\/votepoll add example_ban –target=RareHuman
\n“`<\/p>\n
—<\/p>\n
### Admin-Created Polls<\/p>\n
* Full control over all poll parameters
\n* Can broadcast to players
\n* Can send reminders
\n* Can be repeating or silent
\n* Can specify custom IDs<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
Open poll GUI:<\/p>\n
“`
\n\/votepoll
\n“`
\nPreview the poll info:<\/p>\n
“` Create a poll from an allowed template:<\/p>\n “` Vote on a poll:<\/p>\n “` Toggle reminders:<\/p>\n “` Set language:<\/p>\n “` —<\/p>\n ### Admin Commands (`votepoll.admin` or OP)<\/p>\n Create a poll:<\/p>\n “` Supported flags:<\/p>\n * `–target=PLAYER` Examples:<\/p>\n “` Other admin commands:<\/p>\n “` —<\/p>\n ## GUI<\/p>\n ### Active Votes GUI<\/p>\n * Lists all active polls * Name ### Poll Detail GUI<\/p>\n * Shows the same information as notifications —<\/p>\n ## Notifications and Reminders<\/p>\n * Admin-created polls:<\/p>\n * Broadcast on creation * Never broadcast —<\/p>\n ## Persistence<\/p>\n * `polls.yml` stores active polls —<\/p>\n ## Configuration Example<\/p>\n “`yaml playerAllowedCommands: customCommands: messages: —<\/p>\n ## Permissions<\/p>\n | Permission | Description | —<\/p>\n ## Important Behavior<\/p>\n * Players receive a permission error if the template is not listed in `playerAllowedCommands` —<\/p>\n","protected":false},"excerpt":{"rendered":" flexible in-game voting and polling system for Bukkit\/Spigot\/Paper servers. Admins can create command-based polls, while regular players can create restricted, silent polls from admin-approved templates.<\/p>\n","protected":false},"featured_media":99213,"template":"","meta":{"_minecraft_slug":"mc-voting-polls","_minecraft_project_id":"bqJglybz","_minecraft_author":"micegan","_minecraft_license":"MIT","_minecraft_downloads":25,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mc-voting-polls.zip","_minecraft_size_bytes":49946,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:20:55.169203Z","_minecraft_date_created":"2026-01-30T04:56:42.762105Z","_minecraft_date_modified":"2026-01-29T17:08:20.608573Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mc-voting-polls","_minecraft_icon_attachment_id":99213,"_minecraft_imported_at":"2026-06-05T16:48:03+00:00","_minecraft_import_hash":"5eac8f1f3344e45bf1df2a14ed0daa0f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[41],"class_list":["post-99212","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-11"],"yoast_head":"\n
\n\/preview
\n“`<\/p>\n
\n\/votepoll add
\n“`<\/p>\n
\n\/vote
\n\/vote
\n“`<\/p>\n
\n\/votepoll notify on
\n\/votepoll notify off
\n“`<\/p>\n
\n\/votelang
\n“`<\/p>\n
\n\/votepoll add [id]
\n“`<\/p>\n
\n* `–repeat`
\n* `–repeat=SECONDS`
\n* `–interval=SECONDS`
\n* `–silent`
\n* `–display=NAME`<\/p>\n
\n\/votepoll add banVote 300 5 3 “Ban toxic player” ban {target} –target=BadPlayer
\n\/votepoll add 600 4 2 “Restart server?” restart –silent
\n“`<\/p>\n
\n\/votepoll cancel
\n\/votepoll reload
\n\/votepoll preview
\n“`<\/p>\n
\n* Displays full poll information:<\/p>\n
\n * Description
\n * Command
\n * End date
\n * Creator
\n * Required YES \/ NO votes
\n * Poll ID
\n * Time remaining
\n * Vote command<\/p>\n
\n* Includes YES and NO voting buttons<\/p>\n
\n * Periodic reminders based on `reminderIntervalSeconds`
\n* Player-created polls:<\/p>\n
\n * Never send reminders
\n* Players can opt out of reminders individually<\/p>\n
\n* `history.yml` stores completed polls
\n* Polls resume correctly after server restart<\/p>\n
\nreminderIntervalSeconds: 1800
\ndefaultRepeatIntervalSeconds: 60<\/p>\n
\n – “example_ban”<\/p>\n
\n – id: “example_ban”
\n display: “Ban example player”
\n description: “Ban a player for breaking rules”
\n command: “ban {target} Breaking server rules”
\n durationSeconds: 300
\n minYes: 5
\n minNo: 3
\n repeat: false
\n repeatIntervalSeconds: 0<\/p>\n
\n usage_votepoll: “&cUsage: \/votepoll add|cancel|list|reload|notify”
\n no_permission: “&cYou don’t have permission to do that.”
\n usage_cancel: “&cUsage: \/votepoll cancel
\n unknown_subcommand: “&cUnknown subcommand.”
\n vote_failed: “&cUnable to vote.”
\n poll_canceled: “&cVote canceled: &6{display} (id: {id})”
\n broadcast_new_poll: “&aNew vote created: &6{display} &f(id: {id})”
\n vote_passed: “&aVote passed: &6{display}”
\n vote_failed: “&cVote failed: &6{display}”
\n vote_passed_majority: “&aVote passed (majority): &6{display}”
\n vote_failed_majority: “&cVote failed (majority): &6{display}”
\n“`<\/p>\n
\n| —————- | —————————————– |
\n| `votepoll.admin` | Full administrative access |
\n| none | Required for voting and allowed templates |<\/p>\n
\n* Player-created polls are silent by design
\n* If a repeating poll has no valid interval, `defaultRepeatIntervalSeconds` is used<\/p>\n