VISUAL GUIDE & CONFIGURATION MANUAL: VOTE & VOTE PARTY
SECTION 1: MAIN MENU & NETWORK BROADCASTSThis section handles the core settings of the system and how the server interacts publicly with your community.
Global Rewards Configuration
- Menu Title: Rewards (Inside Vote Settings)
- What it means: This is the main direct access button and the heart of the server's reward management system.
- How it works: Clicking the glowing crystal/diamond icon opens the global editing sub-menu. From here, all reward categories branch out (standard, VIP, lucky drops, or cumulative milestones).
Global Vote Broadcasts
- Menu Title: Vote Broadcast (Inside Message Settings)
- What it means: Controls the automatic server-wide chat messages sent whenever a player votes.
- How it works: It is currently set to Status: ON (visually represented by a green wool block). This ensures that when a player votes, a clean, styled announcement pops up in the global chat for everyone to see, boosting community engagement and friendly competition.
SECTION 2: STANDARD REWARDS & LOOT CONTAINERS (VOTE REWARDS)
This section defines the baseline, immediate loot that any player receives upon completing their votes on your server's links.
Base Rewards Access
- Menu Title: Vote Rewards (Inside Reward Settings)
- What it means: The core category holding the default server rewards for general voters.
- How it works: Clicking this button takes you directly into the specific breakdown of the four reward pillars: physical items, experience levels, virtual money, and console commands.
Item Rewards Counter
- Menu Title: Item Rewards (Inside Vote Rewards)
- What it means: Indicates how many individual item stacks or physical reward slots are currently configured to drop into the player's inventory.
- How it works: The interface displays Currently: 9 items. Clicking this chest icon opens up the real-time loot room editor.
Inventory Loot Editor
- Menu Title: Item Rewards #1
- What it means: The interactive physical container where administrators place the exact items players will receive.
- How it works:The plugin presents a clean chest layout. As seen in the interface, a highly competitive survival set has been configured:
- Full Netherite Armor Set (Helmet, Chestplate, Leggings, and Boots).
- Netherite Sword for immediate combat readiness.
- Premium materials: 3x Diamonds and 3x Emeralds.
- Essential survival consumables: 17x Golden Apples and 5x Experience Bottles.
- Admin Note: You can easily drag and drop items from your own inventory into these slots to update the loot table instantly without needing a server reload.
Experience Rewards (XP)
- Menu Title: XP Reward (Inside Vote Rewards)
- What it means: The modifier that injects raw experience levels directly into the player's level bar.
- How it works: Currently configured to Currently: 3 levels. Upon voting, the plugin calculates the mathematical levels and instantly adds +3 levels to the user, making it a great incentive for early-game enchanting.
Economy Money Rewards
- Menu Title: Money Reward (Inside Vote Rewards)
- What it means: Direct integration with your server's virtual economy (compatible with Vault, Essentials, etc.).
- How it works: It is currently set to Disabled. If enabled, administrators can define a specific monetary value (e.g., $500 coins) to be automatically deposited into the player's digital bank account upon voting.
Console Command Rewards
- Menu Title: Command Rewards (Inside Vote Rewards)
- What it means: An automated background execution system that triggers specific console commands on behalf of the voting player.
- How it works: Currently set to Currently: 0 commands. This is ideal for adding custom text lines executed by the server (for example: giving crate keys for a cosmetic area, assigning temporary prefixes, or applying custom particle effects).
SECTION 3: SPECIAL BONUS REWARDS & MILESTONES
Designed to retain players long-term, reward store donors, and add an exciting element of chance to your voting cycle.
VIP Perks (Power Rewards)
- Menu Title: Power Rewards (Inside Reward Settings)
- What it means: An exclusive, high-tier reward table designated solely for players holding specific rank permissions.
- How it works: As the tooltip describes: "Alternative vote rewards for VIP's!". If the plugin detects that a voting player has a VIP permission node, it replaces or supplements the standard drop with this premium loot table, adding incredible value to your store ranks.
The Luck Factor (Lucky Rewards)
- Menu Title: Lucky Rewards (Inside Reward Settings)
- What it means: Adds a thrilling, gacha-style random chance element to the voting routine.
- How it works: The lore reads: "One item from this inven is given if a player is lucky". Administrators can stock this inventory with ultra-rare or powerful drops. When a player votes, the plugin processes their regular reward and triggers a custom drop percentage chance; if the player gets lucky, they win a random surprise item from this pool.
Cumulative Loyalty Milestones
- Menu Title: Milestones (Inside Reward Settings)
- What it means: A long-term progression tracking system that rewards consistent daily voters.
- How it works: It states: "Rewards given when... reaches a certain amount of votes". This lets you set up consecutive vote thresholds. If a user votes consistently and reaches a milestone (e.g., 10, 25, or 50 total monthly votes), the plugin automatically rewards them with massive bonus bundles.
SECTION 4: THE "VOTE PARTY" GLOBAL EVENT SYSTEM
The crown jewel of your voting setup. A community-wide cooperative mechanic that unites the entire server to reach a combined vote goal, unleashing a massive reward celebration when completed.
Master Event Switch
- Menu Title: Vote Party (Inside Vote Party Settings)
- What it means: The main toggle to turn the global Vote Party feature on or off across the server.
- How it works: Currently set to Status: ON (represented by a green wool block), indicating that the server is actively tracking all incoming player votes toward the collective goal.
Vote Target Counter
- Menu Title: Votes Required (Inside Vote Party Settings)
- What it means: The numerical goal tracking system required to trigger the server event.
- How it works: Displays Required: 10 and Votes left: 10. Every single successful vote from any user on the server lowers the "Votes left" counter by 1 in real-time. The moment it hits zero, the plugin interrupts regular gameplay to launch the Vote Party celebration.
Drop Distribution Method
- Menu Title: Party Type (Inside Vote Party Settings)
- What it means: Determines the physical delivery method for the rewards given out during the server-wide event.
- How it works: Set to Add To Inventory. When the global counter hits zero, every single online player instantly receives the event rewards directly inside their inventories, preventing item-stealing or loss in crowded spawn regions.
Global Event Commands
- Menu Title: Vote Party Commands (Inside Vote Party Settings)
- What it means: Triggers large-scale atmospheric or systemic changes across the world during the celebration.
- How it works: Currently sitting at Currently: 0 commands. This allows you to chain commands that affect everyone simultaneously when the party starts—such as changing the world time to day, clearing bad weather, flashing a giant text title (/title) across everyone's screen, or activating a global economy booster for an hour.
Event Loot Chest Configuration
- Menu Title: Vote Party (Inside Reward Settings)
- What it means: Direct access to the dedicated reward pool distributed exclusively during the active Vote Party event.
- How it works: Allows admins to isolate the specific party loot container entirely from ordinary voting drops, ensuring that the rewards for this server-wide celebration feel unique, high-tier, and worth working together for.
