MobStackerPremium

MobStackerPremium

MobStackerPremium is a Spigot plugin designed to improve your Minecraft server's performance by reducing the number of entities through a mob stacking system. This plugin is fully customizable and offers powerful commands to manage and monitor stacked mob statistics.

Features

- Asynchronous optimization: Automatically combines similar mobs when they're within a defined radius, reducing the total number of entities. - Asynchronous optimization: - Define a stacking radius. - Limit the maximum stack size. - Exclude certain mob types from stacking (e.g., villagers). - Asynchronous optimization: - Display statistics of stacked mobs by world and type. - Calculate performance gain in percentage. - Asynchronous optimization: - Reload the configuration without restarting the server. - Give players a special stick to manually force mob stacking in a defined area. - Asynchronous optimization: The plugin is designed to run asynchronously to avoid any impact on server stability.

***

Installation

1. Download the plugin JAR file. 2. Place it in your Spigot server's `plugins` folder. 3. Restart your server to generate the configuration files. 4. Customize the `config.yml` file according to your needs.

***

Commands

| Command | Description | Permission | |--------------------------|-----------------------------------------------------------------------------|------------------------------| | `/mobstacker` | Displays the plugin help. | None | | `/mobstacker help` | Displays the plugin help. | None | | `/mobstacker stats` | Displays statistics of stacked mobs by world and type. | None | | `/mobstacker reload` | Reloads the plugin configuration. | `mobstackerpremium.reload` | | `/mobstacker stick` | Gives a special stick that allows manual mob stacking. | `mobstackerpremium.stick` |

***

Permissions

| Permission | Description | |------------------------------|--------------------------------------------------| | `mobstackerpremium.reload` | Allows reloading the plugin configuration. | | `mobstackerpremium.stick` | Allows obtaining the stacking stick. |

***

Configuration (`config.yml`)

Here's an example default configuration:

```yaml

MobStacker Premium Configuration

Maximum stack size

max-stack-size: 50

Radius for automatically stacking mobs

stack-radius: 5.0

List of mob types excluded from stacking

excluded-mobs: - VILLAGER - WITHER - ENDER_DRAGON

messages: stick-success: "&aNearby mobs have been stacked!" ```

***

How the stacking stick works

The stacking stick is a special tool that allows players to manually force mob stacking in a defined area.

How to obtain the stick?

Use the following command (requires the `mobstackerpremium.stick` permission):

``` /mobstacker stick ```

How to use the stick?

1. Hold the stick in your main hand. 2. Right-click in an area containing multiple mobs. 3. Nearby mobs will be automatically stacked.

***

Statistics

Use `/mobstacker stats` to display the following information:

- Performance gain in percentage (based on the total number of reduced entities). - Total number of stacked mobs by world and type.

Example output:

``` === Stacked mobs statistics === Performance gain: 35.67% Statistics by world: - World: world * ZOMBIE: 120 * SKELETON: 80 - World: nether * PIGLIN: 50 ```