🤖Installation
Note: The difference between being Compatible and providing Support: If an option is Supported, that simply means that our staff will be willing to resolve an issue, bug, or question concerning that option should a solution be available. It means that we intend for our plugin to be Supported, or functional, for the listed option. It does not mean that we can provide an answer to every possible combination of issues which may be occurring on your server. If an option is Compatible, that simply relays to you the degree to which you should expect our plugin to function while on your server without issues or errors. We cannot account for every situation, but if an option is listed as having a high degree of Compatibility, then you should expect that plugin to function as intended on your server. If you are experiencing an issue with a listed compatible option, we recommend first investigating if other plugins may be causing an issue. You can do this by running your testing server with just LevelledMobs and see if the issue is reproducible. If it is not, then return more plugins to the server until you have discovered the incompatible plugin. If this does not resolve the issue, then you might suggest submitting the question to the ArcanePlugins Support Discord.
Are you running a compatible server software?
| Server | Compatibility | Support | Notes |
|---|---|---|---|
PaperMC | * Recommended Software | ||
Folia | |||
PurpurMC | |||
SpigotMC | Limited compatibility; some optional features require PaperMC or a fork thereof. | ||
Mod or Hybrid Servers: Mohist; Arclight; Cauldron; Magma; etc. | The Bukkit API was never written to accommodate mods! These server software often require changing core functionality which plugin developers, including ourselves, rely on for their plugins to work. They also are prone to generating unreproducible, unpredictable, situation or user-specific bugs which are more or less unfixable. |
In general, we aim to support PaperMC over any other plugin software. We do strive to provide support for SpigotMC as well, though some optional features are unavailable to those users.
Are you running a supported Minecraft version?
| Minecraft Version | Compatibility | Support | Notes |
|---|---|---|---|
1.15 and before | Support and Compatibility dropped with | ||
1.16 - 1.17 | Support and Compatibility dropped with | ||
1.18 - 1.19 | * Support may be dropped in favor of 1.20+ in the future | ||
1.20 to latest |
In general, we attempt to commit to a two-version layer of compatibility. That means whatever version of Minecraft is currently available, plus the previous two versions. For example, for Minecraft 1.20 support, we intend to also provide support for Minecraft 1.18-1.19 as well. This cannot always be the case, and sometimes there is compatibility beyond the two-versions. Users are always notified if there is a change worth noting.
Are you running the correct Java version?
We currently require users to be running Java 17 or higher. As of Minecraft 1.16, servers have been required to have at least Java 17, so this should not be an issue. Our support staff will not assist in managing your Java installation, as there are many free tutorials available on the internet.
As of Minecraft Snapshot 24w14a [pre-1.20.5], the base game requires Java 21 or higher to function. This will almost certainly apply to the final release version. If you intend to use LevelledMobs 4, and intend to use 1.20+ Minecraft servers, then it's highly suggested you use Java 21 or higher.
Our staff recommend using OpenJDK. It provides an implementation of the Java Standard software for your Java installation requirements. It is both free and open-source, and the code is derived directly from the GPL-licensed binaries which are also open-source.
Did you install any plugins with known issues?
We have discovered over several years that there are certain specific and non-specific plugins which either fail entirely, cause inconsistencies with LevelledMobs, break native features we use or cause unintended effects. Some of these issues contain solutions, some do not. It is not for us to resolve every potential issue with every plugin on the internet; even though we make the effort all the time.
| Plugin / *Type | Issue Severity | Notes |
|---|---|---|
This plugin contains it's own mob health bar function which should be disabled if you use LevelledMobs' nametag feature to prevent double nametags. | ||
This plugin will obscure the nametag we send to a mob. This is typically because the models used by this plugin do not contain a standard nametag position. There are ways to create nametags within this plugin, and other than the missing nametags the entities are still being levelled according to the rules. | ||
* Holograms | Plugins which send false holograms centered on mobs or within their custom-name field will interfere with our own nametag features. We utilize false packets to send nametag information directly to the players' client. Anything which interferes with this process may affect the nametags of entities. | |
* Stackers | Any plugin stacker which stacks mob entities together will simply not function with LevelledMobs. Most of the time, after the first mob is killed, one of two things occur: either LevelledMobs isn't informed of a new mob existing and so the new mob is not levelled, or the new mob will be reprocessed as if it's an entirely different entity because it's essentially spawning in a new mob under different conditions. They do not provide any resource management improvements in todays' age, especially if using PaperMC. |
Did you install LevelledMobs in the proper location?
You might think it would be obvious, if you made it this far, that you should know where you install plugins you download for your Minecraft server. To be very clear: the LevelledMobs .jar file needs to be placed inside the /plugins/ folder of your Minecraft server's root location. If your server installation doesn't have a /plugins/ folder, then it has either not been installed properly or you are not running a compatible or supported server software. Please diagnose this issue yourself.
[Optional] Did you install any supported plugins?
We provide multiple optional features and functionalities through integrations with several different plugins. There are also some extended-feature plugins created by our own ArcanePlugins Developers which provide expanded abilities within CustomDrops and beyond. If you want to use these optional features, you need to install the latest version of the respective plugin.
| Plugin | Accessible Features |
|---|---|
:: Official Addon :: LM Items | When using CustomDrops, when using this plugin, you may connect the CustomDrops system to many various popular item creation plugins. For more information, check out the wiki for LM Items. |
:: Official Addon :: Armor Placeholders | *Requires PlaceholderAPI Armor Placeholders generates a numerical value based on the equipment the player is wearing, taking into account enchantments and damage, and scoring these items based on configurable values. Use with Player Level Modifier to bump the challenge based on the players' armor skills. |
:: 3rd Party Support :: MobHunting | Through MobHunting, you can earn more money from killing higher level mobs. |
:: 3rd Party Support :: Money From Mobs | Through Money From Mobs, you can earn more money from killing higher level mobs. |
Using PlaceholderAPI [PAPI] tags; useful for Player Level Modifier application. | |
When using the option | |
When using the option |
[Optional] Did you install any integrated plugins?
These are plugins which we have written a special condition check for, whether internal hard-coded support for more complicated plugins, or external hand-crafted support through the new LevelledMobs4 externalplugins.yml file, which allows you to write your own 3rd party plugin support condition checks based on commonly used data storage and searching features.
| Plugin | Int/Ext Support | Notes |
|---|---|---|
Internal | ||
External | Uses: | |
Internal | ||
External | Uses | |
Internal | ||
External | Uses | |
Internal | ||
External | Uses |
Everything good so far? Proceed to Errors and Running LM!
Last updated
