CustomMobArena

​CustomMobArena: Improved Survival Arena
​CustomMobArena is a powerful and easily customizable plugin that turns any area of your world into an endless battleground. Give up boring vanilla spawn! Our plugin offers fully customizable challenges with unique rewards.
​, Main functions:
​Customizable Spawn: Define the exact boundaries of the arena using two points (P1/P2) and adjust the number of mobs that will appear in a given time interval.
​Enhanced Mobs: The chance of mobs with increased health, unique names, and custom equipment (armor and enchanted weapons).
​Two-level loot system:
Standard Loot: Determine the chance of losing valuable resources from regular mobs.
​Boss Loot: A separate, more valuable loot table for enhanced mobs, which guarantees a decent reward for a difficult battle.
​User-friendly operation: Intuitive administrative commands (/mobarena setp1|setp2|start|stop|reload).
​Loot Interface: Players can view all possible rewards through the GUI command (/mobarena loot).

I. 🗺️ Installing and Configuring the Arena
​For the plugin to work, it is necessary to define the boundaries of the combat zone (cuboid) and control the spawn cycle.
​Setting the boundaries:
/mobarena setp1 (Permission: custommobarena.admin): Sets the first corner point (P1) of the arena.
​/mobarena setp2 (Permission: custommobarena.admin): Sets the second corner point (P2) of the arena.
​Cycle control:
/mobarena start (Permission: custommobarena.admin): Starts a permanent spawn cycle for mobs.
​/mobarena stop (Permission: custommobarena.admin): Stops the spawn cycle.
​/mobarena reload (Permission: custommobarena.admin): Reloads configuration files (config.yml and loot.yml).

II. ⚔️ Battle Mechanics and Spawn
​The plugin works in constant spawn mode (without waves), based on the settings from config.yml.
​Spawn Settings:
​mobs_to_spawn: The number of mobs that spawn in one cycle.
​respawn_delay_seconds: The interval (in seconds) between spawn cycles.
​mob_type: The main type of entity that will spawn (for example, ZOMBIE).
​Enhanced Mobs (Customization):
​chance_to_be_custom: The chance (0.0 to 1.0) that the mob will receive enhanced stats.
​Health: Enhanced mobs gain a health multiplier, making them mini-bosses.
​Equipment: Custom equipment (armor and enchanted weapons).

III. , Loot System
​The plugin implements a two-level system of custom loot, which completely replaces the standard drop mobs.
​Standard Loot:
Usage: Drops from regular mobs. It contains basic resources.
​Config: default_loot section in loot.yml.
Boss Loot:
Usage: Drops from enhanced (custom) mobs. It contains more rare and valuable items (for example, nezerite, enchanted apples).
Config: boss_loot section in loot.yml.
​, Loot viewing
​/mobarena loot (Permission: custommobarena.loot): Opens a GUI menu displaying all available loot (standard and boss loot), indicating the chance and quantity.

IV. ⚠️ Notes for Administrators
​Version conflict: If an older version of the Spigot API (prior to 1.13) is used, the equipment drop chance setting function may not work. Mobs' equipment will drop with a default chance.
​Loot Configuration: To add new items to the loot.use yml Material.name in uppercase (for example, DIAMOND, IRON_SWORD).

​🚀 V. Installation and Compatibility

1. Supported Versions and Kernel
   ​The CustomMobArena plugin is designed and optimized for modern versions of the Spigot, Paper core or their forks.
   ​Core: Spigot, Paper, Purpur, or similar cores that support the Bukkit/Spigot API.
   ​Minecraft versions: 1.16.5-1.21.x
   Note: Although the plugin can work on versions 1.13–1.16.4, official support and testing are conducted on 1.16.5-1.21.x since this version uses a modern API for working with charms and objects (NamespacedKey).
2. Installing the Plugin on the Server
   ​To install the plugin, follow these steps:
   ​Download the JAR file.
   ​Transfer the file: Copy the CustomMobArena-1.0-SNAPSHOT file.jar to the plugins/ folder on your Minecraft server.
   ​Reboot/Start the server:
   ​If the server is already running, run the /reload command (not recommended, but it works).
   Recommended: Perform a complete restart of the server so that the plugin fully downloads its configuration files.
   ​Check the configuration: After the first download, the CustomModArena folder will appear/
   ​Set up the boundaries: Log into the server and use the commands /mobarena setp1 and /mobarena setp2 to set the boundaries of the arena.
   ​Run: Enter the command /mobarena start to start spawning mobs!
3. Dependencies
   ​Currently, the CustomMobArena plugin does not have mandatory third-party dependencies.