# ModNVote<\/p>\n
**Privacy-first, GUI-driven community polling for PaperMC 1.21.x**<\/p>\n
ModNVote is a modern voting and polling plugin for Minecraft communities that want polls to be easy for players, practical for admins, and verifiable after the fact.<\/p>\n
ModNVote 2.x replaces the original Yes\/No-only workflow with a full poll lifecycle system supporting:<\/p>\n
– Ranked single-winner polls
\n– Yes\/No polls
\n– GUI-driven poll creation and editing
\n– Poll cloning for repeat or template-based polls
\n– Anonymous ballot storage
\n– Participation tracking separated from vote content
\n– Ballot proof-phrase verification
\n– Tamper-evident audit and integrity checks
\n– Optional external witness publication via Discord-compatible webhooks
\n– Manual and automatic integrity checkpoint publication
\n– Java\/Bedrock-friendly inventory interfaces
\n– Mandatory vote confirmation before submission
\n– `\/poll` as a short alias for `\/modnvote`<\/p>\n
Built for **PaperMC 1.21.x** and **Java 21**.<\/p>\n
> ModNVote is the spiritual successor to PineVote, rebuilt cleanly under the MODN METL brand with a stronger focus on privacy, transparency, and integrity.<\/p>\n
—<\/p>\n
## Key Features<\/p>\n
### GUI Poll Builder<\/p>\n
Admins can create and edit polls through an inventory GUI rather than a long sequence of setup commands.<\/p>\n
Supported builder flows:<\/p>\n
“`text The shorter alias can also be used:<\/p>\n “`text The builder lets admins configure:<\/p>\n – Poll title Fields use clear red\/green completion indicators:<\/p>\n – **Red** = still needs work When the poll is valid, the READY control turns green and the poll can be staged for opening.<\/p>\n —<\/p>\n ### Poll Cloning<\/p>\n Admins can clone an existing poll into a new editable draft:<\/p>\n “`text This is useful for recurring polls where some options, wording, or settings are reused.<\/p>\n Cloning copies the poll definition and options, but does **not** copy ballots, participation records, lifecycle timestamps, proof phrases, or audit history.<\/p>\n —<\/p>\n ### Ranked Single-Winner Polls<\/p>\n Ranked polls let players order choices by preference.<\/p>\n Admins can create a ranked poll with:<\/p>\n “`text Players then vote through a GUI using:<\/p>\n “`text Ranked voting includes:<\/p>\n – Click-to-rank options —<\/p>\n ### Yes\/No Polls<\/p>\n Yes\/No polls are still fully supported, now as part of the 2.x poll lifecycle.<\/p>\n Admins can create one with:<\/p>\n “`text The plugin uses protected canonical Yes and No options while still supporting the new GUI setup and lifecycle flow.<\/p>\n —<\/p>\n ### Anonymous Ballots<\/p>\n ModNVote is built around one core rule:<\/p>\n > Anonymous ballots are the source of truth for vote content.<\/p>\n The plugin deliberately separates:<\/p>\n | Data | Purpose | This means results are calculated from anonymous ballots only, not from identity-aware participation records.<\/p>\n —<\/p>\n ### Verification Without Revealing Vote Content<\/p>\n Players can verify participation:<\/p>\n “`text This confirms whether their participation was recorded without revealing how they voted.<\/p>\n Players can also verify a ballot proof phrase:<\/p>\n “`text Proof phrases act like bearer tokens. Anyone with the phrase can verify that ballot reference, so players should keep them private.<\/p>\n —<\/p>\n ### Audit, Integrity Checks, and Witness Publication<\/p>\n ModNVote is designed to make tampering detectable.<\/p>\n Integrity features include:<\/p>\n – Anonymous ballot hash checks ModNVote can publish privacy-safe witness events to configured Discord-compatible webhooks.<\/p>\n Supported witness events include:<\/p>\n – Poll opened “`text Witness publication does **not** publish player names, UUIDs, IP addresses, proof phrases, participation receipts, or per-player vote content.<\/p>\n Webhook delivery is best-effort and non-blocking. A failed webhook does not cancel voting, poll opening, poll closing, checkpointing, or persistence.<\/p>\n —<\/p>\n ### Java and Bedrock Friendly GUI<\/p>\n The GUI intentionally avoids decorative glass panes.<\/p>\n This keeps the interface simpler and more compatible with Bedrock players while still providing clear interaction cues through:<\/p>\n – Item names —<\/p>\n ## Main Commands<\/p>\n All commands are rooted at:<\/p>\n “`text The shorter alias is also available:<\/p>\n “`text ### Admin workflow<\/p>\n “`text ### Player workflow<\/p>\n “`text ### Utility<\/p>\n “`text All examples above can also be run with `\/poll` instead of `\/modnvote`.<\/p>\n Some older low-level setup commands may remain callable as recovery tools, but normal poll setup should use the GUI builder.<\/p>\n —<\/p>\n ## Privacy Model<\/p>\n ModNVote avoids storing voter identity and vote content together.<\/p>\n Participation records are identity-aware because the plugin needs to know who has already voted. Anonymous ballots store the vote content. These two systems are deliberately separate.<\/p>\n This allows the plugin to:<\/p>\n – Prevent duplicate voting `\/modnvote verify participation` must not reveal vote content.<\/p>\n `\/modnvote result` must use anonymous ballots only.<\/p>\n External witness publication is poll-level only and must not reveal player-specific vote data.<\/p>\n —<\/p>\n ## Poll Lifecycle<\/p>\n Polls move through explicit states:<\/p>\n “`text Typical flow:<\/p>\n “`text DRAFT polls can be edited in the Poll Builder. READY polls can be opened. OPEN polls accept votes. CLOSED polls can report results.<\/p>\n —<\/p>\n ## Webhook Configuration<\/p>\n Webhook publication is configured in `plugins\/ModNVote\/config.yml`.<\/p>\n A single webhook should be configured as a YAML list:<\/p>\n “`yaml integrity: Use `discord_webhooks: []` to disable webhook publication.<\/p>\n Multiple webhooks are supported by adding more `- …` lines.<\/p>\n Never commit real webhook URLs to source control.<\/p>\n —<\/p>\n ## PlaceholderAPI<\/p>\n PlaceholderAPI support was part of the legacy 1.x plugin.<\/p>\n For ModNVote 2.x, please check the current release notes and repository documentation for the latest PlaceholderAPI status before relying on placeholders in production dashboards.<\/p>\n —<\/p>\n ## Requirements<\/p>\n – **Server:** PaperMC 1.21.x —<\/p>\n ## Installation<\/p>\n 1. Download the latest `modnvote-*.jar`. “`text or:<\/p>\n “`text ModNVote 2.x is a clean-install release. Migration from legacy 1.x databases is not currently supported.<\/p>\n —<\/p>\n ## Permissions<\/p>\n Permissions are defined in `plugin.yml`.<\/p>\n Common permissions include:<\/p>\n “`text Duplicate-prevention bypass support remains configurable through the plugin configuration.<\/p>\n —<\/p>\n ## Roadmap<\/p>\n Potential future 2.x work includes:<\/p>\n – Multi-winner STV —<\/p>\n ## License & Credits<\/p>\n – License: **MIT** If you use ModNVote on your server, a star on the GitHub repo is always appreciated.<\/p>\n","protected":false},"excerpt":{"rendered":" Privacy-first GUI polling for Paper\/Folia: ranked voting, Yes\/No polls, anonymous ballots, verification, and audit integrity.<\/p>\n","protected":false},"featured_media":104563,"template":"","meta":{"_minecraft_slug":"modn-vote","_minecraft_project_id":"yTxmV2La","_minecraft_author":"MODNMETL","_minecraft_license":"MIT","_minecraft_downloads":48,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"modn-vote.zip","_minecraft_size_bytes":41503346,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T21:10:18.932649Z","_minecraft_date_created":"2025-11-18T00:34:23.496052Z","_minecraft_date_modified":"2026-05-09T15:01:32.269683Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/modn-vote","_minecraft_icon_attachment_id":104563,"_minecraft_imported_at":"2026-06-06T00:36:42+00:00","_minecraft_import_hash":"df67bb3d17b98843bd8643027842617d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,867],"mod_loader":[131,132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-104562","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-social","mod_loader-folia","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n\/modnvote create ranked_single_winner
\n\/modnvote create yes_no
\n\/modnvote edit
\n“`<\/p>\n
\n\/poll create ranked_single_winner
\n\/poll create yes_no
\n\/poll edit
\n“`<\/p>\n
\n– Poll description
\n– Option names
\n– Option descriptions
\n– Ranked poll partial-ranking behaviour
\n– Ranked poll maximum ranking count<\/p>\n
\n– **Green** = complete<\/p>\n
\n\/modnvote clone
\n\/modnvote create ranked_single_winner 5
\n“`<\/p>\n
\n\/modnvote vote
\n– Stable paper option icons
\n– Tooltip text showing current rank
\n– Optional partial-ranking support
\n– Configurable max rankings
\n– Mandatory review\/confirmation before the ballot is cast<\/p>\n
\n\/modnvote create yes_no
\n“`<\/p>\n
\n|—|—|
\n| Anonymous ballots | Store vote content and drive results |
\n| Participation records | Track who participated and prevent duplicates |
\n| Audit records | Provide lifecycle and integrity evidence |
\n| Proof phrases | Let players verify ballots without exposing identity links |<\/p>\n
\n\/modnvote verify participation
\n\/modnvote verify ballot
\n– Ballot proof commitment checks
\n– Participation inclusion checks
\n– Poll lifecycle audit records
\n– Audit chain validation
\n– Result calculation from anonymous ballots only
\n– Optional witness checkpoint publication<\/p>\n
\n– Poll closed, including a public result summary
\n– Automatic integrity checkpoints every configured number of accepted ballots
\n– Manual integrity checkpoints via:<\/p>\n
\n\/modnvote checkpoint
\n– Item lore
\n– Wrapped multiline descriptions
\n– Red\/green builder state
\n– Confirmation screens<\/p>\n
\n\/modnvote
\n“`<\/p>\n
\n\/poll
\n“`<\/p>\n
\n\/modnvote guide
\n\/modnvote create ranked_single_winner
\n\/modnvote create yes_no
\n\/modnvote edit
\n\/modnvote clone
\n\/modnvote show
\n\/modnvote vote
\n\/modnvote verify participation
\n\/modnvote status
\n\/modnvote reload
\n“`<\/p>\n
\n– Verify that a player participated
\n– Calculate results from ballot content
\n– Avoid exposing how a named player voted<\/p>\n
\nDRAFT -> READY -> OPEN -> CLOSED
\n“`<\/p>\n
\ncreate -> edit in builder -> mark READY -> open -> players vote -> close -> result
\n“`<\/p>\n
\npublication:
\n discord_webhooks:
\n – “https:\/\/discord.com\/api\/webhooks\/WEBHOOK_ID\/WEBHOOK_TOKEN”
\n publish_poll_opened: true
\n publish_poll_closed: true
\n publish_checkpoints: true<\/p>\n
\n checkpoint_interval_ballots: 25
\n“`<\/p>\n
\n– **Java:** 21
\n– **Database:** SQLite
\n– **Optional:** PlaceholderAPI, where supported by the current build<\/p>\n
\n2. Drop it into your server’s `plugins` folder.
\n3. Restart the server.
\n4. Configure permissions with your permissions plugin.
\n5. Create a test poll with:<\/p>\n
\n\/modnvote create yes_no
\n“`<\/p>\n
\n\/modnvote create ranked_single_winner 3
\n“`<\/p>\n
\nmodnvote.admin.poll.create
\nmodnvote.admin.poll.list
\nmodnvote.admin.poll.open
\nmodnvote.admin.poll.close
\nmodnvote.admin.reload
\nmodnvote.verify
\nmodnvote.testvote
\n“`<\/p>\n
\n– Combined elections such as Mayor + Council
\n– Exportable signed audit snapshots
\n– Advanced reporting and dashboards
\n– Dedicated GUI delete confirmation flow
\n– Additional admin transparency tooling
\n– Multi-target witness publication beyond Discord-compatible webhooks<\/p>\n
\n– Copyright: **MODN METL LTD**
\n– Developed by **Jamie E. Thompson (@jamjet3)**
\n– Community testing: **Pinecraft Equestrian SMP**<\/p>\n