By continuing to use this site, you agree to the Terms of Service of this website, including usage of cookies.

OK, Don't show this again

Fast, extensible and scalable voting solution for PocketMine servers
version 3.0.1
Approved
Direct Download How to install?
Switch version
1502 Downloads / 4825 Total
5 Reviews
Plugin Description §

Overview

The best fast, extensible and scalable voting solution for PocketMine servers.

PocketVote acts as a smart-funnel for voting. You can use as many voting sites as you want and your server will never communicate with more than PocketVote's servers.

Because PocketVote acts as a funnel we're also capable of turning off the stream of votes if your sever goes offline which means no votes are lost!

Are you sold yet? If not here's a short list of some of our features:

  • Automated voting (no commands needed)
  • Your very own https://mcpe.guru vote link that can be managed in-game
  • Run any command when a vote is received
    • Limit commands to users which certain permissions
    • Choose whether to run command immediately or wait for the player to be online
  • Voting statistics
  • Multi-server support
  • Third-party support through custom events and the PocketVote API

Start voting today!

Support (Discord)

Getting started

  1. Download the latest version of the plugin from https://poggit.pmmp.io/p/pocketvote
  2. Start your server once after putting the plugin into your plugins directory
  3. Sign up at https://pocketvote.io
  4. Add your server
  5. Click settings and then show secrets
  6. Take the information shown and enter it into your config.yml, place secret into secret field and identity/identifier in the identity field. Since PocketVote v3.0 you can also do this via the GUI that shows up when a OP logs in while both secret and identity is not set.

Configuration

Key Description
version Used to track how the configuration should be altered in order to be completely up to date.
identity The identity given to you from PocketVote.io which is used to identify your server.
secret The secret given to you from PocketVote.io which is given to voting sites.
lock If set to true, the commands to alter secret or identity is disabled.
vote-expiration An amount of time to keep votes that have not been redeemed by a player, specified in days.
onvote A list of commands that are to be ran when a vote is retrieved. The following variables can be used in the commands: %player, %site, %ip.
votes A list of votes waiting for players to log on. Please leave this alone.

Commands

Command Permission Description
/vote pocketvote.vote Shows the MCPE.guru voting link associated with the server.
/vote top pocketvote.vote Shows the top voters the past month.
/pocketvote identity [identity] pocketvote.admin This sets your plugin’s identity to the one you provided. Get your server’s identity from the server dashboard at pocketvote.io.
/pocketvote secret [secret] pocketvote.admin This sets your plugin’s secret to the one you provided. Get your server’s secret from the server dashboard at pocketvote.io.
/pocketvote cmd list pocketvote.admin Lists the commands that will run when a player votes.
/pocketvote cmd add [command] pocketvote.admin Adds a command that is ran when a player votes. The following variables can be used in the command and will be replaced by the correct data: %player, %ip and %site. Note that this command runs immediately as a player votes, regardless of whether they are online or not.
/pocketvote cmd remove [id] pocketvote.admin Removes the specified command. Use ‘cmd list’ to find the command id.
/pocketvote cmdo list pocketvote.admin Lists the commands that will run when a player votes and is online.
/pocketvote cmdo add [command] pocketvote.admin Adds a command that is ran when a player votes and is online. The following variables can be used in the command and will be replaced by the correct data: %player, %ip and %site. Note that this command runs only when the player is online! If they are not online while voting this command will not run until they log on.
/pocketvote cmdo remove [id] pocketvote.admin Removes the specified command. Use ‘cmdo list’ to find the command id.
/pocketvote link [name] pocketvote.admin Attempts to set your MCPE.guru link to the provided name. Your link will look something like this mcpe.guru/[name].
TODO: MCPE.guru commands!

Plugins that support PocketVote

Made a plugin that supports PocketVote? Let me know! Open an issue on GitHub.

  • PocketLotto - A lottery plugin for PocketMine with support for PocketVote.
  • TopVoter - A plugin that lists top voters using FloatingTextParticles.
What's new §
  • Fixed an error message that would occur during the top voter task despite there being no error.
  • Add GUI for first time setup.
  • Add GUI for vote list and deletion.
  • Add permission support
  • Add safeguard in DiagnoseTask in case API does not return valid JSON
  • Add simple API for getting top voters and move top voters into task
  • Introduce permissions and a GUI on /pocketvote
  • Fix error on topvoter task if there is no payload
  • [IMPORTANT!!] Multi-server support is now handled on PocketVote backend, MySQL support has been removed
  • [IMPORTANT] Commands have been migrated to the "onvote" key (previously onvote.cmd and onvote.cmdo)
  • You can now add vote links using /guadd (without any arguments) via a GUI
  • Update to comply with C2a
  • More API 3.0.0 updates.
  • Set API version to minimum 3.0.0.
  • Update plugin to api 3.0.0
  • Adds extra validation to catch potential errors from the backend API.
  • Add VRC (Poweruser feature. Ask on Gitter if you want to know how it works) support.
  • Update supported APIs to Alpha12
  • Fix vote insertion on master servers.
  • Update version

This release updates PocketVote to work with the latest version of PMMP that requires more strict type hinting and return types.

This release adds the /pocketvote diagnose command which lets you test your configuration for issues.

Version 2.0 of PocketVote introduces a bunch of new features and bugfixes! The summary below is not complete but should give you enough to determine whether you want to update or not.

  • Brand spankin' new API!
    • The new API is faster, more reliable and allows for way more features than v1!
  • Votes now expire periodically in addition to when a player logs on.
    • Previously if a player did not log on, there was no way to expire votes that had not been claimed by logging on.
  • Votes can now be retrieved quicker than before. The scheduler will dynamically change frequency depending on PocketVote server load.
  • NEW command '/vote'
    • Permission node: pocketvote.vote
    • Typing '/vote' shows a link to a new url shortener where you can add all your known voting sites.
      • This is directly integrated into PocketVote and requires NO setup from your end!
    • Typing '/vote top' shows a list of the top voters the the past month.
      • Please note that you will need to wait for the servers to generate this data, it is not generated on-the-fly.
  • NEW command '/guru'
    • Permission node: pocketvote.admin
    • Shows a help list of all MCPE.guru related commands.
  • NEW command '/gulist'
    • Permission node: pocketvote.admin
    • Shows a list of all your current sites added to your voting link.
  • NEW command '/guadd [title] [url]'
    • Permission node: pocketvote.admin
    • Adds the url to your voting link, title is optional.
  • NEW command '/gudel [id]'
    • Permission node: pocketvote.admin
    • Deletes the specified url from your voting link.
      • Use '/gulist' to find the ids of your entries.
  • NEW sub-command '/pocketvote link [name]'
    • Permission node: pocketvote.admin
    • Attempts to set your voting link to the specified name.
      • Your link will look like this: mcpe.guru/[name]

BootheBoys
using v3.0.1
01 Aug 19
Works great, good job!
KhoaGamingVN
using v2.1.4
30 Jul 18
SOF3
Staff
using v2.1.2
03 May 18
Tumeden
using v2.0.3
18 Nov 17
Works really good, and supports a multi-server setup flawlessly. Definitely recommend this plugin over the alternative!
Wolfkid200444
using v2.0.2
06 Aug 18
How does it work because is not working currently?

Reply to review by :

Supported API versions
3.0.0
->
3.10.0
Requirements & Enhancements
API token Requirement PocketVote secret and identity from https://pocketvote.io
License §

Custom license

View
You are free to download and alter the plugin for private use, redistribution is forbidden without permission.

Submitting pull requests are highly encouraged.

You are not allowed to use the plugin commercially, this means you may not put the system behind a paywall but you are allowed to use the plugin when running a server with the intent of making money. This rule regarding resale is directly targeted towards non-partnered server hosts.
Categories:
General
Admin Tools
Miscellaneous
Permissions
Permissions
Commands
External Internet clients
Asynchronous tasks

You can leave one review per plugin release, and delete or update your review at any time

Loading...