VyHub

VyHub, the comprehensive solution to build, manage and monetize Minecraft stores and communities. Easy integration of your Minecraft server and store. It’s the all-in-one management platform designed for your gaming community. VyHub offers a webshop, website, a donation store and bans and warnings.
Design and manage your Minecraft community through VyHub. We acknowledge that community management is hard work and takes a lot of time. With VyHub we automate your donation webstore fully. Furthermore, you can also save time on banning and warning players.

Create a professional community website and webstore in 5 minutes!

And there is more: VyHub provides you with an all-in-one solution to manage your community and gain valuable insights. Communicate, warn and ban players while maintaining good oversight of your community and its rules. With this resource you can make the best out of your community and server monetization.

The all-in-one system includes many features:

Ban and Warnings system (quick community management)
Sync groups/ranks (assign ranks through LuckPerms)
Ticketing system
Forums system
Shop system (unlimited categories, servers and packets)
Buy for a friend
Over 20 payment options (through: PayPal, Paysafecard, Stripe)
Multi language support
Discord roles and notifications
Quick support
Full API
And much more…
For more information and direct contact to the developers and the VyHub community visit our Discord (https://discord.gg/QZxQHtZnSB)

Pricing: VyHub can be used for free.
We take a small commission of 3 to 5% on purchases made through your VyHub store.
So you only pay when you make money.

Not yet convinced?
Check out the free VyHub Demo here: https://demo.vyhub.net/

Try out the different views, dashboards and customization options with VyHubs unique look and fell.

Lets go!

Create your account for FREE on https://vyhub.net, create your VyHub instance and add a Minecraft server.
Download addon for FREE and drag and drop the latest VyHub Plugin folder into your Gmod serveraddonsdirectory.
Restart your server and set your api-key through a simple command displayed in the setup process.
Congratulations your server is now connected! You can start selling products on your server!
For guides and further information visit: https://docs.vyhub.net

Villager Trade Lock

Paper plugin to prevent a villager monopoly by locking what a villager trades after its UI is opened.

“`
TESTED VERSIONS

NATIVE: 1.21.x
WORKING: 1.21.x, 1.20.6 (Folia)
“`
“(If you find out it works on another version shoot me a dm at Lupancham on discord with the version(s) and server software(s) :> )“

### Why do I need this?
Thats a great question! Ask yourself, would it be best to limit a potential threat to a server economy? If yes, this plugin might be for you as this plugin allows you to stop villager re-rolling!

### How Does this Work?
This works by checking if a villager has less than 1 xp, if so it will give tha villager 1 xp to lock its trades when a player opens its menu. To allow the server to use its main thread, this runs on a different thread rather than the one the server uses, this can be toggled in the config which is shown below.

### Hey! I need YOUR help :>
If you happen to test this plugin on a different server software or mc version, please please please shoot us a DM so I can add those versions to the supported versions list so people can know if the version they wish to run it on works :>, <3 Disc Realms/Lupancham

V Shards

# 💎 V-Shards

> Simple vertical transportation for Paper 1.21.1+ servers

[](https://papermc.io)
[](https://adoptium.net)

—

## ✨ Features

– 🏦 **UUID-based economy** — Balances survive name changes
– 🛒 **GUI Shop System** — Fully customizable buy/sell interface
– 🎯 **PlaceholderAPI Support** — Display balances anywhere
– 📊 **Leaderboards** — Top shard holders with pagination
– ⚡ **Zero Lag Design** — Dirty-tracking saves only modified data
– 🎨 **MiniMessage Formatting** — Modern color gradients & styling
– 🔒 **Secure** — Locked GUI prevents item manipulation
– ⬆️ **Auto-save** — Configurable intervals (default: 5 min)

—

## 📦 Installation

1. Download `V-Shards.jar`
2. Drop into `plugins/` folder
3. Restart server
4. Edit `plugins/V-Shards/config.yml` to customize

—

## PlaceholderAPI

| Placeholder | Returns |
|—|—|
| `%vshards_amount%` | The requesting player’s shard balance |
| `%vshards_amount_%` | A named player’s shard balance |

Balances are formatted using the same K / M / B abbreviation system as in-game (e.g. `10K`, `2.5M`, `1B`).

—

## Number Formatting

All balance and price values across commands, messages, and placeholders are automatically abbreviated:

| Raw Value | Displayed As |
|—|—|
| 500 | `500` |
| 1,000 | `1K` |
| 10,000 | `10K` |
| 10,500 | `10.5K` |
| 1,000,000 | `1M` |
| 2,500,000 | `2.5M` |
| 1,000,000,000 | `1B` |

Whole numbers never show a decimal (e.g. `10K` not `10.0K`). Decimals only appear when meaningful (e.g. `10.5K`).

—

## ⌨️ Commands

| Command | Permission | Description |
|———|————|————-|
| `/shards` | `vshards.balance` | Check your balance |
| `/shards ` | `vshards.balance.others` | Check another player’s balance |
| `/shards pay ` | `vshards.pay` | Send shards to another player |
| `/shards give ` | `vshards.admin.give` | Give shards to a player |
| `/shards take ` | `vshards.admin.take` | Remove shards from a player |
| `/shards set ` | `vshards.admin.set` | Set exact balance |
| `/shards top [page]` | `vshards.top` | View leaderboard |
| `/shards shop` | `vshards.shop` | Open shop GUI |
| `/shards reload` | `vshards.admin.reload` | Reload all configs |

**Aliases:** `/shard`

—

## 🔐 Permissions

| Permission | Default | Description |
|————|———|————-|
| `vshards.balance` | Everyone | Check own balance |
| `vshards.pay` | Everyone | Send shards to another player |
| `vshards.top` | Everyone | View leaderboard |
| `vshards.shop` | Everyone | Access shop GUI |
| `vshards.balance.others` | OP | Check others’ balances |
| `vshards.admin.*` | OP | All admin commands |

—

### 🛠️ shop.yml #preview

Defines the GUI layout and all shop items. Reloads with `/shards reload` — no restart needed.

“`yaml
menu_title: ‘&dꜱʜᴀʀᴅꜱ ꜱʜᴏᴘ’
size: 27

items:

# Top decorative border
border:
material: GRAY_STAINED_GLASS_PANE
slot: 18, 19, 20, 21, 22, 23, 24, 25, 26
type: decoration
display_name: ‘&r’
lore: []

# Shop items
pig_spawner_buy:
material: SPAWNER
slot: 0
type: buy
price: 5000
amount: 1
display_name: ‘&d&lᴘɪɢ ꜱᴘᴀᴡɴᴇʀ’
lore:
– ‘&8&m ‘
– ‘&l&8| &f1x ᴘɪɢ ꜱᴘᴀᴡɴᴇʀ’
– ‘&l&8| &7ᴄᴏꜱᴛ: &d5,000 ꜱʜᴀʀᴅꜱ’
– ‘&8&m ‘
– ‘&l&8| &7ᴄʟɪᴄᴋ ᴛᴏ ʙᴜʏ!’
“`

#### 🛠️ Item field reference

| Field | Required | Notes |
|—|—|—|
| `material` | ✅ | Any valid Bukkit `Material` name (e.g. `DIAMOND`, `SPAWNER`) |
| `slot` | ✅ | Inventory slot index, `0` to `size – 1` |
| `type` | ✅ | `buy`, `sell`, `close`, or `decoration` |
| `price` | buy / sell | Shards deducted (buy) or rewarded (sell) |
| `amount` | buy / sell | Items given/taken. Use `0` alongside `command-console` / `command-player` |
| `command-console` | optional | List of commands run as console. Supports `%player%` |
| `command-player` | optional | List of commands run as the player. Supports `%player%` |
| `display_name` | ✅ | Supports `&` color codes |
| `lore` | optional | List of lore lines. Supports `&` color codes |

> **Tip:** Slots are 0-indexed. For a 54-slot inventory (6 rows), valid slots are `0`–`53`. Two items sharing the same slot will cause one to silently overwrite the other.

—

VRX Economy

# 💰 VRX Economy
**The definitive, high-performance Vault economy ecosystem for modern Minecraft servers.**

VRX Economy redefines server economies by combining premium features with a lightweight, zero-lag architecture. Whether you run a Survival, Factions, or CityBuild network, VRX provides everything you need—from a fully visual Auction House and Secure Trading to Dynamic Pricing and Offline Mailboxes—without the clutter of outdated plugins.

—

### ✨ Premium Gameplay Features

* 🛒 **Visual Auction House (`/ah`)** A seamless, GUI-driven marketplace where players can list, browse, and purchase items securely. Offline sales are directly deposited and trigger an offline notification.
* 📉 **Dynamic Market Pricing (`/sellhand`)** Combat server inflation automatically. Server sell prices dynamically adjust based on supply and demand, dropping when items are over-farmed and naturally recovering over time.
* 🤝 **Scam-Proof Trading (`/trade`)** A bulletproof GUI for safe player-to-player exchanges. Includes an exclusive **AI Server NPC** (`/trade Server`) that allows players to gamble items and money against the server itself!
* 🎯 **Bounty Hunting (`/bounty`)** Fuel PvP engagement by letting players place hits on their rivals. The killer automatically claims the prize. Includes a dedicated `/bounty top` leaderboard.
* 💵 **Physical Banknotes (`/withdraw`)** Transform virtual balances into NBT-secured, forgery-proof paper notes for physical trading and roleplay.
* 📭 **Offline Mailbox** Players receive beautiful, stylized notifications upon logging in if their auctions sold, they received money, or their balance was adjusted while they were offline.
* 🎁 **Player Retention (`/daily` & `/paytoggle`)** Boost activity with configurable 24-hour login bonuses, and protect your streamers or top players from spam with a built-in toggle for incoming payments.

—

### 🚀 Engineered for Extreme Performance

* **Zero-Lag Architecture**: All heavy database queries (SQLite & MySQL) are executed asynchronously in the background. Your server’s TPS remains at a perfect 20.0, even with hundreds of concurrent players.
* **Intelligent Memory Caching**: Player balances and offline UUIDs are cached in RAM for instant GUI rendering and lightning-fast Vault API responses. Bypasses slow Mojang API rate limits entirely.
* **Modern Aesthetics**: Full support for `&#RRGGBB` hex color codes and gradients. Make your chat, prefixes, and menus look stunningly modern.
* **100% Customizable**: Modify every single prefix, message, and currency setting. The built-in auto-updater safely adds new configuration lines during future updates without overwriting your custom setup.
* **Security & Auditing**: Every transaction (payments, withdrawals, admin commands) is securely logged to `transactions.log` to help admins track down real-money trading or exploits.

—

### 📜 Commands & Permissions

| Command | Description | Permission |
| :— | :— | :— |
| `/money [player]` | Check your or someone else’s balance | *None* |
| `/pay ` | Send money to another player | *None* |
| `/paytoggle` | Block/Allow incoming payments | *None* |
| `/baltop` | View the top 10 richest players | *None* |
| `/withdraw ` | Create a physical banknote | *None* |
| `/daily` | Claim your 24h reward | *None* |
| `/sellhand` | Sell the item in your main hand | *None* |
| `/ah [sell ]` | Open the Auction House or list an item | *None* |
| `/trade ` | Safely trade items and money | *None* |
| `/bounty `| Manage bounties on players | *None* |
| `/eco `| Admin economy management | `vrx.economy.admin` |

—

### 🔗 Dependencies
To unlock the full potential of VRX Economy, **[Vault](https://modrinth.com/plugin/vault)** is required. This ensures flawless integration with all your other plugins, such as ChestShops, Holograms, and Scoreboards.

—

**Install VRX Economy today and build a stable, engaging, and lag-free economy for your community!**

Clans

# ⚔️ VRX Clans – The Ultimate Enterprise Clan & Base System

**VRX Clans** is a modern, highly optimized, and 100% customizable clan system for your Minecraft server. Designed for networks of all sizes, it offers everything your players need to forge alliances, build shared bases, wage wars, complete daily quests, and run a clan-internal economy.

Whether you run a Hardcore PvP, Survival, or a relaxed Citybuild server: Thanks to countless configuration options and a robust database backend, VRX Clans perfectly adapts to your unique server concept.

—

## ✨ Core Gameplay Features

### 🛡️ Dynamic Clan Bases
Clans can set their own base location. The special part: The protected base radius is dynamic! It automatically grows with every new member joining the clan.
> 💡 *Includes Anti-Combat-Log (configurable teleport delays) and full WorldGuard protection to prevent base-squatting in claimed regions.*

### 🏆 Holograms, Leaderboards & Seasons
Display your server’s top clans with beautiful live holograms (powered by *DecentHolograms*)! Track the Top 5 clans by Kills, Level, or Bank Balance directly at your spawn.
Admins can trigger a **Season Reset** (`/clana endseason`) to reward the top clan, reset all combat statistics, and broadcast the victory across the server and Discord!

### 🛒 Clan Shop, Boosters & Base Upgrades
Give your Clan Bank a real purpose! Leaders can purchase temporary, global boosters (e.g., *Haste*, *Speed*, *Double XP*) for all online members. Additionally, clans can permanently unlock **Passive Base Effects** like *Regeneration* and *Saturation* that automatically apply to players standing inside their protected base radius!

### ⚙️ Dynamic Rank Permissions
Give your Clan Leaders ultimate control! A built-in GUI allows leaders to easily toggle permissions for every rank (*Recruit, Member, Officer, Co-Leader*). Customize exactly who can invite new players, withdraw money, purchase shop upgrades, or declare wars without needing server admins to change config files.

### ⚔️ Clan Wars & KDR Tracking
Bring competition to your server! Clans can track their Kills and Deaths (KDR) and declare war on rivals (`/clan war `). Once accepted, the war begins—the first clan to reach the kill target takes the entire wager pot!

### 📜 Daily Clan Quests
Boost player retention with the interactive “Clan Quests” GUI. Clans work together to complete daily missions (e.g., “Mine 1,000 Diamond Ores” or “Kill 5,000 Zombies”) to earn massive Clan XP. Quests reset automatically every 24 hours.

### 📈 Level & XP System
Clans start at Level 1 and gather XP through active gameplay. Higher levels unlock exclusive features like the **Clan Vault**—a shared, virtual inventory that expands as the clan levels up.

### 💰 Economy, Taxes & `vrx_economy` Support
Full integration with any Vault-based economy! **VRX Clans works out-of-the-box with `vrx_economy`** for a flawless server economy.
To prevent inactive clans from hoarding names, you can enable the **Tax System (Upkeep)**. The plugin periodically deducts taxes from the clan bank. If a clan goes bankrupt, they risk losing a level!

### 🤝 Diplomacy & PvP
Form strategic alliances (Allies) or declare rivalries (Rivals). Friendly-fire within the clan or between allies can be strictly blocked. Server admins can set diplomacy limits (e.g., max 3 allies) to prevent huge server-wide team-ups.

—

## 🛠️ Technical Excellence & Security

Built for large networks, VRX Clans comes with advanced backend features:

* 💾 **MySQL & SQLite Support:** Move past slow YAML files. Use the lightning-fast local SQLite database out of the box, or connect to an external MySQL server for BungeeCord/Velocity environments.
* 🗺️ **WorldGuard Integration:** Flawlessly prevents players from claiming bases inside protected spawn areas or other players’ regions. Features an exclusive `vrxclans.admin.bypass` for staff.
* 📡 **Discord Webhooks:** Automatically send beautiful, color-coded embed messages to your Discord server whenever a clan is founded, levels up, or wins a war!
* 🔒 **Anti-Glitch GUI Protection:** 100% server-side protection against inventory exploits. Advanced techniques like shift-clicking, hotbar-swapping, and silk-touch quest exploits are strictly blocked.
* ⚙️ **Async Auto-Save:** A highly optimized background scheduler safely caches and saves all clan data (including Vault inventories via Base64) every X minutes without causing any TPS drops.
* 📊 **PlaceholderAPI Integration:** Fully supports custom placeholders (`%vrxclans_name%`, `%vrxclans_level%`, `%vrxclans_kdr%`, etc.) for scoreboards, holograms, and tab lists.

—

## 🎨 100% Customizable (Admin-Friendly)

Take full control over your server’s look and feel:

* 🌍 **Full Localization:** Ships with `en_US.yml` and `de_DE.yml`. Every single prefix, chat message, and error is customizable.
* 🖼️ **Dynamic GUI Layouts:** Completely redesign every menu via the `gui_default.yml`. Change slots, materials, display names, and lores without touching a single line of Java code!
* ⚖️ **Deep Balancing:** Flexibly adjust XP multipliers, shop prices, max member counts, and cooldowns.

—

## ⚙️ Commands & Permissions

**Player Commands (`/clan`):**
Everything is intuitively controlled via the `/clan` GUI. Players can use direct commands like `/clan create`, `/clan invite`, `/clan war`, `/clan base`, and much more.

**Admin Commands (`/clanadmin` or `/clana`):**
*(Required Permission: `vrxclans.admin`)*
* `/clana reload` / `/clana save` – Manage configs and data on the fly.
* `/clana setholo ` – Place live clan leaderboards at your spawn.
* `/clana endseason` – Crown the top clan, distribute rewards, and reset kill stats.
* `/clana spy` – Monitor private clan chats.
* `/clana eco / addxp / setlevel / setleader / forcejoin` – Absolute control over all data.
* `/clana vault ` – Open and moderate any clan’s private vault.

—

## 📦 Dependencies & Integrations
To utilize all economy and display features, the following plugins are required or recommended:
* **Economy Plugin:** Seamlessly supports **`vrx_economy`** *(Recommended)*, EssentialsX, or CMI.
* **PlaceholderAPI** *(Highly Recommended)*
* **DecentHolograms** *(Recommended for Live Leaderboards)*
* **WorldGuard** *(Recommended for base protection)*

Chat – Vox

**Vox** – A modern, convenient, customisable and evolving chat plugin that allows you to make your chat unique. There is a possibility of extensive configuration settings.
## Capabilities & Features
### Global Chat
### Local Chat
### Customizable Join & Quit Messages
### Death Messages
### Private Messages with sounds

## Commands
“`/voxchat“`, “`/vox“`, “`vc“`

## Update plan
– Chat for administration;
– Mentions;
– Scheduled Messages;
– More Customisation;
– World Channels

Vouchers

Vouchers is a lightweight and highly customizable plugin for creating vouchers and consumable items!

**Require**: [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)

## Features
– Fully customizable
– Cooldown and usage limit *per permission*
– *Global* usage limit
– Customize your consumable items!
– Execute multiple rewards per item
– **Shift** to bulk open!
– PlaceholderAPI support
– RGB support for items and messages
– Offline player support
– JSON logging

## Wiki
Visit the [wiki](https://anhcraft.gitbook.io/vouchers/) to see how to use the plugin


## Support
Join my [Discord](https://discord.gg/HRAEKapRwx) server for plugin support


VoteRewards

# VoteRewards

**Powerful as VotingPlugin, easy as SuperbVote.** The vote reward plugin that respects
your time — full-featured out of the box, no PhD in YAML required.

## Why VoteRewards?

Most vote plugins make you choose: powerful but complex, or simple but limited.
VoteRewards gives you both — streak milestones, vote parties, weighted random rewards, and
monthly leaderboards, all working from a clean default config the moment you drop in the
jar.

## Features

– **Vote Rewards** — Run commands, give items, send messages on every vote
– **Vote Streak Tracking** — Reward players who vote consistently (3-day, 7-day, 30-day
milestones)
– **Vote Party** — Server-wide celebration when the community hits a vote threshold
– **Random Rewards** — Weighted random loot (common/rare/legendary) on each vote
– **Monthly Leaderboard** — Top voters reset each month, keeping competition fresh
– **Offline Vote Queue** — Votes while offline are saved and delivered on next login
– **PlaceholderAPI Support** — Full placeholder integration for scoreboards, holograms,
etc.
– **Vault Economy** — Give money rewards via any Vault-compatible economy plugin
– **Fully Configurable** — Every message, reward, and threshold is customizable

## Commands

| Command | Permission | Description |
|———|———–|————-|
| `/votereward` | `votereward.use` | Show help menu |
| `/votereward check` | `votereward.use` | View your vote stats, streak, and pending
rewards |
| `/votereward top` | `votereward.use` | View top voters this month |
| `/votereward reload` | `votereward.admin` | Reload configuration |
| `/votereward give ` | `votereward.admin` | Manually give vote rewards |
| `/votereward party` | `votereward.admin` | Manually trigger a vote party |
| `/votereward reset ` | `votereward.admin` | Reset a player’s vote data |

**Aliases:** `/vr`, `/vote`

## PlaceholderAPI Placeholders

| Placeholder | Description |
|————-|————-|
| `%votereward_votes%` | Player’s total all-time votes |
| `%votereward_monthly_votes%` | Player’s votes this month |
| `%votereward_streak%` | Current vote streak (days) |
| `%votereward_party_current%` | Current vote party vote count |
| `%votereward_party_needed%` | Votes remaining until party |
| `%votereward_top_N_name%` | Name of #N top voter |
| `%votereward_top_N_votes%` | Vote count of #N top voter |

## Dependencies

– **Required:** [NuVotifier](https://www.spigotmc.org/resources/nuvotifier.13449/)
(receives votes from vote sites)
– **Optional:** [Vault](https://www.spigotmc.org/resources/vault.34315/) (economy
rewards), [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
(placeholders)

## Installation

1. Download the `.jar` file
2. Place it in your server’s `/plugins/` folder
3. Restart your server
4. Edit `config.yml` to customize rewards, streaks, and party settings
5. Done — default config works out of the box

## Supported Versions

Paper 1.20.x — 1.21.x (Java 17+)

VoteMe

—

## 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[Vote] &fThank you for voting, &e{player}&f! Rewards sent.”
already-claimed: “&e[Vote] &fYou already claimed your reward today.”
not-voted: “&c[Vote] &fYou haven’t voted yet. Head to: &e{link}”
error: “&c[Vote] &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[Vote] &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)
#
# Scoreboard examples:
# “&fTotal Votes &e%voteme_total_votes%”
# “&fParty &e%voteme_party_progress%&7/&6%voteme_party_target%”
# “&fNext Party In &e%voteme_party_needed% &fvotes”
# ╚══════════════════════════════════════════════════════════╝
“`

### Where to get your API key

**Minecraft Pocket Servers** — Log into your dashboard at `minecraftpocket-servers.com`, open your server settings, and copy the API key from the voting section.

**Minecraft-MP** — Log into `minecraft-mp.com`, go to your server panel, and find the API key under the voting/API tab.

—

## Commands

| Command | What it does | Permission |
|—|—|—|
| `/vote` | Opens the vote chest GUI | `voteme.vote` |
| `/vote list` | Lists all vote site names and links in chat | `voteme.vote` |
| `/votereload` | Reloads config without restarting the server | `voteme.admin` |

—

## Permissions

| Node | Default | Description |
|—|—|—|
| `voteme.vote` | All players | Access to `/vote` and `/vote list` |
| `voteme.admin` | OP only | Access to `/votereload` |

—

## PlaceholderAPI

Install [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) and VoteMe registers its expansion automatically on startup — no extra commands needed.

| Placeholder | Returns |
|—|—|
| `%voteme_total_votes%` | All-time total votes recorded by the plugin |
| `%voteme_party_progress%` | Votes counted in the current party cycle |
| `%voteme_party_target%` | Vote count target to fire a party (`N/A` if disabled) |
| `%voteme_party_needed%` | Votes remaining until the next party (`N/A` if disabled) |

Works with any scoreboard plugin that supports PlaceholderAPI — CMI, FeatherBoard, AnimatedScoreboard, etc.

“`
&fTotal Votes &e%voteme_total_votes%
&fParty &e%voteme_party_progress%&7/&6%voteme_party_target%
&fNext Party &e%voteme_party_needed% &fvotes
“`

—

## How the Vote API Works

VoteMe talks directly to each site’s HTTP API. There is no listener port, no webhook server, and no firewall rules to configure.

### Minecraft Pocket Servers — two-step flow

“`
Step 1 GET /api/?object=votes&element=claim&key=KEY&username=PLAYER
Response: “1” = unclaimed | “2” = already claimed | “0” = not voted

Step 2 (only if step 1 returns “1”)
GET /api/?action=post&object=votes&element=claim&key=KEY&username=PLAYER
Response: “1” = success
“`

### Minecraft-MP — single-step flow

“`
GET /api/?action=post&object=votes&element=claim&key=KEY&username=PLAYER
Response: “1” = claimed | “2” = already claimed | “0” = not voted
“`

All requests run on a separate async thread. The main server thread is never touched.

—

## Sound Feedback

Every vote outcome plays a distinct sound sequence so players always know what happened without even reading the chat.

| Event | Sound Sequence |
|—|—|
| Vote claimed | `VILLAGER_YES` → `XP_ORB` pitch 1.2 → `XP_ORB` pitch 1.5 → `VILLAGER_CELEBRATE` |
| Not voted / already claimed / error | `VILLAGER_NO` |
| Vote party fires | `VILLAGER_CELEBRATE` → `XP_ORB` x3 rising → `VILLAGER_YES` (all online players) |

—

## Vote Party

Every time a vote is claimed, the server-wide counter goes up by one. When it hits a clean multiple of your configured `vote-party` number, every player currently online receives the `vote-party-rewards` commands and a full sound sequence.

Between milestones, a broadcast keeps everyone in the loop:

“`
[VoteParty] 23/50 votes reached! 27 more needed.
“`

Set `vote-party: 0` to turn it off entirely.

—

## Join Reminder

Two seconds after a player joins (delayed to not overlap with other join messages), VoteMe checks all enabled vote sites in the background. If any site has an unclaimed vote waiting for that player, they get a private message:

“`
[VoteMe] You still have 2 votes on our voting service. Use /vote list
[VoteMe] You still have 1 vote on our voting service. Use /vote list
“`

The count reflects exactly how many sites have an unclaimed vote — not how many times they voted. Set `join-reminder: false` to disable.

—

### Adding a New Vote Site
Feel free to request an more Vote Service
Contact me at [email protected]

## License

“`
MIT License — Copyright (c) 2025 Herza
Free to use, fork, modify, and redistribute with attribution.
See LICENSE for full text.
“`