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 - **Mob stacking**: Automatically combines similar mobs when they're within a defined radius, reducing the total number of entities. - **Advanced customization**: - Define a stacking radius. - Limit the maximum stack size. - Exclude certain mob types from stacking (e.g., villagers). - **Detailed statistics**: - Display statistics of stacked mobs by world and type. - Calculate performance gain in percentage. - **Powerful commands**: - 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 ```