IslandRate | ASkyBlock & BentoBox 1.3.4.1

Tested Minecraft Versions:

• 1.7
• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13
• 1.14

Source Code:

https://github.com/Yovez/IslandRate

Contributors:

Yovez

I'm making private, unique, custom, and premium plugins over on Fiverr starting at just $15.00! If you have an idea for a plugin and want it done professionally, click here for more info!

I'm sorry for any inconvenience this may cause you, but over the past year I've been very uninterested and unmotivated to continue with this plugin. I am not fully maintaining this plugin anymore, there may be a few random updates in a years time but nothing more. If you'd like to take over the maintenance or contribute to the code please by all means do so, the GitHub link is posted above.


IslandRate is a plugin that adds a feature to ASkyBlock & BentoBox to allow you to rate other player's islands on a scale of 1-5 stars. IslandRate also has a built-in top-rated island feature! Use IslandRate to reward the top-rated islands on your server! Or just keep it purely cosmetic!

Features:

• Players can rate other player's island by doing /rate <rating/1-5>
• To use /rate, player must have islandrate.use
• /rate reload - islandrate.reload required to reload!
• /rate top - Displays the top ten rated islands!
• Toggleable GUI Menu instead of using commands for /rate & /rate top
• Average rating option!
• MySQL/SQLite database storage!
• Custom GUI/Menu Support!
• PlaceholderAPI support
• Sign Support - Use IslandRate directly from signs!
• Simple and easy to use
• Simple yet effective API
• Very customizable from top-to-bottom

Spoiler: Video Showcases

English Video, Thanks to @ericbarbwire !

Spoiler: Latest Config.yml

Code (YAML):

# Welcome to the IslandRate config.yml File!
# If you have questions please contact
# Yovez on Discord: @Yovez#1337

# Here are the built-in IslandRate placeholders
# NOTE: Some of these may return null or nothing due to inproper usage
# %prefix% - The IslandRate prefix
# %player% - The player's name
# %player-stars% - The player's rating amount
# %player-average% - The player's average rating amount
# %player-total-voters% - The player's total number of voters
# %cooldown% - Cooldown in seconds for the player till they can rate again
# %opted-out-player% - True/False if the player has opted out of their island being rated
# %target% - The target's name
# %target-stars% - The target's rating amount
# %target-average% - The target's average rating amount
# %target-total-voters% - The target's total number of voters
# %cooldown% - Cooldown in seconds for the target till they can rate again
# %opted-out-target% - True/False if the target has opted out of their island being rated
# %rating% - The rating amount used when rating an island
# %top-place% - The top place number when listing top places

# Disable if you don't want players to be able to change
# their rating once they've rated an island, like a one-and-done rating.
change-rating: true
# Set this to true to prevent users from using the /rate command alone,
# will default to opening the rate menu.
disable-command-rating: false
# Change the maximum command based rate value
max-command-rating: 5
# The minimum island level a user requires to have before they can rate islands.
# CURRENTLY DISABLED
min-island-level: 0
# Set to true to send the island owner a message when someone rates their island.
send-owner-message: false
# Cooldown timer to rate islands.
cooldown: 60
# Set to true to shorten the placeholderapi placeholder prefix for islandrate
# (i.e. %ir% instead of %islandrate% prefix).
placeholderapi_shortened: false
inv_check:
 # Set to true to enable to inventory check feature with an automated timer
  # This checks for cheated/glitched items from the menus of IslandRate.
  enabled: false
  # The time in seconds to automatically check for cheated/glitched items.
  timer: 600
logging:
 # Set to true to enable the logging feature
  enabled: false
  # Set to true to log whenever a user rates someone's island.
  rate-island: false
# This is the rate menu
menu:
 # Set to true to enable the menu for /rate
  enabled: false
  # Set to true to be able to change the default items to custom items
  # as listed below
  custom: false
  # This is the menu's inventory title
  title: '&6&lRate &e%target%''s &6&lIsland &4(%target-stars%)'
  size: 9
  items:
    skull:
      slot: 0
      amount: 1
      display_name: '&r&c%target%'
      lore:
      - '&4Total Ratings: &c%target-stars%'
    # The Item identifier, only for config file, must be unique!
    help:
     # The slot number the item will be in inside the menu
      slot: 2
      # The exact item material name (does not support numbers)
      # Find all the Material Names here:
      # https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
      material: BOOK
      # The amount of the item
      amount: 1
      # The name of the item to show, supports internal placeholders
      # and colors
      display_name: '&2Rating Info'
      # The lore of the item, delete this section to remove the lore
      lore:
     - '&aRate the island'
      - '&aChoose your rating 1-5'
    rating-1:
      rating: 1
      slot: 4
      material: EMERALD
      amount: 1
      display_name: '&41 &f= &4Terrible'
      lore: []
    rating-2:
      rating: 2
      slot: 5
      material: EMERALD
      amount: 2
      display_name: '&c2 &f= &cPoor'
      lore: []
    rating-3:
      rating: 3
      slot: 6
      material: EMERALD
      amount: 3
      display_name: '&e3 &f= &eOkay'
      lore: []
    rating-4:
      rating: 4
      slot: 7
      material: EMERALD
      amount: 4
      display_name: '&a4 &f= &aGood'
      lore: []
    rating-5:
      rating: 5
      slot: 8
      material: EMERALD
      amount: 5
      display_name: '&25 &f= &2Great'
      lore: []
island_menu:
  enabled: false
  custom: false
  title: '&9IslandRate Menu'
  items:
    skull:
      slot: 0
      amount: 1
      display_name: '&a%player%'
      lore:
      - '&6Total Ratings: &e%player-stars%'
    opt-out:
      slot: 2
      material: BARRIER
      amount: 1
      display_name: '&bToggle Opted-Out'
      lore:
      - '&6&lOpted-Out&7: &e%opted-out-player%'
top_menu:
  enabled: false
  teleport: false
  title: '&6&lTop Rated Islands'
  items:
    skull:
      display_name: '&a#%top-place% &r&f%target%'
      lore:
      - '&6Total Ratings: &e%target-stars%'
sign:
  open-rate-menu:
    line-1: '&bOpen Rate Menu'
  open-top-menu:
    line-1: '&bOpen Top Ten'
  show-top-list:
    line-1: '&bList Top Ten'
  rate-island:
    line-1: '&bRate'
    line-2: '%target%''s'
    line-3: '&bIsland'
  no-island-found:
    line-1: '&cNo'
    line-2: '&cIsland'
    line-3: '&cFound'

 

Spoiler: Commands & Permissions

/rate [1-5] - islandrate.use - The main command.
/rate top - islandrate.top - List the top ten rated islands.
/rate reload - islandrate.reload - Reload IslandRate configuration files.
/rate average [player] - islandrate.average - Get the average rating of a player.
/rate total [player] - islandrate.total - Get the total ratings of a player.

Spoiler: PlaceholderAPI Placeholders

%islandrate_top_rated_player% - Top rated island's owner's name.
%islandrate_top_rated_player_#% - Replace # with the number of the place to get the player's name
%islandrate_top_rated_amount% - Top rated island's amount of ratings.
%islandrate_top_rated_amount_#% - Replace # with the number of the place to get the amount
%islandrate_total_ratings_server% - Total ratings of all islands combined.
%islandrate_total_ratings_player% - Total ratings of the player.
%islandrate_average_rating% - Average rating of the player.
More will come soon. Please request placeholders you want!

There are currently a few different types of IslandRate signs you can create...

Spoiler: Types of Signs

All IslandRate signs MUST have [islandrate] on the FIRST line!
The only way to interact with IslandRate signs is to right-click them!

• If you just put [islandrate] on the top of the sign and nothing else, you'll get a sign to rate the island you are currently standing on.
• If you just put menu on the second line, you'll get a sign to open the rate menu for the island you are currently standing on.
• If you just put topmenu on the second line, you'll get a sign to open the top rated islands menu.
• If you just put toplist on the second line, you'll get a sign that lists the top rated islands when you right click it.

Spoiler: Sign Permissions

islandrate.sign.create.(sign-type) - Permission to create IslandRate signs
islandrate.sign.use.(sign-type) - Permission to use IslandRate signs

Sign Types:
menu - Sign to open the rate menu for the island the sign is on.
topmenu - Sign to open the top ten GUI menu.
toplist - Sign to list the top ten island ratings in chat.
rate - Sign to open the rate GUI for the island the sign is on.

Spoiler: Sign Examples

[islandrate]
topmenu
(blank)
(blank)


[islandrate]
menu
(blank)
(blank)


[islandrate]
(blank)
(blank)
(blank)


[islandrate]
toplist
(blank)
(blank)

Spoiler: API Examples

Code (Java):

public class ExampleClass {

    public void sumthing() {
        IslandRateAPI api = IslandRateAPI.getInstance();
        OfflinePlayer firstPlace = api.getTopRated(1);
        int firstPlaceRating = api.getTotalRatings(firstPlace);
        Bukkit.broadcastMessage(
                firstPlace.getName() + " is the top rated player with a total of " + firstPlaceRating + " stars!");

    }

}