Config
If you're not planning to change any config, it's recommended to put the difficulty on hard as the default config was configured based on that.
All values that require a number (not percentages though) can have any size you want, this is to allow players to customize it as much as java allows. (I would not go this high since it may crash the app, but it's possible in some cases)
minimum allowed value: -2147483647
maximum allowed value: 2147483647
if a player is given more affinity than the allowed min and max sizes, it will limit the Affinity of an user to the set limits. (e.g.) User has 600 Affinity, server maximum limit is 1500. If the user is given 1000 Affinity (1000 + 600 = 1600), he will have 1500 Affinity points since that's the limit of the server.
default: 3
How many points are given to all online players every minute
default: 2
How many points are given to players who've mined a block in the blocks section without a custom Affinity value
default: -1
How many Affinity points a player loses when hit
default: -1
How many Affinity points a player loses based on how many hearts he has lost. (5 hearts = 5 * -1 = -5 Affinity points)
default: 20
How many points are gained when you kill a player
default: 2
How many points are given to players who've killed a mob in the mobs section without a custom Affinity value
default: -100
How many points are given when a player dies
default: 600
How many points a player gets when joining a server for the first time after the plugin is installed
default: -1
Minimum starting Affinity for players, this is different from the server limit as this is limited to players. This value is only given when the player joins the server for the first time after installing DynamicDifficulty
default: -1
maximum starting Affinity for players, this is different from the server limit as this is limited to players. This value is only given when the player joins the server for the first time after installing DynamicDifficulty
default: 0
The server limit, no one can get a lower value than the one set here. (min & max affinity swap if you try to be funny)
default: 1500
The server limit, no one can get a highervalue than the one set here. (min & max affinity swap if you try to be funny)
default: list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
All mobs listed here will give Affinity points when killed, you can add custom values by typing <mobtype>: <number>, will use pve-kill if no custom value is given
- CREEPER: 3
- DROWNED
default: list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
All blocks listed will give Affinity points when mined, you can add custom values by typing <material>: <number>, will use block-mined if no custom value is given
- ANCIENT_DEBRIS: 4
- DIAMOND_ORE
default: false
Whether players can gain points by mining blocks when they have the silk touch enchant on their tool
default: true
Whether players lose points if they do something that is considered as suicide.
default: false
Whether Mobs spawned by spawn eggs and spawners are influenced by Dynamic Difficulty or not
default: false
Whether it will randomly choose values from each difficulty. (e.g.) you may do 3 hearts damage the first hit and the second hit may do 1.5 based on the difficulty chosen
Advanced features may need more configuring or may decrease performance
default: false
You're able to change the armor mobs spawn with if this is enabled. You can configure that in the custom-mob-items-spawn-chance section
default: true
if enabled, will calculate the exact value between 2 difficulties. E.g. easy (0 Affinity required) has 60% chance to hunger, normal has 80% (400 Affinity required). If the user has 200 Affinity and exact-percentage is enabled, the user has a 70% chance to hunger
So if calculate-exact-percentage is disabled the damage chart will look something like this:
And if it's enabled it will look like this:
default: false
Whether to allowe papi implementation or not
default: true
Whether you want to use a custom prefix (allows custom color formatting) in each difficulty or just their standard name (doesn't allow custom color formatting)
default: false
Removes a few issues with not being able to find certain players. Enabling it will improve ram a few kb's, but may cause some problems that were stated earlier.
default: file
Determines what sort of database you'd like to use, if you want to change database you'll have to restart the server. Restarting only the plugin may break it, but you could try at your own discretion.
The port, host, username, password and database field are only needed if you plan on using a database (not for none and file)
default: list
add any world you want, you don't need Multiverse for it to work.
default: list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
add any mob here you don't want to be changed by the plugin. This includes Affinity Points, damage received and done and all other changes
default: player
Only player is available as of this moment, this determines if the Affinity is calculated based on the player, biome, world or radius.
Multiplies the default value by these in every difficulty (100% * 1.5 = 150%)
default: 1.0
default: 1.0
default: 1.0
default: 1.0
default: number
At What affinity this difficulty starts working
default: percentage
How much damage mobs do to you
default: percentage
How much damage you do on mobs
default: percentage
Chance that the hunger of a player will drain
default: percentage
How much damage projectiles do
default: percentage
Chance to take double damage on item durability
default: percentage
Experience Multiplier
default: percentage
Chance to double the loot dropped when a mob is killed
default: bool
Whether the player can attack or be attacked by other players
default: bool
Whether the player keeps everything on death or not
default: bool
Whether you get poison/wither etc from mob attacks (not including splash potions), works only on normal/hard world difficulty
default: text
prefix to return if PlaceholderAPI is enabled
default: list
What commands aren't allowed to be run by players on certain difficulties, spaces not recommended
default: list
how much damage reduction/increased per armor set worn (full diamond on Hard = 100 + (4 x 4)). Settings include [nothing, leather, golden, chainmail, iron, turtle, elytra, diamond and netherite]
default: list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
these mobs will ignore the players unless they're provoked
default: false
Will allow higher levels than Minecraft's defaults. (E.g. Unbreaking 7 can happen if max-level is higher or equals 7)
default: false
Allows conflicting enchants to occur on a single armor (E.g. Protection & Fire Protection)
default: list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
Mobs that will change when they're chosen for the difficulty. Is only really supported on humanoid entities. You could add mobs like Creepers, but you probably won't be able to see the armor.
default: list https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
Weapons that will be given to the mobs, may not work on non-humanoid entities
default: list armor types [leather, golden, chainmail, iron, diamond, netherite]
The weight/chance an armor has to be given to a mob. Higher values means that it's more likely to be given to a mob.
make sure to use the items with the __ beneath the names https://www.digminecraft.com/lists/enchantment_list_pc.php <ENCHANT_NAME>: WEIGHT, higher means more likely to occur, no value = weight of 1
default: list https://www.digminecraft.com/lists/enchantment_list_pc.php (make sure to use the items with the __ beneath the names)
Enchants that have a chance of being added to the helmet
default: list https://www.digminecraft.com/lists/enchantment_list_pc.php (make sure to use the items with the __ beneath the names)
Enchants that have a chance of being added to the chestplate
default: list https://www.digminecraft.com/lists/enchantment_list_pc.php (make sure to use the items with the __ beneath the names)
Enchants that have a chance of being added to the leggings
default: list https://www.digminecraft.com/lists/enchantment_list_pc.php (make sure to use the items with the __ beneath the names)
Enchants that have a chance of being added to the boots
default: list https://www.digminecraft.com/lists/enchantment_list_pc.php (make sure to use the items with the __ beneath the names)
Enchants that have a chance of being added to the weapon
default: list https://www.digminecraft.com/lists/enchantment_list_pc.php (make sure to use the items with the __ beneath the names)
Enchants that have a chance of being added to the bow
the name of the difficulties needs to be EXACTLY the same as in the first general difficulty list (e.g. ExtreMe difficulty needs to be exactly the same here or it won't work)
default: number
maximum enchants allowed on an item
default: number
maximum level for enchants
default: percentage
chance for a mob to spawn with armor
default: percentage, number
chance for a piece of armor to be enchanted
default: percentage
chance for the armor to drop if a mob with armor is killed
default: percentage
chance for the weapon to drop if a mob with a weapon is killed
default: percentage
chance for a mob to have a weapon if they get armor
default: percentage
chance for a mob to have a helmet if they get armor
default: percentage
chance for a mob to have a chestplate if they get armor
default: percentage
chance for a mob to have leggings if they get armor
default: percentage
chance for a mob to have boots if they get armor