Mythical Races Free  | Elves, Dwarfs and so forth icon

Mythical Races Free | Elves, Dwarfs and so forth -----

A plugin where you can create your own mythical races with attributes & potion effects



Code (YAML):

# ********************************************** #
#                                                #
#     -- Mythical Races Configuration File --    #
#           -- Version 1.4.0 --                  #
#                                                #
# ********************************************** #
# Attributes are as follows
# GENERIC_MAX_HEALTH
# GENERIC_KNOCKBACK_RESISTANCE
# GENERIC_MOVEMENT_SPEED
# GENERIC_ATTACK_DAMAGE
# GENERIC_ATTACK_SPEED
# GENERIC_ARMOR
# GENERIC_ARMOR_TOUGHNESS
# GENERIC_LUCK

# Potion affects are as follows
# SPEED
# SLOW
# FAST_DIGGING
# SLOW_DIGGING
# INCREASE_DAMAGE
# HEAL
# HARM
# JUMP
# CONFUSION
# REGENERATION
# DAMAGE_RESISTANCE
# FIRE_RESISTANCE
# WATER_BREATHING
# INVISIBILITY
# BLINDNESS
# NIGHT_VISION
# HUNGER
# WEAKNESS
# POISON
# WITHER
# HEALTH_BOOST
# ABSORPTION
# SATURATION
# GLOWING
# LEVITATION
# LUCK
# UNLUCK
# SLOW_FALLING
# CONDUIT_POWER
# DOLPHINS_GRACE
# BAD_OMEN
# HERO_OF_THE_VILLAGE


# You want to add your own race?
#
#    raceName:
#     displayName: 'DisplayNameOfRace'
#     material: 'MaterialToUseForGUI'
#     guiPage: 1 # the page number of the GUI which it should be displayed at
#     isSubRace: false # is a subrace
#     subRaceType: '' # type of sub race this race belons to (only if isSubRace is set to true)
#     treeSlot: 4 # /races tree slot this race is in
#     levelRequire: 0 # the race level required to pick this race
#     slot: 11 # the slot the material should be
#     lvlType: 'RUNNING' # this means how should the race level up - read through all of the top comments to figure out what can go here
#     maxLevel: 100 # max level this race can be, note do NOT set this below a sub races required level
#     gainXP: 2 # gain x amount of Xp each time a certain event happens for lvlType
#     xpPerLevel: 24 # How much XP is needed times the level itself to reach the next level
#     lore:
#         - '&4----- &cRace Name Race &4-----'
#         - '&cDesciptiond and stuff'
#         - ' '
#         - '&5----- Day Time Passive Effects -----'
#         - 'Day time effects and stuff'
#         - '&5----- Night Time Passive Effects -----'
#         - 'Night time effects and stuff'
#     dayPassivePotionEffects: # Only put 'null' if the area is not going to be used
#         - 'null'
#     dayPassivePotionEffectsBase:
#         - 'null'
#     dayRaceDataPotion: # explained below
#         - 'null'
#     dayPassiveGenericAttributes: # ALWAYS LEAVE THIS ATTRIBUTE IN, this is normal speed, if you change it then you get a very fast player or slow
#         - 'GENERIC_MOVEMENT_SPEED'
#     dayPassiveGenericAttributesBase:
#         - 0.1
#     dayRacePassiveAttributesLevel: what this means is gain X amount of ATTRIBUTE PER LEVEL added onto the BASE Base, if 0.0 then ignore any sort of increasing X per level, max level is at the bottom of the config
#         - 0.0
#     dayRaceDataAttribute: # explained below
#         - 'ALL Y > -1000 -1 ALL ALL ALL ALL'
#     nightPassivePotionEffects:
#         - 'null'
#     nightPassivePotionEffectsBase:
#         - 'null'
#     nightRaceDataPotion: # explained below
#         - 'null'
#     nightPassiveGenericAttributes:
#         - 'GENERIC_MOVEMENT_SPEED'
#     nightPassiveGenericAttributesBase:
#         - 0.1
#     nightRacePassiveAttributesLevel:
#         - 0.0
#     nightRaceDataAttribute: # explained below
#         - 'ALL Y > -1000 -1 ALL ALL ALL ALL'
#     executeCommandUponSwitching: # execute a CONSOLE command upon switching to another race, to use a playername it is {player}
#         - 'null'


# the DATA lists work as such
# 'ALL Y > -1000 -1 ALL ALL ALL ALL'
# First argument is BIOMES, ALL meaning ALL biomes, a biome name can be used within that first argument
# Second argument is Y, this always has to be Y - this indicates players Y axis
# Third argument is if players Y axis is greater than or equal to NUMBER
# fourth argument is the number that is related to the third argument
# fifth argument is what the amplifier should now be if the player isn't in the designated area -1 to remove POTION effects, attribute has to be set to another number for it as you cannot "remove" a attribute
# sixth argument is when to apply the effects if a certain block is nearby - types are [ALL, ABOVE, MID, BELOW, AROUND] you cannot use multiple for this argument, only one of these
# seventh argument is what blocks are nearby to apply the desired effect
# eigth argument is if a storm is occuring in the world then apply effect, types are [TRUE, FALSE, ALL]
# ninth argument is the 'world' the player is in, types are, [ALL, your worlds] can be seperated using a space'

# An example of what it "could" look like is as follows 'SAVANNA,ANOTHERBIOME Y > -100 -1 ALL STONE,ANOTHERBLOCK ALL world,ANOTHERWORLD' - this means if you are walking on the STONE block in savanna and in all types of weather and in world 'world', then apply the effect

# commas seperate different blocks

# Remember that amplifiers are -1 than what you want, for example if you want LUCK 1, then you would have to put 0 and not 1 under the amplifier
# So to add a attribute, just add one of the attributes to "day" or "night" that has attributes in it
# the base for the attributes is below the spot you put it in
# for example, if you put GENERIC_MAX_HEALTH
# then the number that applies to generic max health is the exact same spot in the base for it
# you can look at examples below

# https://youtu.be/Kb7Jn-EHj00 <--- tutorial - this is a tutorial on how to use the plugin, it is a long video that explains it in-depth (sort of)
# Second tutorial -> https://www.youtube.com/watch?v=blx4iUlyqMI
# well theres also a third tutorial but thats down in the comments of the second tutorial (gotta love how long these tutorials, but trust its worth it!)
# Well best of luck user!
# If you are having trouble adding a race/editing/removing a race, join the support discord server, and ping a guy called Korbsti (which is me), or add his username directly: Korbsti#0001
# https://discord.gg/GK3rmrze2Q <--- Support discord server if you require help

# use UUIDs to store player data
# if false then store by player names

# Types of 'lvlType' are as follows
# HUNTING, RUNNING, HARVESTING, BUILDER, FISHING, EXCAVATION, MINER, WOODCUTTER, TANKER, SWIMMING, FLYING, DIGGER, ARCHER
# NOTE it is very important that you note that for the races , excavation, building, hunting and harvesting that xp GAIN can be very fast, so make sure to put xpPerLevel to a high number to make it more fair

# Some useful links when creating complicated races
# > https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/Biome.html
# > https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html


# NOW for some special data types, below will be some examples
# 'ALL Y > -1000 -1 VAMPIRE VAMPIRE ALL ALL' - this means apply effect if all blocks above the player to sky limit isnt a solid block
# 'ALL Y > -1000 -1 CUSTOM[num] [INSERT BLOCKS HERE] ALL ALL' - CUSTOM means, in X radius of blocks next to it, it can be CUSTOM10 or CUSTOM1 or even CUSTOM100 if you hate your server, replace [num] to search for a radius
# 'ALL Y > -1000 -1 LIGHTA[num] LIGHT ALL ALL' - this means apply effect if the light level is greater than the [num] next to it, example would be LIGHT6, now the limits are [0 - 14] in terms of levels
# 'ALL Y > -1000 -1 LIGHTB[num] LIGHT ALL ALL' - this means apply effect if the light level is lower than the [num] next to it, example would be LIGHT6, now the limits are [0 - 14] in terms of levels

 
Remember that amplifiers are -1 than what you want, for example if you want LUCK 1, then you would have to put 0 and not 1 under the amplifier
So to add a attribute, just add one of the attributes to "day" or "night" that has attributes in it
the amplifier for the attributes is below the spot you put it in
for example, if you put GENERIC_MAX_HEALTH
then the number that applies to generic max health is the exact same spot in the amplifier for it
Also do remember that the added race has to be ALIGNED with the rest of the races properly, do NOT use 'tab' on the keyboard for indentation
If you are still confused on how to add a race, watch this video



If a player does not have the permission for a command, use luckperms and vault, and watch this tutorial

Commands and Permissions
/races choose [race] | mythicalraces.race.[race] example (mythicalraces.race.Elf)
/races help | mythicalraces.help
/races info [race] | mythicalraces.info.races
/races gui | mythicalraces.gui
/races tree | mythicalraces.tree
/races profile | mythicalraces.profile
/races set {race} {player} | mythicalraces.race.setrace [Do not give to default players]
mythicalraces.cooldown.bypass to bypass race choosing cooldowns


For more examples of how to use it (luckperms and permissions)
/lp group default permission set mythicalraces.race.Elf true
/lp group default permission set mythicalraces.race.Dwarf true
/lp group default permission set mythicalraces.gui true
and so on
Resource Information
Author:
----------
Total Downloads: 16,074
First Release: May 21, 2021
Last Update: Aug 20, 2022
Category: ---------------
All-Time Rating:
20 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings