Likes#

Likes はプレイヤーが他のアイランドをいいね、悪いね、またはスターで評価できるようにします。

作成・メンテナンス: BONNe

Useful links

インストール#

BentoBox をインストールし、データフォルダを作成するためにサーバーで少なくとも一度起動します。
この jar を BentoBox プラグインの addons フォルダに配置します。
サーバーを再起動します。
アドオンはデータフォルダを作成し、その中に config.yml が作成されます。
サーバーを停止します。
config.yml を希望通りに編集します。
サーバーを再起動します。

設定#

メインの config.yml ファイルにはゲームモードアドオンの設定に関する基本情報が含まれています。

panels は一部のユーザーがアクセスできるパネルのカスタマイズを許可します。

config.yml#

アドオンが正常にインストールされると、config.yml ファイルが作成されます。このファイルの全オプションにはコメントが付いています。詳細はファイルを確認してください。最新の設定ファイルはこちらで確認できます: config.yml

一部の設定オプションはゲーム内の管理 GUI から変更できます。ただし、一部はできません。

最も重要な設定オプションはモードです:

Likes モード

mode: アドオンが動作するモードを変更できます

LIKES - アイランドにいいねのみを追加できます。
LIKES_DISLIKES - アイランドにいいねと悪いねのみを追加できます。
STARS - アイランドをスターで評価できます。

一度に使用できるモードは 1 つだけです。

カスタマイズ可能な GUI#

BentoBox 1.17 API ではカスタマイズ可能な GUI を実装する機能が導入されました。このアドオンはその機能を使用する最初のアドオンの一つです。カスタマイズをできる限りシンプルにしようとしましたが、一部の機能については説明が必要です。 BentoBox カスタム GUI の詳細はこちらを参照してください: カスタム GUI

GUI をカスタマイズするにはどうすればいいですか？

アドオンの GUI をカスタマイズするにはバージョン 2.2 が必要です。これが実装された最初のバージョンです。アドオンは /plugins/BentoBox/addons/Likes の下に panels というディレクトリを作成します。

現在カスタマイズできる GUI は 3 つです:

表示パネル: view_panels - プレイヤーのアイランドをいいねした人を表示するパネル。
トップパネル: top_panel - 特定の値でトップアイランドが含まれるパネル。
管理パネル: manage_panels - いいね/悪いねまたはスターを追加できるパネル。

表示パネルと管理パネルには各モード用の 3 つの異なるパネルがあります。

コマンド#

ヒント

[player_command] と [admin_command] は実行中のゲームモードによって異なるコマンドです。ゲームモードの config.yml ファイルにはこれらの値を変更するオプションがあります。例えば BSkyBlock では、デフォルトの [player_command] は island、デフォルトの [admin_command] は bsbadmin です。

プレイヤーコマンド管理者コマンド

/[player_command] likes: いいね、悪いね、スターを追加/削除する GUI を開きます。
/[player_command] likes top: いいね、悪いね、スターでトップアイランドを表示する GUI を開きます。
/[player_command] likes view <player>: アイランドにいいねやスターを付けた人を表示する GUI を開きます。

/[admin_command] likes: 管理者 GUI を開きます。
/[admin_command] likes settings: 管理者設定 GUI を開きます。

権限#

ヒント

[gamemode] は実行中のゲームモードによって異なるプレフィックスです。プレフィックスはゲームモード名の小文字です。例えば BSkyBlock を使用している場合、プレフィックスは bskyblock です。同様に AcidIsland を使用している場合、プレフィックスは acidisland です。

プレイヤー権限管理者権限

[gamemode].likes - (デフォルト: true) - プレイヤーが '/[player_command] likes' コマンドを使用できます。
[gamemode].likes.top - (デフォルト: true) - プレイヤーが '/[player_command] likes top' コマンドを使用できます。
[gamemode].likes.view - (デフォルト: true) - プレイヤーが '/[player_command] likes top' コマンドを使用できます。
[gamemode].likes.icon.[MATERIAL] - (デフォルト: false) - トップ GUI でアイランドオーナーのアイコン変更を許可します。

[gamemode].likes.view.others - (デフォルト: op) - プレイヤーが '/[player_command] likes view ' コマンドを使用できます。
[gamemode].likes.bypass-cost - (デフォルト: op) - アドオン内の操作のコストをバイパスできます。
[gamemode].likes.admin - (デフォルト: op) - '/[admin_command] likes' コマンドの使用を許可します。
[gamemode].likes.admin.settings - (デフォルト: op) - '/[admin_command] likes settings' コマンドの使用を許可します。

何か不足していますか？

このアドオンの addon.yml ファイルで権限の完全なリストを確認できます。
以下のリストに不足しているものがあれば、お知らせください！

プレースホルダー#

Tip

[gamemode] is a prefix that differs depending on the gamemode you are running.

The prefix is the lowercased name of the gamemode, i.e. if you are using BSkyBlock, the prefix is bskyblock.

Properly translated placeholders for each gamemode can be found:

Please read the main Placeholders page.

Placeholder	Description	Likes version
`%[gamemode]_likes_addon_island_likes_count%`	Count of likes that are set to player island	1.7.0
`%[gamemode]_likes_addon_island_likes_place%`	Island place by likes count	1.7.0
`%[gamemode]_likes_addon_island_dislikes_count%`	Count of dislikes that are set to player island	1.7.0
`%[gamemode]_likes_addon_island_dislikes_place%`	Island place by dislikes count	1.7.0
`%[gamemode]_likes_addon_island_rank_count%`	Rank number (likes - dislikes) that are set to player island	1.7.0
`%[gamemode]_likes_addon_island_rank_place%`	Island place by rank	1.7.0
`%[gamemode]_likes_addon_island_stars_value%`	Average stars added to player island	2.0.0
`%[gamemode]_likes_addon_island_stars_place%`	Island place by stars	2.0.0
`%[gamemode]_likes_addon_visited_island_likes_count%`	Count of likes that are set to island at player location	2.1.0
`%[gamemode]_likes_addon_visited_island_likes_place%`	Island place by likes count for island at player location	2.1.0
`%[gamemode]_likes_addon_visited_island_dislikes_count%`	Count of dislikes that are set to island at player location	2.1.0
`%[gamemode]_likes_addon_visited_island_dislikes_place%`	Island place by dislikes count for island at player location	2.1.0
`%[gamemode]_likes_addon_visited_island_rank_count%`	Rank number (likes - dislikes) that are set to island at player location	2.1.0
`%[gamemode]_likes_addon_visited_island_rank_place%`	Island place by rank for island at player location	2.1.0
`%[gamemode]_likes_addon_visited_island_stars_value%`	Average stars added to island at player location	2.1.0
`%[gamemode]_likes_addon_visited_island_stars_place%`	Island place by stars for island at player location	2.1.0
`%[gamemode]_likes_addon_top_likes_owner_name_<number>%`	Island owner name who are in place `<number>` by likes	1.7.0
`%[gamemode]_likes_addon_top_likes_island_name_<number>%`	Island name which are in place `<number>` by likes	1.7.0
`%[gamemode]_likes_addon_top_likes_count_<number>%`	Count of likes for island that are in place `<number>` by likes	1.7.0
`%[gamemode]_likes_addon_top_dislikes_owner_name_<number>%`	Island owner name who are in place `<number>` by dislikes	1.7.0
`%[gamemode]_likes_addon_top_dislikes_island_name_<number>%`	Island name which are in place `<number>` by dislikes	1.7.0
`%[gamemode]_likes_addon_top_dislikes_count_<number>%`	Count of dislikes for island that are in place `<number>` by dislikes	1.7.0
`%[gamemode]_likes_addon_top_rank_owner_name_<number>%`	Island owner name who are in place `<number>` by rank	1.7.0
`%[gamemode]_likes_addon_top_rank_island_name_<number>%`	Island name which are in place `<number>` by rank	1.7.0
`%[gamemode]_likes_addon_top_rank_count_<number>%`	Rank value for island that are in place `<number>` by rank	1.7.0
`%[gamemode]_likes_addon_top_stars_owner_name_<number>%`	Island owner name who are in place `<number>` by stars	2.0.0
`%[gamemode]_likes_addon_top_stars_island_name_<number>%`	Island name which are in place `<number>` by stars	2.0.0
`%[gamemode]_likes_addon_top_stars_count_<number>%`	Average stars for island that are in place `<number>` by stars	2.0.0

よくある質問#

機能 X を追加してもらえますか？

こちらのリストに追加してください。

悪いねを無効にできますか？

はい、Likes アドオンは 3 つの動作モードをサポートしています:

Likes: アイランドにいいねのみを追加できます
LikesDislikes: いいねと悪いねを追加できます
Stars: プレイヤーのアイランドを 1〜5 つのスターで評価できます

他のプレイヤーのいいねを見ることはできますか？

はい、ただし権限 [gamemode].likes.view.others が必要です。

その権限があればプレイヤーは /[playercmd] likes view <player> を使って他のプレイヤーのいいねを確認できます。

特定のアイランドだけ表示アイコンを変更できますか？

はい、可能です。

2 つの方法があります:

管理者 GUI でアイランドを選択して表示するブロックを選択できます。
アイランドオーナーに権限を追加する: [gamemode].likes.icon.[MATERIAL]

注意: PLAYER_HEAD はアイランドオーナーの頭に変換されます。

翻訳#

翻訳の改善にご協力ください

BentoBoxとその拡張機能のほとんどの翻訳はAIの助けを借りて生成されているため、作業の大部分はすでに完了しています — ただしAIは完璧ではありません。コミュニティに本当に必要なのは、 エラーの報告と修正です。

誤りや不自然な表現を見つけた場合は、 bentobox.world（GitHubオーガニゼーションへのショートリンク）からissueまたはPRを開くか、 Discordでご連絡ください。
新しい言語を追加したい場合は、該当リポジトリの src/main/resources/locales/に新しいロケールファイルを追加する PRを開くか、Discordでご相談ください。

言語	言語コード	進捗
英語（アメリカ）	`en-US`	100%（デフォルト）
スペイン語	`es`	100%
ベトナム語	`vi`	92%
ポーランド語	`pl`	100%
ロシア語	`ru`	100%
中国語（中国）	`zh-CN`	100%

API#

Likes 2.2.0 と BentoBox 1.17 以降、他のプラグインが Likes アドオンのデータに直接アクセスできます。

Maven 依存関係#

Likes は他のプラグイン向け API を提供しています。これはバージョン 2.2.0 以降に対応しています。

注意

Maven POM.xml に Likes 依存関係を追加してください:

    <repositories>
        <repository>
            <id>codemc-repo</id>
            <url>https://repo.codemc.io/repository/bentoboxworld/</url>
        </repository>
    </repositories>

    <dependencies>
        <dependency>
            <groupId>world.bentobox</groupId>
            <artifactId>likes</artifactId>
            <version>2.2.0</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>

最新の Likes バージョンを使用してください。

Likes の JavaDocs はこちらで確認できます。

イベント#

LikeAddEventLikeRemoveEventDislikeAddEventDislikeRemoveEventStarsAddEventStarsRemoveEvent

説明

プレイヤーがアイランドに新しいいいねを追加したときにトリガーされるイベントです。

このイベントは情報提供のみです。キャンセルできません。

クラスへのリンク: LikeAddEvent

変数

UUID user - いいねを追加したプレイヤーの ID。
String islandId - いいねを受け取るアイランドの ID。

例

@EventHandler(priority = EventPriority.MONITOR)
public void onLike(LikeAddEvent event) {
    UUID user = event.getUser();
    String islandId = event.getIslandId();
}

説明

プレイヤーがアイランドからいいねを削除したときにトリガーされるイベントです。

このイベントは情報提供のみです。キャンセルできません。

クラスへのリンク: LikeRemoveEvent

変数

UUID user - いいねを削除したプレイヤーの ID。
String islandId - いいねを失うアイランドの ID。

例

@EventHandler(priority = EventPriority.MONITOR)
public void onLikeRemove(LikeRemoveEvent event) {
    UUID user = event.getUser();
    String islandId = event.getIslandId();
}

説明

プレイヤーがアイランドに新しい悪いねを追加したときにトリガーされるイベントです。

このイベントは情報提供のみです。キャンセルできません。

クラスへのリンク: DislikeAddEvent

変数

UUID user - 悪いねを追加したプレイヤーの ID。
String islandId - 悪いねを受け取るアイランドの ID。

例

@EventHandler(priority = EventPriority.MONITOR)
public void onDislike(DislikeAddEvent event) {
    UUID user = event.getUser();
    String islandId = event.getIslandId();
}

説明

プレイヤーがアイランドから悪いねを削除したときにトリガーされるイベントです。

このイベントは情報提供のみです。キャンセルできません。

クラスへのリンク: DislikeRemoveEvent

変数

UUID user - 悪いねを削除したプレイヤーの ID。
String islandId - 悪いねを失うアイランドの ID。

例

@EventHandler(priority = EventPriority.MONITOR)
public void onDislikeRemove(DislikeRemoveEvent event) {
    UUID user = event.getUser();
    String islandId = event.getIslandId();
}

説明

プレイヤーがアイランドに新しいスターを追加したときにトリガーされるイベントです。

このイベントは情報提供のみです。キャンセルできません。

クラスへのリンク: StarsAddEvent

変数

UUID user - スターを追加したプレイヤーの ID。
String islandId - スターを受け取るアイランドの ID。
int value - 追加されたスターの値（1〜5）

例

@EventHandler(priority = EventPriority.MONITOR)
public void onStarsAdd(StarsAddEvent event) {
    UUID user = event.getUser();
    String islandId = event.getIslandId();
    int value = event.getValue();
}

説明

プレイヤーがアイランドからスターを削除したときにトリガーされるイベントです。

このイベントは情報提供のみです。キャンセルできません。

クラスへのリンク: StarsRemoveEvent

変数

UUID user - スターを追加したプレイヤーの ID。
String islandId - スターを失うアイランドの ID。

例

@EventHandler(priority = EventPriority.MONITOR)
public void onStarsRemove(StarsRemoveEvent event) {
    UUID user = event.getUser();
    String islandId = event.getIslandId();
}

アドオンリクエストハンドラー#

BentoBox 1.17 以前は、アドオンのロードに使用するクラスローダーの問題で BentoBox 環境外からのデータアクセスに問題がありました。これはデータが他のアドオンからのみアクセス可能だったことを意味します。しかし BentoBox が PlAddon 機能を実装したため、リクエストハンドラーはもはや必要ありません。

アドオンリクエストハンドラーの詳細はこちらをご覧ください。

island-likestop-ten-likes

説明

指定されたワールドのアイランドに保存されたいいねデータを返します。

入力

world-name: String - ワールドの名前。
island: String - アイランドの UUID。

出力

出力は以下のキーを持つ Map<String, Object> です:

likes: long - 指定されたアイランドに設定されたいいねの数。
dislikes: long - 指定されたアイランドに設定された悪いねの数。
rank: long - 指定されたアイランドのランク数。
stars: double - 指定されたアイランドの平均スター値。
placeByLikes: integer - いいねによるランキングでの順位。
placeByDislikes: integer - 悪いねによるランキングでの順位。
placeByRank: integer - ランクによるランキングでの順位。
placeByStars: integer - スターによるランキングでの順位。
likedBy: List<UUID> - 指定されたアイランドをいいねしたプレイヤーの UUID のリスト。
dislikedBy: List<UUID> - 指定されたアイランドを悪いねしたプレイヤーの UUID のリスト。
staredBy: Map<UUID, Integer> - 指定されたアイランドをスターしたプレイヤーの UUID と追加したスター数のマップ。

失敗

world-name が提供されていないか存在しないかゲームモードワールドでない場合、またはアイランドが提供されていないかアイランドのデータが空の場合、このハンドラーは空のマップを返します。

コード例

public Map<String, Object> getLikesData(String worldName, String islandUUID) {
    return (Map<String, Object>) new AddonRequestBuilder()
        .addon("Likes")
        .label("island-likes")
        .addMetaData("world-name", worldName)
        .addMetaData("island", islandUUID)
        .request();
}

説明

トップ 10 のアイランド UUID とその値のマップを含む Map<String, Number> を返します。

入力

world-name: String - ワールドの名前。
type: String - トップのタイプ。サポート: STARS、LIKES、DISLIKES、RANK。

出力

トップ 10 のアイランドの UUID をキーとし、アイランドのトップ値を値とするマップ。

失敗

world-name が提供されていないか存在しないかゲームモードワールドでない場合、または指定されたトップタイプにデータがない場合、このハンドラーは空のマップを返します。

コード例

public Map<String, Number> getTopTenLikes(String worldName, String type) {
    return (Map<String, Number>) new AddonRequestBuilder()
        .addon("Likes")
        .label("top-ten-likes")
        .addMetaData("world-name", worldName)
        .addMetaData("type", type)
        .request();
}

最終更新日: 2026年4月13日 13:14:53