[MobArena Addon] HavenArena - Extra Customizable Features

## v1.9.0.381 New Abilities & Advancing Update **Added**: New boss abilities: - Gravity Shift - *Shift gravity, making players float upwards for a few seconds*. - Leap Target - *The boss leaps towards the target*. - Leap Distant - *The boss leaps towards a random distant player*. - Vampiric Aura - *Siphon health from all nearby players*. - Raging Winds - *Slowly push all players within range away from the boss for a set duration*. - Illusions - *Summon clones of the boss for a time, to confuse the players*. - Healing Prism - *Summon a prism to heal the boss every so often for a set duration, if within range*. **Added**: New boss abilities "-all", "-nearby", "-target", for the following effects: - Poison - Wither - Slow (Slowness) - Blind (Blindness) **Added**: Advancing entries now support multiple waves in the same entry. To add mutliple waves, simply split them with ','. ```yml arenas: # Arena name, as defined in MobArena's config. CoolArenaName: # Entry names can be whatever you want. EntryOne: wave: 35,36,42 spawnpoints: players: # Where we want players to teleport to. targ... ``` **Changed**: `/havenarena reload` now reloads MobArena as well, if "boss-abilities.enabled" is enabled in the config.<br> *In addition it will also reload all custom abilities.* **Fixed**: Fixed an error when the arena ends due to a player dying.<br> *This error never broke anything, was just spamming the console.*

## v1.8.3.327 Hotfix & Advancing Update **Added**: Advancing now teleports new spectators to the correct part of the arena. **Fixed**: Fixed an issue causing errors when using newer versions of ValorlessUtils.<br> _Its only a SFX bug, and the rest of the plugin should work as intended, it just couldn't play sounds._

## v1.8.1.295 Hotfix & Placeholder **Added**: Placeholder %havenarena_alive_ARENA%. ```yaml # %havenarena_alive_ARENA% # Placeholders: # %alive% - Alive Players # %players% - Players Count alive: '&f%alive% / %players% players alive' ``` **Changed**: HavenArena's internal ready-list is now updated when a player leaves the arena lobby. If the player was on the list, remove them, if not, check if all are ready as usual. **Fixed**: The Minions ability should now work when boss-specific entity types are specified. **Fixed**: Fixed a bug causing arenas to not start, if a ready player left the lobby. Only if using the HavenArena's custom ready block.

## v1.8.0.286 Placeholders & Boss Ability Title **Added**: PlaceholderAPI placeholders: - %havenarena_status_ARENA% (Returns a text as defined in placeholders.yml) - %havenarena_players_ARENA% (Returns a text as defined in placeholders.yml) - %havenarena_progress_ARENA% (Returns a text as defined in placeholders.yml) - %havenarena_wave_ARENA% (Returns the number of the current wave) - %havenarena_finalwave_ARENA% (Returns the number of the final wave) - %havenarena_active_arenas% (Returns the number of active arenas) _Replace ARENA with the arena's name, as defined in MobArena's config._ **Added**: onBossAbility Title.<br> config.yml ```yml # Settings for the onBossAbility title. # Requires the setting "boss-abilities" to be enabled. onBossAbility: # Should we disable the title for specific bosses? # Such as those with a low ability interval. disabled-for: boss1: false boss2: true ``` lang.yml ```yml # Title shown on boss abilities. ## Placeholders ## # %ability% - Name of the ability. on-boss-ability: '' on-boss-ability-sub: '&c%ability%' on-boss-ability-sound: 'BLOCK_NOTE_BLOCK_BELL' ```

## v1.7.0.248 MobArena 0.109 and Updates **Recommended**: Update MobArena to v0.109, as a fix was made to one of the main events HavenArena uses. https://www.spigotmc.org/resources/mobarena.34110/update?update=565214 **Recommended**: Update ValorlessUtils to 1.9.0. It's less spammy, and invalid config files are no longer vanishing. https://www.spigotmc.org/resources/valorlessutils-1-17-1-21-1.109586/update?update=563981 **Added**: Arena Advancing. <details> <summary>advancing.yml</summary> ```yml ############################################################ # +------------------------------------------------------+ # # | Arena Advancing | # # +------------------------------------------------------+ # ############################################################ # # Here we'll define specific waves for specific arenas, # where the players will be teleported to another section of the arena. # # Careful not to have MobArena's config setting "spawnpoint-max-distance" set too high, # Otherwise mob can spawn away from the advancing point, possibly soft-locking the arena. # arenas: # Arena name, as defined in MobArena's config. CoolArenaName: # Entry names can be whatever you want. EntryOne: wave: 35 spawnpoints: players: # Where we want players to teleport to. target: # The center of blocks are .5 x: 100.5 y: 65 z: 326.5 # If offset is 0, all players spawn directly on the target. # If offset is 2, all players spawn within 2 blocks around the target. # Offset only affects x/y. offset: 2 spectators: # Where we want spectators to teleport to. target: # The center of blocks are .5 x: 100.5 y: 75 z: 326.5 # If offset is 0, all players spawn directly on the target. # If offset is 2, all players spawn within 2 blocks around the target. # Offset only affects x/y. offset: 2 # Entry example with comments stripped. EntryTwoStripped: wave: 35 spawnpoints: players: target: x: 100.5 y: 65.5 z: 326.5 offset: 2 spectators: target: x: 100.5 y: 75.5 z: 326.5 offset: 2 ``` </details> **Added**: Custom Ready/Unready events! **Added**: You can now see how many players aren't ready, and which player is the last to not ready up! <details> <summary>Configs</summary> config.yml ```yml # Show how many players arent ready? ready-missing: true ``` lang.yml ```yml # Actionbar message when readying up. # # Placeholders ## # %missing% - Amount of players not ready. ready-missing: '&c%missing% players aren''t ready.' # Actionbar message when readying up, and only 1 player is missing. # # Placeholders ## # %missing% - Player's name. ready-missing-last: '&c%missing% isn''t ready.' ``` </details> **Added**: 2 new boss abilitites: MinionsExplode & MinionsSacrifice ```yml abilities: custom: minions-sacrifice: heal: 4 # How much the boss is healed per minion. 2 = 1 heart minions-explode: damage: 10.0 # How much damage should the explosion deal? (Does not drop-off with distance) power: 2.0 # The power of explosion, where 4 is equivalent to TNT. radius: 2.0 # Range of the explosion ``` _In both cases, the minions die._ **Added**: You can now specify the min and max iframes for bosses. **Added**: You can now define different names, types, and health for the Minions ability, depending on the boss. ```yml abilities: custom: minions: # Minions don't despawn when the boss dies. amount: 4 # How many minions should we spawn? radius: 1.0 # How far from the boss should we spawn the minions? # Placeholder: Boss' name - %boss% name: '%boss%''s Minion' custom: boss1: 'Spawn of %boss%' type: ZOMBIE # https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html health: 20 # 2 = 1 heart ``` _Replace "boss1" with the wave key in the MobArena config._ **Added**: Titles for Swarm and Special waves! **Added**: You can now assign class-specific colors for %class% in lang.yml ```yml # Class specific colors for the %class% placeholder. # CaPs SeNsItIvE :D class-colors: Knight: '&e' Tank: '&b' Archer: '&a' Chemist: '&d' Oddjob: '&c' ``` **Added**: Class preview now supports class chests. **Changed**: The onBoss title now has it's own title-timings. **Hotfix**: BarrageTarget no longer cause errors when the target is null. **Hotfix**: Fixed a bug causing HavenArena's internal arena instances to not be removed, if the config "titles.onPlayerDeath" was set to false. Minor bug, as in most cases this would only have a tiny tiny impact. **Hotfix**: Fixed some minor bugs where spectators were counted as a part of the arena. **Removed**: Teleport-on-end.

## v.1.6.0.163 Boss Abilities & Updates **Added**: Boss Abilities: - Arrow Rain - Barrage All - Barrage Nearby - Barrage Random - Barrage Target - Potion Rain - Potion Rain (Lingering) <details> <summary>config</summary> ```yml arrow-rain: size: 7 # How far around the boss should arrows spawn? altitude: 7 # How high above the boss should arrows spawn? speed: 0.3 # How fast should arrows fall? barrage-nearby: count: 7 # How many arrows are fired? speed: 1.0 # How fast should arrows travel? delay: 2 # How much delay between each arrow? (In ticks, 20 ticks = 1 second) radius: 3 # How close players must be to be affected by the ability. potion-rain: size: 5 # How far around the boss should potions spawn? altitude: 7 # How high above the boss should potions spawn? speed: 0.3 # How fast should potions fall? effect: POISON # Potion Effect or RANDOM - https://helpch.at/docs/1.20.3/org/bukkit/potion/PotionEffectType.html duration: 60 # How long should the potion effect last? (In ticks, 20 ticks = 1 second) level: 1 # What level of the effect should be used? ``` </details> **Added**: Option to clear enchants from mobs. ```yml # Clear weapon enchants on mobs? clear-enchants: false ``` **Added**: You can now give the onNewWave event a delay. <br>_Not all servers are the same, so some might start their wave right away, and some might have a delay. You can give onNewWave a delay, to better match your arenas wave delay._ **Added**: You can now change on the lang settings of class previews. ```yml class-preview: ## Placeholders ## # %class% - Their class. gui-title: 'Previewing: %class%' class-unknown: 'Unknown class.' no-permission: 'No permission.' ``` **Changed**: HavenArena now automatically reloads MobArena, to load custom abilities. **Fixed**: The ability "Minions" now correctly loads the decimal of the setting value. <br>_Was being loaded as a whole number._

## v.1.5.0.140 Class Preview & Hotfix. **Added**: You can now preview classes with "/ha preview <class>". Do note that you have to set up permissions required to preview. **Fixed**: The permission "havenarena.reload" is now correctly required to reload the plugin.

## v.1.4.1.103 Hotfixes **Added**: Option to teleport players to the arenas exit, should there be a bug preventing it. **Fixed**: Supressed an error where the wave type returned null, when trying to glow mobs in the arena.

## v.1.4.0.100 Ability, IFrames, and hotfixes. **Added**: Custom boss abilitites, with the option to customize their settings! Abilities: - Minions ```yaml minions: # Minions don't despawn when the boss dies. amount: 4 # How many minions should we spawn? radius: 1.0 # How far from the boss should we spawn the minions? # Placeholder: Boss' name - %boss% name: '%boss%''s Minion' ``` **Added**: Title for : onUpgrade, onSupply, onEnd, onComplete. **Added**: You can now specify boss' i-frames. ```yaml # How many ticks until the boss can be hit again? # The lower the number, the better for more players. # 20 is Minecraft default. # Cannot go below 1. ## Placeholders ## # %players% - Players in the arena. boss-iframes: enabled: true formula: '20 - (%players% * 3)' ``` **Added**: Wave title will no longer be shown, if the current wave is higher than the last wave. **Changed**: Title timings have been split up into their separate event. **Changed**: Mob glow no longer trigger on boss waves. Wasn't an issue, but would be with the Minions ability. **Fixed**: Fixed an issue where healing didn't trigger, if you had the newWave title disabled. **Fixed**: Fixed a bug where HavenArena was unable to fetch the MobArena config file. **Fixed**: Fixed an issue causing the special-multiplier to not work at all. **Fixed?**: Fixed a bug flipping the config values for titles. Either fixed, or I missed something originally..

**Added**: You can change the settings of the default MobArena boss abilities! **Added**: Custom boss abilitites, with the option to customize their settings! Abilities: - KnockupAll - KnockupNearby - KnockupRandom - KnockupTarget - ShuffleHotbar **Added**: You can now specify a formula to increase mob count on Special waves.