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:

# 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