Votify

Votify is a high-performance, customizable voting management plugin for Minecraft servers. Developed by ImJopeh at Mapple Studio, Votify streamlines the connection between your server and voting websites, ensuring your players are rewarded instantly and your community remains engaged.

---

🚀 Key Features

• NuVotifier Integration: Seamlessly listen to incoming votes from any website supported by NuVotifier.
• Dynamic Leaderboards: Built-in support for Top Voter leaderboards with full PlaceholderAPI integration.
• Per-Website Rewards: Incentivize specific voting sites by customizing unique rewards for each one.
• Monthly Automation: Hands-free management with automated monthly resets and Top Voter logging.
• Discord Webhooks: Keep your community informed with automated Top Voter announcements sent directly to your Discord server.

---

🛠 Installation

1. Prerequisites: Ensure you have NuVotifier installed and configured on your server.
2. Download: Grab the latest .jar from the Releases page.
3. Deploy: Place the file into your server's /plugins/ directory.
4. Launch: Restart your server to generate the configuration files.
5. Configure: Edit config.yml to set up your rewards and Discord Webhook URL.

🧱 Dependencies

To ensure Votify functions correctly, please check the following requirements:

🔴 Required (Must Install)

• NuVotifier: Required to listen to vote notifications from server listing websites.

🟢 Optional (Highly Recommended)

• PlaceholderAPI: Required if you want to display Top Voter statistics on leaderboards, scoreboards, or holograms.

---

📊 Placeholders

Integrate Votify data into your Scoreboards, TAB, or Holograms using PlaceholderAPI:

Global Statistics

Placeholder	Description
%Votify_total%	Total votes accumulated by the entire server
%Votify_alltimetotal%	Total server votes over the last 6 months
%Votify_lastmonthtotal%	Total server votes from the previous month
%Votify_TimeUntilDayReset%	Time remaining until the daily vote reset

Player Statistics

Placeholder	Description
%Votify_Total_AllTime%	Player's personal total votes (6-month period)
%Votify_Total_Monthly%	Player's personal total votes for the current month
%Votify_Total_Weekly%	Player's personal total votes for the current week
%Votify_BestWeeklyTotal%	Player's highest weekly vote record
%Votify_BestMonthlyTotal%	Player's highest monthly vote record
%Votify_MonthVoteStreak%	Player's current monthly voting streak
%Votify_BestMonthVoteStreak%	Player's all-time best monthly voting streak
%Votify_Top_All_Position%	Player's current rank in the 6-month leaderboard
%Votify_Top_Month_Position%	Player's current rank in the monthly leaderboard
%Votify_Top_Week_Position%	Player's current rank in the weekly leaderboard

Leaderboard Data

Placeholder	Description
%Votify_Top_All_<number>_name%	Name of the voter at specific rank (6-month)
%Votify_Top_All_<number>_votes%	Vote count of the voter at specific rank (6-month)
%Votify_Top_Month_<number>_name%	Name of the voter at specific rank (Monthly)
%Votify_Top_Month_<number>_votes%	Vote count of the voter at specific rank (Monthly)
%Votify_Top_Week_<number>_name%	Name of the voter at specific rank (Weekly)
%Votify_Top_Week_<number>_votes%	Vote count of the voter at specific rank (Weekly)

Vote Party

Placeholder	Description
%Votify_VotePartyContributedVotes%	Number of votes the player has contributed to the current party
%Votify_VotePartyVotesCurrent%	Current amount of votes collected for the Vote Party
%Votify_VotePartyVotesNeeded%	Remaining votes needed to trigger the Vote Party
%Votify_VotePartyVotesRequired%	Total votes required to start a Vote Party

---

📋 Configuration Preview

# Votify Configuration

# The name of your server, used in some messages.
server-name: My Awesome Server

# Enable or disable debug messages in the console.
debug: false

# Login Delay (in seconds)
# Time to wait after a player joins before giving pending rewards.
# Increase this if you use an Authentication plugin (e.g., AuthMe) to prevent item loss.
login-delay: 5

# Discord Webhook Configuration
discord:
  enabled: false
  webhook-url: https://discord.com/api/webhooks/...
  top-voter-embed:
    title: 🏆 Monthly Top Voters 🏆
    description: Here are the top voters for the month of %month%!
    color: 16776960 # Yellow/Gold
    footer: Votify System

# System Data (Do not edit manually)
data:
  last-month: 1

# Messages
messages:
  prefix: '&8[&bVotify&8] &r'
  vote-received: '%prefix% &aThanks, &e%player%&a, for voting on &e%service%&a!'
  player-not-found: '%prefix% &cPlayer %player% not found.'
  no-permission: '%prefix% &cYou don''t have permission to use this command.'
  reload: '%prefix% &aConfiguration reloaded successfully.'