VoteMe

<div align="center"> ``` __ __ _ _ __ __ \ \ / /__ | |_ ___| |\/| | \/ | ___ \ V / _ \| __/ _ \ |\/| | |\/| |/ _ \ \_/ \___/\__\___/_| |_||_| |_|\___/ ``` **Turn every vote into a reward. No ports. No daemons. Just a clean API.** (https://img.shields.io/badge/License-MIT-gold.svg)](LICENSE) (https://img.shields.io/badge/Minecraft-1.21.1-brightgreen.svg)]() (https://img.shields.io/badge/API-Paper%20%2F%20Spigot-blue.svg)]() (https://img.shields.io/badge/Author-Herza-purple.svg)]() </div> --- ## What is VoteMe? VoteMe is a lightweight, pure API-based voting plugin for Java Edition servers. Players open a clean chest GUI, click a site, and their reward lands in their inventory — no port forwarding, no external listener, no daemon process needed. It supports two of the biggest Minecraft server listing sites out of the box, and every single piece of behavior — sounds, messages, rewards, GUI title, vote party threshold — is configurable down to the last character. --- ## Feature Overview ``` /vote Opens a 27-slot chest GUI /vote list Lists all vote site links in chat Join Reminder Tells players how many votes they haven't claimed yet Dual API Support Minecraft Pocket Servers + Minecraft-MP, one or both Fully Async Zero impact on main thread — all API calls are non-blocking Reward System Any console command as a reward (items, money, permissions) Vote Party Server-wide reward event when a vote milestone is hit Sound Feedback Villager + XP Orb sounds for every vote outcome PlaceholderAPI 4 ready-to-use placeholders for scoreboards Hot Reload /votereload — no restart needed after config changes ``` --- ## Requirements | Requirement | Version | Notes | |---|---|---| | Java | 21+ | | | Paper or Spigot | 1.21.1 | Also runs on Purpur, Pufferfish, and other forks | | PlaceholderAPI | Any | Optional — unlocks `%voteme_*%` placeholders | --- ## Installation **Step 1.** Drop `VoteMe.jar` into your `/plugins` folder. **Step 2.** Start the server once to generate the config file at `plugins/VoteMe/config.yml`. **Step 3.** Open the config and fill in your API key(s) and server page URL(s). **Step 4.** Run `/votereload` in-game or from console. Done. --- ## Configuration ```yaml # ╔══════════════════════════════════════════════════════════╗ # VoteMe Configuration — by Herza # ╚══════════════════════════════════════════════════════════╝ # ── Vote Sites ───────────────────────────────────────────── # Set api-key to "" to disable that site. # You can run one site, or both at the same time. minecraft-pocket: api-key: "" name: "Minecraft Pocket Servers" url: "https://minecraftpocket-servers.com/server/YOUR_ID" minecraft-mp: api-key: "" name: "Minecraft-MP" url: "https://minecraft-mp.com/server/YOUR_ID" # ── Join Reminder ────────────────────────────────────────── # When a player joins, VoteMe checks all enabled sites. # If unclaimed votes exist, the player gets a private message. # Set to false to disable. join-reminder: true # ── Rewards ──────────────────────────────────────────────── # Console commands executed when a player claims a vote. # Variable: {player} rewards: - "give {player} diamond 1" - "eco give {player} 500" # ── Messages ─────────────────────────────────────────────── # Supports & color codes. Variables: {player}, {link} # Set any value to "" to disable that message. messages: success: "&a &fThank you for voting, &e{player}&f! Rewards sent." already-claimed: "&e &fYou already claimed your reward today." not-voted: "&c &fYou haven't voted yet. Head to: &e{link}" error: "&c &fCould not reach the voting API. Try again later." # ── Broadcast ────────────────────────────────────────────── # Sent to ALL online players when someone claims a vote. # Variables: {player}, {link}. Set to to disable entirely. broadcast: - "&6 &e{player} &fjust claimed their vote rewards! Vote at &e{link}&f." # ── Vote Party ───────────────────────────────────────────── # Fires every time total votes hit a multiple of this number. # Set to 0 to disable vote party entirely. vote-party: 50 # Console commands run for EVERY online player when the party fires. # Variable: {player} vote-party-rewards: - "give {player} diamond 5" # ── GUI ──────────────────────────────────────────────────── gui: title: "&8» &6&lVoteMe &8«" # ╔══════════════════════════════════════════════════════════╗ # PlaceholderAPI — requires PlaceholderAPI plugin # # %voteme_total_votes% All-time total votes recorded # %voteme_party_progress% Votes in the current party cycle # %voteme_party_target% Target to trigger a party (N/A if off) # %voteme_party_needed% Remaining votes until next party (N/A if off) # # Score