Custom Bosses
- Fully configurable boss entities (any mob type)
- Custom display name, health, damage, movement speed, attack speed, knockback resistance, scale
- Custom 3D model support (ModelEngine integration)
- Glow, silent mode, and equipment slots (helmet, chestplate, leggings, boots, mainhand, offhand)
Abilities System
6 built-in abilities, each fully configurable:- Fireball – Launches an exploding fireball (configurable yield, incendiary, radius)
- Tornado – Pulls nearby players into a spinning vortex (radius, duration, pull strength, height, particle)
- Ground Smash – AOE knockup + damage around the boss (radius, knockup strength, damage)
- Sweeping Laser – A rotating beam that deals damage and knockback; boss can be frozen during the sweep (radius, speed, duration, damage, particle, freeze option)
- Summon Minions – Spawns configurable minions around the boss; alive minions auto-despawn after a configurable delay with an effect
- Random Teleport – Boss teleports to a random nearby location with particle effects (departure & arrival particles, radius, attempts)
Reward System
- Two reward modes: ALL_DAMAGERS (everyone who hit the boss) or TOP_DAMAGERS (leaderboard with separate rewards per place)
- Per-reward chance system (
chance:50;cmd:...) - Any console command as a reward (economy, items, crate keys, etc.)
Boss Spawners
- Spawners tied to a fixed world location (with yaw/pitch)
- Two schedule modes:
- TIMES – Spawn at specific times of day (e.g. 12:00, 18:00)
- If the boss is still alive when the next spawn triggers:
-
SKIP – Skip the spawn-
KILL – Kill the existing boss and spawn a fresh one- Chunk is loaded automatically before killing the boss, even if it is unloaded
spawn-commands– Run any console commands when the boss spawns (e.g. broadcast messages)- Enable/disable per spawner
Commands (/mineboss)
summon <bossId> [location]– Manually summon a boss at your location or a given coordinatespawner list– List all spawners with statusspawner info <id>– Detailed spawner info (location, schedule, time until next spawn, boss alive status)spawner create <id> <bossId> interval <min> [SKIP|KILL]– Create a new interval spawner at your locationspawner create <id> <bossId> times <HH:mm,...> [SKIP|KILL]– Create a new times spawner at your locationspawner enable/disable <id>– Toggle spawner on/offspawner spawn <id>– Force-trigger a spawner immediatelyspawner kill <id>– Kill the active boss of a spawnerspawner setlocation <id>– Move spawner location to your current position (saved to YAML)equip <bossId>– Open GUI to equip items on a bossreload– Hot-reload all configuration files
PlaceholderAPI Placeholders
%MineBoss_spawner_<id>_status%– Human-readable status (countdown, boss alive, disabled, etc.)%MineBoss_spawner_<id>_alive%–true/false%MineBoss_spawner_<id>_schedule%– Schedule description (every X min / at HH:mm, ...)
Permissions
- mineboss.reload, mineboss.summon, mineboss.spawner, mineboss.edit
Config & Localization
- Fully separated config files:
entities.yml,abilities.yml,rewards.yml,spawners.yml,lang.yml - All messages translatable via
lang.yml - Hot-reload without restart
YAML:
entities:
Inferno_King:
entity_type: ZOMBIE
display_name: "&c&lInferno King"
model: "demon_knight"
stats:
health: 50.0
damage: 30.0
movement_speed: 3.0
attack_speed: 4.0
knockback_resistance: 10
glow: false
silent: true
scale: 1.0
betweenAbilityCooldown: 80
rewards:
- "infernoKing"
abilities:
- "basic_fireball"
- "basic_tornado"
- "basic_summon_minions"
- "basic_smash"
- "basic_random_teleport"
- "jump_rope"
equipment:
offhand:
mainhand:
helmet:
chestplate:
leggings:
boots:
YAML:
spawners:
# Example 1 – spawn Inferno_King every 30 minutes.
# If the boss is still alive when the timer fires, skip the spawn.
arena_interval:
boss_id: Inferno_King
world: world
x: 0.5
y: 64.0
z: 0.5
yaw: 0.0
pitch: 0.0
enabled: false
if_alive: SKIP
schedule_mode: INTERVAL
interval_minutes: 1
spawn_commands:
- "say The Inferno King has awakened!"
# Example 2 – spawn Inferno_King at 12:00 and 18:00 every day.
# If the boss is still alive, kill it and spawn a fresh one.
arena_times:
boss_id: Inferno_King
world: world
x: 100.5
y: 64.0
z: -200.5
yaw: 0.0
pitch: 0.0
enabled: false
if_alive: KILL # SKIP or KILL
schedule_mode: TIMES # INTERVAL or TIMES
times:
- "12:00"
- "18:00"
YAML:
abilities:
basic_fireball:
type: "Fireball"
cooldown: 100
yield: 2.0
incendiary: true
radius: 20.0
nuke_fireball:
type: "Fireball"
cooldown: 300
yield: 5.0
incendiary: true
radius: 50.0
basic_tornado:
type: "Tornado"
cooldown: 200 # Ticks (10 seconds)
radius: 15.0
durationTicks: 100 # Duration (5 seconds)
pullStrength: 0.3
height: 10.0
particleType: "CLOUD"
basic_summon_minions:
type: "SummonMinions"
cooldown: 400
amount: 3
spawn_radius: 8.0
minion_type: "SKELETON"
health: 20.0 # (-1 = entity default)
damage: 4.0 # (-1 = entity default)
model: ""
despawn_delay_seconds: 10 # Seconds until alive minions are force-despawned
basic_smash:
type: "GroundSmash"
cooldown: 250
radius: 12.0
knockup_strength: 1.2
damage: 8.0
basic_random_teleport:
type: "RandomTeleport"
cooldown: 600 # Ticks (10 seconds)
radius: 20.0 # Max teleport distance
max_attempts: 10 # How many times to try finding a safe spot
particle_count: 60 # Number of particles on depart/arrive
depart_particle: "PORTAL"
arrive_particle: "END_ROD"
jump_rope:
type: "SweepingLaser"
cooldown: 400
radius: 18.0
duration_ticks: 200
damage: 15.0
speed: 0.1
y_offset: 0.4
knockback: 1.2
particle: "firework"
freeze_boss: true # If true, the boss stands completely still during the sweep
