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
- 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).
- 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!
- Dependencies Currently, the CustomMobArena plugin does not have mandatory third-party dependencies.
