Likes Addon

The Likes Addon enhances player interaction by introducing rating capabilities for islands in the BentoBox plugin. Players can express their appreciation—or critique—of other players' islands through multiple rating modes, ensuring a dynamic and engaging experience.

Features at a Glance

• Flexible Rating Modes: Choose between three exclusive modes:

  • Likes: Players can give positive feedback with likes.
  • Likes & Dislikes: Enables players to express both approval and disapproval.
  • Stars: A 1-to-5 star rating system for detailed feedback.

• Top Players GUI: A visual leaderboard showcasing the most appreciated islands.

• Cost Configuration: Optional integration with in-game economy to set costs for adding or removing likes/dislikes.

• Logging and History: Maintain logs of likes/dislikes for transparency and data insights.

• Reset Integration: Automatically reset likes/dislikes upon island resets.

• Unowned Island Support: Optionally allow ratings for unowned or spawn islands.

Setup Guide

1. Place the addon .jar file in the BentoBox addons folder.
2. Restart your server to initialize the addon.
3. Configure settings in config.yml to suit your preferences.
4. Restart the server again to apply changes.

Player commands

To rate an island, the player must be on the island in question and then run the likes command:

• /[player_command] likes: opens GUI for adding / removing likes, dislikes or star.

Other commands are:

• /[player_command] likes top: opens GUI that display Top islands by Likes, Dislikes or Stars
• /[player_command] likes view <player>: opens GUI that shows who add likes or stars to the island.

[player_command] and [admin_command] are commands that differ depending on the gamemode you are running.

Admin commands

• /[admin_command] likes: opens Admin GUI.
• /[admin_command] likes settings: opens Admin Settings GUI.

Configuration Guide for config.yml

Follow these steps to configure the config.yml file to customize the behavior of the Likes Addon:

1. Locate the Configuration File

The config.yml file is located in the addons/Likes directory within your BentoBox plugin folder.

2. Understanding Key Settings

Default Icon

default-icon: PLAYER_HEAD

Set the default icon for the Top Island panel. The default is PLAYER_HEAD, which will try to retrieve the player's head from servers. You can replace PLAYER_HEAD with any valid Minecraft material name if you find that process slow or problematic, or just want a different icon.

Mode Selection

mode: LIKES_DISLIKES

Choose the rating mode:

• LIKES: Only likes can be added.
• LIKES_DISLIKES: Allows both likes and dislikes.
• STARS: Enables a 1-to-5 star rating system.

Costs

costs:
  add-like: 0.0
  remove-like: 0.0
  add-dislike: 0.0
  remove-dislike: 0.0

Define the in-game currency cost for rating actions. Set values to 0.0 for free actions. If costs are used, then you must have Vault installed and an economy plugin.

Reset on Island Reset

reset-on-reset: true

Set to true to reset ratings when an island is reset.

Log History

log-history: false

Enable (true) or disable (false) logging of rating history. This is currently just stored in the database and there is no way to view it in the game.

Allow Unowned Island Ratings

allow-unowned: true

Set to true to allow ratings on unowned or spawn islands.

Disabled GameModes

disabled-gamemodes: []

Specify the GameModes where the addon should be disabled. Example:

disabled-gamemodes:
  - BSkyBlock

3. Save Changes

After modifying the file, save your changes.

4. Restart the Server

Restart your server to apply the updated configuration.

---

For more advanced configuration options or troubleshooting, visit the Addon Wiki. If you need further assistance, feel free to ask!