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

PocketVote

by ProjectInfinity

Fast, extensible and scalable voting solution for PocketMine servers
version 3.0.0
Approved
Direct Download How to install?
Switch version
914 Downloads / 11993 Total
17 Reviews
Submitted on 11 Jun 2019 from Dev Build #50, Approved on 14 Jun 2019
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 §
  • 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]
ThorMagHunde
using v3.0.3
30 Apr 23
Was actually a good plugin. But please update to API 4.20.1 or 4.0.0
InvalidNoah
using v3.0.3
02 Aug 22
pls update to api 4.0.0
RAzazelo
using v3.0.3
03 Feb 22
update to 4.0.0 api
LeontKing2
using v3.0.3
04 Aug 21
I know how this plugin works but the projects forget password thing doesnt work.. please help
blankevolved
using v3.0.3
17 Jun 21
MineGuy112
 Outdated
using v3.0.1
04 May 21
cheeseland-dev
 Outdated
using v3.0.1
11 Feb 21
crashes frequently due to not being able to ping correctly
ProjectInfinity
15 May 21
You can try this build. https://github.com/ProjectInfinity/PocketVote-PocketMine/releases/tag/v3.0.3
Altamash347
 Outdated
using v3.0.1
11 Sep 20
The Best plugin i have every seen, and the people who are saying that its crashing on vote, this is because you havent set it up properly. I would recommend set it up from in-game because config.yml is confusing to some people. Really Good Plugin
ViruZzInGame
 Outdated
using v3.0.1
25 May 20
good plugin but when player vote server crash, i opened issue on Github
Mitzythecat
 Outdated
using v3.0.1
01 May 20
Its a great plugin but i need help. i contacted you on discord.
JGYTVevo
 Outdated
using v3.0.1
24 Apr 20
When i add the link it says error api token
BootheBoys
 Outdated
using v3.0.1
01 Aug 19
Works great, good job!
WolFoxHD
 Outdated
using v3.0.0
29 Aug 20
No suport altay :(
KhoaGamingVN
 Outdated
using v2.1.4
30 Jul 18
SOF3
 Staff Outdated
using v2.1.2
03 May 18
Tumeden
 Outdated
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
 Outdated
using v2.0.2
06 Aug 18
How does it work because is not working currently?

Reply to review by :

/ 5
Supported API versions
3.0.0
->
3.25.6
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
Keywords
Permissions
Permissions
Commands
External Internet clients
Asynchronous tasks
Direct Download

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

/ 5
Loading...