Instanced Dungeon Difficulty

Instanced dungeons have a special setting to easily define different difficulties for the dungeon.

How it works

Difficulties are modeled in part after Final Fantasy 14's level sync system.

Elite armor and weapons get specific elite damage and elite defense based on their level, as you can see on items. When in an instanced dungeon with a difficulty on, the level of the item will be temporarily and invisibly lowered to match the level sync.

EliteMobs uses exponential scaling, where every 5 levels of difference doubles the effective power. For example, a level 50 sword is significantly more powerful than a level 45 sword. If a player is in an instanced dungeon with a difficulty that level syncs gear to level 45, the level 50 sword will act as a level 45 sword with proportionally reduced damage.

However, if that sword has level 10 sharpness, it will still add the same amount of damage on top of the base damage.

This means that, in instanced dungeons with difficulties, what matters is not so much the level of the gear but the quality of the gear. Players seeking to beat the mythic difficulty will have to work towards getting high quality items from other instanced dungeons and possibly heavily interact with the item upgrade system.

This also makes it nearly impossible for veteran players to stomp on old high-difficulty content and provides an incentive to do it even if their level is well beyond the level of the dungeon.

Party system

To account for player parties, bosses are designed with specific powers which get more dangerous as more players join the arena. Additionally, bosses receive a health boost that scales with the number of players in the instance. The formula is: scaledHealth = baseHealth * 0.75 * playerCount. For example, with 2 players the boss has 1.5x its base health, with 3 players 2.25x, and with 5 players 3.75x.

Note: Health scaling only applies when 2 or more players are in the instance. Solo players face bosses with standard health values.

How to define a difficulty

Difficulties are defined in the content_packages folder in the dungeon package file of instanced dungeons. This file is located at /plugins/EliteMobs/content_packages/[your_dungeon_name]/[package_file].yml and should be alongside other dungeon settings like contentLevel and name.

Let's take a look at an example:

difficulties:
- levelSync: 60
  name: normal
- levelSync: 50
  name: hard
- levelSync: 40
  name: mythic

This sets three difficulties. Difficulties have two required fields: name and levelSync.

The name is the name of the difficulty, as will appear in the difficulty setting in-game. This can have any name.

The levelSync sets the item level cap for the instanced dungeon, as explained above in this page.

You can have as many or as few difficulties defined as you want. Simply add or remove entries to the difficulties setting using the same format.

Relative Level Sync

Level sync can also use relative values instead of absolute numbers:

difficulties:
- levelSync: +5
  name: easy
- levelSync: 0
  name: normal
- levelSync: -10
  name: hard

Relative values are calculated from the dungeon's base content level. For example, if a dungeon has content level 60:

• levelSync: +5 becomes 65
• levelSync: 0 becomes 60
• levelSync: -10 becomes 50

This is particularly useful for dynamic dungeons where the content level may vary.

Optional Difficulty ID Field

You can set an id field on each difficulty entry. This ID is used by custom bosses and custom items to apply difficulty-based powers and loot. If you do not set the id field, the difficulty will not have an ID and difficulty-based features that rely on it will not apply.

difficulties:
- levelSync: 60
  name: normal
  id: 0
- levelSync: 50
  name: hard
  id: 1

Powers based on difficulty

It is possible to configure bosses to only have powers at specific difficulties. Let's look at an example:

powers:
- filename: invulnerability_fire.yml
  difficultyID:
  - 1
  - 2

Note: this is a part of the configuration file of the custom boss!

In this case, the boss will only have fire invulnerability for difficulties with the ID 1 and 2.

Loot based on difficulty

It is possible to configure bosses to drop loot specific to an instanced dungeon difficulty. Let's look at an example:

uniqueLootList:
- filename: himiko_boss_drop_axe_tank_normal.yml
  chance: 0.05
  difficultyID: 0

Note: this is a part of the configuration file of the custom boss!

In this case, the boss will only drop the loot himiko_boss_drop_axe_tank_normal.yml for difficulty 0 and has 5% chance of doing so.