🏝️ IslandRate 插件介绍

IslandRate 是一个为 ASkyBlock 和 BentoBox 设计的插件，允许玩家以 1-5 星的评分系统对其他玩家的岛屿进行评分。它还包括一个内置的顶级岛屿排名功能，适合用于奖励服务器上评分最高的岛屿，或纯粹作为装饰功能使用。

📜 功能特性

• 玩家可以通过命令 /rate <rating/1-5> 对其他玩家的岛屿进行评分。
• 使用 /rate 命令需要 islandrate.use 权限。
• 支持通过 /rate reload 重新加载插件配置（需要 islandrate.reload 权限）。
• /rate top 显示评分最高的十个岛屿。
• 可切换的 GUI 菜单，替代命令操作。
• 支持平均评分功能。
• 使用 MySQL/SQLite 数据库存储数据。
• 支持自定义 GUI/菜单。
• 提供 PlaceholderAPI 支持。
• 支持通过牌匾直接使用 IslandRate 功能。
• 简单易用，支持高度自定义。

⚙️ 配置文件示例

# Welcome to the IslandRate config.yml File!
change-rating: true
disable-command-rating: false
max-command-rating: 5
min-island-level: 0
send-owner-message: false
cooldown: 60
placeholderapi_shortened: false
inv_check:
  enabled: false
  timer: 600
logging:
  enabled: false
  rate-island: false
menu:
  enabled: false
  custom: false
  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%'
    help:
      slot: 2
      material: BOOK
      amount: 1
      display_name: '&2Rating Info'
      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: []

📜 命令与权限

• /rate [1-5] - 需要权限 islandrate.use - 对岛屿进行评分。
• /rate top - 需要权限 islandrate.top - 列出评分最高的十个岛屿。
• /rate reload - 需要权限 islandrate.reload - 重新加载插件配置文件。
• /rate average [player] - 需要权限 islandrate.average - 获取玩家的平均评分。
• /rate total [player] - 需要权限 islandrate.total - 获取玩家的总评分。

📝 牌匾类型与权限

所有 IslandRate 牌匾必须在第一行写上 [islandrate]！

• islandrate.sign.create.(sign-type) - 创建 IslandRate 牌匾的权限。
• islandrate.sign.use.(sign-type) - 使用 IslandRate 牌匾的权限。

牌匾类型：

• menu - 打开当前岛屿的评分菜单。
• topmenu - 打开顶级岛屿的 GUI 菜单。
• toplist - 在聊天中列出评分最高的十个岛屿。
• rate - 打开当前岛屿的评分 GUI。

📊 PlaceholderAPI 占位符

• %islandrate_top_rated_player% - 评分最高的岛屿的拥有者名字。
• %islandrate_top_rated_player_#% - 获取指定排名的玩家名字。
• %islandrate_top_rated_amount% - 评分最高的岛屿的总评分数量。
• %islandrate_total_ratings_server% - 所有岛屿的总评分数量。
• %islandrate_average_rating% - 玩家的平均评分。

📚 API 示例

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!");
    }
}