# HardcoreMobs
\n**New customizable plugin for your bosses!**<\/p>\n
**What does it provide you?**
\n– Customizable name, health and type of boss!
\n– Own script system for better use!
\n– Customizable boss bar and entity equipment!
\n– Event script system!
\n– PlaceholderAPI support!
\nOriginally, this plugin was created for Paper 1.16.5. But I think it will work perfectly on 1.13 and above.<\/p>\n
**How does it works?**
\n– Entity configures only through config. You are one, who’s writing your functionality for your boss.
\n– Bossbar progress is entity HP.
\n– Only one boss is available in one time. But you can spawn others.
\n– Each boss is independent.
\n**The structure of config looks like this:**
\n“`yaml
\nboss:
\n displayName: “Test boss” # The display name of boss
\n health: 200 # Health of boss
\n type: ZOMBIE # Type of spawned entity
\n spawnLocation: # Spawn location origin
\n x: 0
\n y: 100
\n z: 0
\n world: world
\n bossBar: # Boss bar section, for better understanding look in https:\/\/hub.spigotmc.org\/javadocs\/spigot\/org\/bukkit\/boss\/BossBar.html
\n title: “This is my boss!”
\n color: RED
\n style: SOLID
\n flags:
\n – “CREATE_FOG”
\n – “DARKEN_SKY”
\n radius: 20
\n equipment: # Optional. You can put one, or all slots. Refer to https:\/\/hub.spigotmc.org\/javadocs\/spigot\/org\/bukkit\/inventory\/EquipmentSlot.html
\n HEAD: # Here you must put ItemStack instance. Use other plugins config for this.
\n CHEST:
\n LEGS:
\n FEET:
\n HAND:
\n OFF_HAND:
\n BODY: #For horse and wolf,
\n SADDLE: # Horse and pig.
\n eventScripts: # And this part is interesting
\n damage: # Activates when boss received damage
\n – “”
\n attack: # Activates when boss attacked player(Not triggered by [ATTACK])
\n – “”
\n death: # Activates when boss were killed
\n – “”
\n preSpawnScript: # Activates, when \/hmobs spawn were executed
\n – “”
\n spawnScript: # Activates only when [SPAWN] was invoked
\n – “”
\n“`<\/p>\n
**List of all script commands:**
\n“`
\n[ATTACK] playerName damage – Attacks specific player. Good to use with “damage” event
\n[DIRECT] playerName text – Sends message to specific player. Useful, when you need privacy.
\n[SET] key value – Sets value in local placeholder system. Use %name% to use this value.
\n[CHECK] condition scriptLine – Checks for condition and executes script command. Only available !=(not equals) and ==(equals).
\n[CONSOLE] command – Executes command as console.
\n[BROADCAST] message – It’s obvious.
\n[PLAYERS] radius command – executes command for players in radius. Use %player% to access player name.
\n[RANDOM_PLAYER] radius command – Same as PLAYERS, but selects one specific player.
\n[RANDOM] chance scriptLine – Randomly executes command. Good for surprises!
\n[MESSAGE] radius message – Sends message for all players in radius.
\n[ACTIONBAR] radius message – Same as MESSAGE, but sends in actionbar.
\n[SOUND] type volume pitch – Sends to each player sound. Look about sound type in Spigot wiki.
\n[SOUND_GLOBAL] type volume pitch – Same as SOUND, but plays sound from spawn location globally.
\n[PLAYERSOUND] radius sound volume pitch – Same as SOUND, but uses radius.
\n[COOLDOWN] radius material delay(ticks) – Adds to all players in radius item cooldown. No one will escape mighty boss!
\n[DELAY] ticks scriptLine – Runs script line after time.
\n[SPAWN] – Spawns entity and invokes “spawnScript”.
\n[EFFECT] PotionEffectType duration amplifier – Adds effect to boss. Look about it on Spigot wiki.
\n[ANTIRELOG] radius – Activates player PvP cooldown in radius. Works only with 2 or more players in radius. Works only when AntiRelog installed.
\n[REPEAT] delay name – Same as while in coding. Runs to the moment of mob death, or when plugin were reloaded. Must ends with [REPEATEND].
\n[REPEATEND] – Obvious.
\n[REPEATBREAK] name – Stops REPEAT when you need.
\n[FOR] count delay – Runs block of code “count” amount of times with delay. Need to be closed with [FOREND].
\n[FOREND] – And again – obvious.
\n“`
\n**Local placeholders:**
\n“`
\n“damage” script section:
\n%attacker% – player who attacked boss
\n%damage% – count of dealt damage (type: double)<\/p>\n
“death” script section:
\n%killer% – player who killed boss<\/p>\n
Overall placeholders:
\n%name% – display name of boss
\n%center% – centers text. Put this on start of message. Works only in [BROADCAST], [MESSAGE], and [ACTIONBAR]
\n%player% – shows player name. Works only in [PLAYERS], [RANDOM_PLAYER], [MESSAGE], [ACTIONBAR].
\n%top1% – shows top 1 player in damage dealing to boss. Shows “null” in [DIRECT], [SET], [CHECK], [ATTACK] if not set. In other commands doesn’t replaced.
\n%top2% – shows top 2 player in damage dealing to boss. Shows “null” in [DIRECT], [SET], [CHECK], [ATTACK] if not set. In other commands doesn’t replaced.
\n%top3% – shows top 3 player in damage dealing to boss. Shows “null” in [DIRECT], [SET], [CHECK], [ATTACK] if not set. In other commands doesn’t replaced.
\n%top1_damage% – shows top 1 dealt damage to boss. Shows “null” in [DIRECT], [SET], [CHECK], [ATTACK] if not set. In other commands doesn’t replaced.
\n%top2_damage% – shows top 2 dealt damage to boss. Shows “null” in [DIRECT], [SET], [CHECK], [ATTACK] if not set. In other commands doesn’t replaced.
\n%top3_damage% – shows top 3 dealt damage to boss. Shows “null” in [DIRECT], [SET], [CHECK], [ATTACK] if not set. In other commands doesn’t replaced.
\n%your_key% – shows your value, seted through [SET] command.
\n“`<\/p>\n
# Important notes!
\n**I’d very recommend to not use nested [REPEAT]. Better is to run them separately.**<\/p>\n
**Also, you can’t run [FOR] cycle in [REPEAT]. This is for safety of your performance.**<\/p>\n
**When you using PlaceholderAPI placeholder, plugin looks first for his placeholders, and after parses PlaceholderAPI.**<\/p>\n
**Values, set in one script section, won’t work. For example:**<\/p>\n
“`yaml
\n“death”:
\n– “[SET] killed yes”
\n– “[BROADCAST] %center%%killed%” # Wrong!
\n“`
\n“`yaml
\n“attack”:
\n – “[SET] lastDamage %damage%”
\n – “[SET] lastAttacker %attacker%”
\n“death”:
\n – “[BROADCAST] %center%%lastAttacker% killed boss, dealing %lastDamage% damage!” # Not perfect, but great example!
\n“`<\/p>\n
# How to install\/configure:
\n1. Download .jar file.
\n2. Put your .jar file in “plugins” folder.
\n3. Create folder “HardcoreMobs”, and in this folder, create “mobs.yml” file.
\n4. Edit your config, and enjoy!<\/p>\n
Some unuseful shit:
\n– My discord: blxxdx_1
\n– [My server’s discord [RU]](https:\/\/discord.gg\/56A4nTEZR7)<\/p>\n","protected":false},"excerpt":{"rendered":"
Script your own boss!<\/p>\n","protected":false},"featured_media":79412,"template":"","meta":{"_minecraft_slug":"hardcoremobs","_minecraft_project_id":"kWD00GTk","_minecraft_author":"BLXXDX","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":79,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hardcoremobs.zip","_minecraft_size_bytes":32278,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:15:29.561222Z","_minecraft_date_created":"2025-05-02T22:47:21.681419Z","_minecraft_date_modified":"2025-04-26T01:14:42.716211Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hardcoremobs","_minecraft_icon_attachment_id":79412,"_minecraft_imported_at":"2026-06-04T13:56:17+00:00","_minecraft_import_hash":"b7e4792f59721b4d6624fcf52a05ecc3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,137,127,129,123,92],"mod_loader":[130,132,134],"minecraft_version":[438,110,115,118,49,51,54,59],"class_list":["post-79411","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-mobs","mod_category-paper","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-14","minecraft_version-1-15","minecraft_version-1-16","minecraft_version-1-17","minecraft_version-1-18","minecraft_version-1-19","minecraft_version-1-20"],"yoast_head":"\n