IslandStats#

IslandStats keeps statistics for each island rather than for each player. It starts with mob deaths: how many of each mob has died on an island, and how many of those a player killed. It works with every game mode.

Created and maintained by tastybento.

Installation#

1. Place the IslandStats addon jar in the addons folder of the BentoBox plugin.
2. Restart the server.
3. The addon will create a data folder and inside the folder will be a config.yml.
4. Edit the config.yml how you want.
5. Restart the server if you make a change.

IslandStats requires BentoBox 3.23.0 or later, Minecraft 26.2 or later and Java 25.

Statistics#

The addon keeps two counts for each mob type:

A death counts for the island whose protected area it happened in. Players and armor stands are not counted. Kills by visitors count toward KILL_ENTITY unless count-visitor-kills is turned off. Every death on the island always counts toward ENTITY_DEATH.

The addon doesn't use vanilla player statistics, because they only record kills where a player gets the credit and they don't record where the mob was. That would miss mob farms and credit the killer's island rather than the island the mob died on.

Stats dialog#

/[player_command] stats opens a dialog:

• The summary page shows a total for each stat, with a button to open it.
• Each stat page lists mobs from most to fewest, with Previous, Next, Back and Close buttons.
• Mob names are sent as translatable text, so each player sees them in their own client language.

Storage#

Stats are stored through the BentoBox database API, so they go into whatever database BentoBox is set up to use. There is one record per island. With the JSON database these are in plugins/BentoBox/database/IslandStatsData/. Counting happens in memory, and changed islands are saved on a timer (save-interval) and when the server stops. When an island is deleted or reset, its stats are deleted too.

Configuration#

The latest config.yml can be found here.

disabled-gamemodes:
  - BSkyBlock

Commands#

Permissions#

Placeholders#

<entity> is the lower case mob type, such as zombie or iron_golem. With PlaceholderAPI the placeholders look like %IslandStats_bskyblock_island_kill_entity_zombie%.

For addon developers#

Other addons can read counts through the manager:

IslandStats stats = (IslandStats) BentoBox.getInstance().getAddonsManager().getAddonByName("IslandStats").orElseThrow();
long zombies = stats.getManager().getCount(island, IslandStat.KILL_ENTITY, EntityType.ZOMBIE);
long allDeaths = stats.getManager().getTotal(island, IslandStat.ENTITY_DEATH);

Translations#