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.