IslandRate - 岛屿评分

简介

IslandRate 是一款为 ASkyBlock 和 BentoBox 空岛插件设计的扩展插件，它允许玩家以 1-5 星的标准对其他玩家的空岛进行评分。插件内置了评分排行榜功能，可用于奖励服务器上最受欢迎的空岛，或仅作为一项装饰性功能。

💡重要通知

• 插件作者目前在 Fiverr 平台提供私人、独特、定制及高级的插件开发服务，起价为 15.00 美元。如有专业插件定制需求，可点击相关链接获取更多信息。
• 作者在过去一年里对该插件的维护兴趣和动力有所减退，目前不再进行完全维护。未来可能偶有零星更新，但不会有更多实质性内容。
• 如果您有兴趣接手维护或为代码做出贡献，欢迎通过上方提供的 GitHub 链接进行操作。

🎮核心功能

• 空岛评分：玩家可使用 /rate <1-5> 命令对其他玩家的空岛进行评分。
• 排行榜系统：通过 /rate top 命令查看评分最高的前十座空岛。
• 可切换的 GUI 菜单：可选择使用图形界面菜单来代替命令执行评分和查看排行榜操作。
• 平均分计算：支持计算空岛的平均评分。
• 数据存储：支持 MySQL 和 SQLite 数据库存储。
• 自定义 GUI/菜单：提供高度自定义的菜单支持。
• PlaceholderAPI 支持：可与其他插件联动，显示丰富的占位符信息。
• 告示牌支持：可直接通过右键点击告示牌来使用 IslandRate 的功能。
• 简单易用：设计简洁，易于上手。
• 完整 API：提供简单而有效的 API 供开发者调用。

🔧命令与权限

主要命令

• /rate [1-5]

- 权限：`islandrate.use`

- 对当前所在的空岛进行评分。

• /rate top

- 权限：`islandrate.top`

- 显示评分最高的前十座空岛。

• /rate reload

- 权限：`islandrate.reload`

- 重载 IslandRate 的配置文件。

• /rate average [玩家名]

- 权限：`islandrate.average`

- 查看指定玩家的平均评分。

• /rate total [玩家名]

- 权限：`islandrate.total`

- 查看指定玩家的总评分。

使用说明

• 执行 /rate 命令时，玩家必须拥有 islandrate.use 权限。
• 执行 /rate reload 命令时，需要 islandrate.reload 权限。

✨PlaceholderAPI 占位符

插件提供了丰富的占位符，可用于在聊天或其他支持 PlaceholderAPI 的插件中显示信息。

玩家与排行榜占位符

• %islandrate_top_rated_player% - 排名第一的空岛所有者名称。
• %islandrate_top_rated_player_#% - 将 # 替换为具体名次（如1,2,3），获取该名次玩家的名称。
• %islandrate_top_rated_amount% - 排名第一的空岛获得的总评分数量。
• %islandrate_top_rated_amount_#% - 将 # 替换为具体名次，获取该名次空岛的评分数量。
• %islandrate_total_ratings_server% - 服务器所有空岛的总评分数量。
• %islandrate_total_ratings_player% - 指定玩家的总评分数量。
• %islandrate_average_rating% - 指定玩家的平均评分。

> 更多占位符将陆续添加，欢迎提出需求。

⭐告示牌系统

IslandRate 支持通过告示牌进行交互。所有 IslandRate 告示牌的第一行必须是 [islandrate]，并且只能通过右键点击来触发。

告示牌类型与格式

只需在第一行写上 [islandrate]，后续行根据需求填写：

• 评分当前空岛

    [islandrate]
    (留空)
    (留空)
    (留空)

• 打开当前空岛的评分菜单

    [islandrate]
    menu
    (留空)
    (留空)

• 打开空岛排行榜菜单

    [islandrate]
    topmenu
    (留空)
    (留空)

• 在聊天栏列出排行榜

    [islandrate]
    toplist
    (留空)
    (留空)

告示牌权限

• 创建权限：islandrate.sign.create.(sign-type)
• 使用权限：islandrate.sign.use.(sign-type)

**Sign Types (类型)**

• menu - 打开所在空岛的评分菜单。
• topmenu - 打开前十名空岛的 GUI 菜单。
• toplist - 在聊天栏列出前十名空岛。
• rate - 打开所在空岛的评分 GUI。

❓API 使用示例

开发者可以通过简单的 API 获取插件数据。以下是一个 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!");
    }
}

🔧配置摘要

配置文件 (config.yml) 允许深度自定义插件行为。主要配置项包括：

核心设置

• change-rating: 是否允许玩家修改已给出的评分（默认为 true）。
• disable-command-rating: 是否禁用 /rate 命令而强制使用 GUI 菜单（默认为 false）。
• cooldown: 评分冷却时间（秒）。
• send-owner-message: 是否在有人评分时通知空岛主人。

菜单自定义

• 可以启用或禁用 /rate、/rate top 的 GUI 菜单。
• 支持完全自定义菜单标题、大小、槽位物品的材质、数量、显示名称和描述。

其他功能

• placeholderapi_shortened: 是否使用缩短的 PlaceholderAPI 前缀（如 %ir% 代替 %islandrate%）。
• inv_check: 启用库存检查，防止从菜单中刷出异常物品。
• logging: 启用日志记录功能，记录评分等操作。

> 完整的配置选项与内部占位符说明，请参考插件附带的 config.yml 文件。