Votify

Votify

Mapple Studio is a high-performance, customizable voting management plugin for Minecraft servers. Developed by Mapple Studio 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

* Discord Webhooks: Seamlessly listen to incoming votes from any website supported by NuVotifier. * Discord Webhooks: Built-in support for Top Voter leaderboards with full Discord Webhooks integration. * Discord Webhooks: Incentivize specific voting sites by customizing unique rewards for each one. * Discord Webhooks: 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. Configure: Ensure you have Configure installed and configured on your server. 2. Configure: Grab the latest `.jar` from the %%MD1%% page. 3. Configure: Place the file into your server's `/plugins/` directory. 4. Configure: 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

```yaml

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.' ```