Likes#

Likes lets players rate other islands with likes, dislikes or stars.

Created and maintained by BONNe.

Installation#

1. Install BentoBox and run it on the server at least once to create its data folders.
2. Place this jar in the addons folder of the BentoBox plugin.
3. Restart the server.
4. The addon will create a data folder and inside the folder will be a config.yml.
5. Stop the server.
6. Edit config.yml how you want.
7. Restart the server.

Configuration#

The main config.yml file contains basic information about game-mode addon setup.

panels allows to customize some user accessible panels.

config.yml#

After addon is successfully installed, it will create config.yml file. Every option in this file comes with comments about them. Please check file for more information. You can find the latest config file: config.yml

Some config options can be changed via administration GUI in game. However, some options cannot.

The most important config option is mode:

You can use only one mode at the time.

Customizable GUI's#

BentoBox 1.17 API introduced a function that allows to implement customizable GUI's. This addon is one of the first one which uses this functionality. We tried to be as simple as possible for customization, however, some features requires explanation. You can find more information how BentoBox custom GUI's works here: Custom GUI's

Commands#

Permissions#

Placeholders#

FAQ#

Translations#

Available	Language	Language code	Progress
✅	English (United States)	en-US	100% (Default)
❌	Chinese (China)	zh-CN
❌	Chinese (Hong Kong)	zh-HK
❌	Chinese (Taiwan)	zh-TW
❌	Croatian	hr
❌	Czech	cs
❌	French	fr
❌	German	de
❌	Hungarian	hu
❌	Indonesian	id
❌	Italian	it
❌	Japanese	ja
❌	Korean	ko
❌	Latvian	lv
❌	Polish	pl
❌	Portuguese	pt
❌	Romanian	ro
❌	Russian	ru
❌	Spanish	es
❌	Turkish	tr
❌	Vietnamese	vi

API#

Since Likes 2.2.0 and BentoBox 1.17 other plugins can access to the Likes addon data directly.

Maven Dependency#

Likes provides an API for other plugins. This covers version 2.2.0 and onwards.

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

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

Use the latest Likes version.

The JavaDocs for Likes can be found here.

Events#

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

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

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

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

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

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

Addon Request Handlers#

Till BentoBox 1.17 we had an issue with accessing data outside BentoBox environment doe to the class loader we used to load addons. This meant that data was accessible only from other addons. But BentoBox implemented PlAddon functionality, which means that request handlers are not necessary anymore.

More information about addon request handlers can be found here

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();
}

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();
}