Skip to main content

Setup video

This guide is for EliteMobs 9.0 or later. EliteMobs 9.x requires Minecraft 1.21.0 or higher.

Requirements​

  • Minecraft Version: 1.21.0 or later
  • Java Version: Java 21 or later (required by Minecraft 1.21.0+)
  • Server Software: Spigot, Paper, or compatible fork

First boot

Restart the server once.

Why?

EliteMobs automatically adjusts the maximum health setting in your spigot.yml config file to 100,000,000 during startup. This allows Elite mobs to have more than 2000 health. The plugin checks this value on each startup and updates it if necessary. It does not alter the health of any other mob - so it doesn't change vanilla or plugin mobs.

This change requires a server restart to actually work.

Permissions

All recommended permissions are configured by default. You can see more about permissions here.

EliteMobs Initialize Command

If you want to quickly configure EliteMobs, install only the essentials, or disable all content to use your own custom features, then the command /em initialize is for you.

When you run it, you’ll be given three installation options:

  1. Full Install – Everything enabled. This is the default if you use EliteMobs without running the command.
  2. Minimum Install – Most features and content are turned off, except what’s required to make BetterStructures Elite Shrines work. Choose this if you only need the core functionality for the shrines.
  3. Virtually Disabled Install – Disables all EliteMobs features and content. Use this only if you plan to configure everything manually or want to enable only your own content.

Notice: This command does not install any additional content. It only manages the EliteMobs features and content that come by default with the plugin.

EliteMobs Setup Command

Running the command /em setup lets you quickly enable or disable any installed EliteMobs content. This is an easy way to manage features like Default Events, Dungeons, Arenas, and more.

You can also use filters to sort content by category. Note that some content may be missing from the list, as new content is released frequently. Magma does his best to keep it up-to-date.

Notice: When disabling or re-enabling content, EliteMobs will automatically reload. If the menu or your server seems unresponsive, please give it some time to finish. You can always check the console to see when the reload is complete.

Installing Dungeons & Adventurer's Guild Hub World

EliteMobs includes an imports folder in the EliteMobs directory for easy content installation. Installing the Dungeons and Adventurer's Guild World works as follows:

  1. Download the files. You can find the links to all of our content at https://nightbreak.io/plugins/ just click on the plugin you would wish to download content for.

  2. Upload the files to your server's /plugins/EliteMobs/imports folder. Place the ZIPPED files directly inside imports without modifying them. EliteMobs will automatically extract and move the files to the correct locations.

Visual Example

  1. Restart your server or run /em reload. Within a few seconds, the dungeons should auto-install. In /em setup, dungeons you downloaded will show a green indicator, confirming they are properly installed and up-to-date.

    • If a dungeon shows a yellow glass pane, it means a newer version is available and needs to be updated.
Visual Example
  1. Optional: If your dungeon files include Custom Models, follow the installation steps listed here.

That's it! You can access teleports to the installed dungeons either through the /em menu under the Teleports page or through the Adventurer's Guild (You can travel to the Guild using the command /ag).

More info on the Adventurer's Guild here!
Download the Adventurer's Guild Hub World here!

Recommended plugins

Updating dungeon content

To update dungeon content, simply repeat the installation steps above. You do not have to delete any files, EliteMobs handles that when you import the update.

Frequently Asked Questions (FAQ)

Where are the boss custom models and skins I saw in screenshots/videos?​

To see bosses and NPCs with custom skins, you will need to install LibsDisguises.

Custom 3D models for bosses are a relatively recent addition to our content. Most older dungeons do not use them, and even in newer dungeons, they are used sparingly—typically only for final bosses or minibosses.

You can visit Nightbreak's EliteMobs content pages and check the "Technical Details" section to see which content uses custom 3D models or disguises.

The minidungeon is just flat terrain​

Answer

95% of the time this means you did not follow the setup instructions. If you unzipped any files or loaded any worlds using other plugins, reinstall the content following the steps listed above. You do not need any other plugins to load the worlds correctly.

NPC chat looks weird / wormholes aren't working / other weird behavior after installing​

Answer

Run the command /em reload after setting a dungeon up to make sure all of the values get fully initialized. A restart is even better, but should not be necessary.

Bosses aren't spawning​

The boss was spawning earlier!​

Answer

Regional bosses have a respawn time. You can check when the boss is scheduled to respawn by going to its configuration file and copying the numbers after the : in the spawn locations section.

Example:

spawnLocations:
- em_primis,1100.5,22.5,526.5,0.0,0.0:1643259941451

In this case the numbers you're looking for are 1643259941451. You can use this website to convert that to a specific date. You can delete the numbers to force the boss to respawn, make sure you do /em reload after deleting them.

The boss never spawned!​

Answer

Check the following things:

  • Did you or someone else kill the boss, or did it escape via the timeout feature? The boss may be respawning. Check the cooldowns, info about that is in the section above.
  • See if there are any errors on console, especially after you install the dungeon or after an /em reload. The errors should tell you what's wrong.
  • Check if your region is protected by some other plugin that would prevent mob spawning
  • Check the difficulty of your world, mobs can't spawn in peaceful difficulty
  • Check WorldGuard flags, see if mob spawning is set to allow
  • Check if you installed the dungeon content over the spawn area, that is protected by default
  • Very, very rarely, the issue might have to do with the day your server thinks it is. Make sure your server machine's date is correct, otherwise the respawn mechanic might cause some issues.

Something's messed up and I just can't fix it​

Answer

This usually happens after trying and failing to correctly modify files in a way that EliteMobs could not self-repair. If you are stuck and can't figure out how to repair it from the console messages on startup / dungeon installation, the best thing to do is a clean installation of EliteMobs.

Back up your ~/plugins/EliteMobs/data folder to keep player data, then delete the ~/plugins/EliteMobs/ folder. Start your server up, shut it down, restore the contents of your backed up data folder while the server is offline and then start it up again. You can now resume installing EliteMobs content.