⚠️ Some feature are available since 0.7-BETA ⚠️

[!WARNING] ❗❗❗❗ Make sure you read the whole configuration file before creating talismans! ❗❗❗❗

[!IMPORTANT] Test our new talisman generator powered by Gemini using AI 💡
➡️➡️➡️ https://alonsoaliaga.com/BetterTalismans-Generator ⬅️⬅️⬅️
It has been trained by our Team to be able to give you a working Talisman for your server!

⚠️ Make sure you test the result in your test server. Don't add it to your server without testing.

Available modifiers

HEALTH_BOOST ➡️ Integer - Each 1 is half heart.
MOVEMENT_SPEED ➡️ Double - Each 1 is additional 100% speed movement (0.5 is +50%, 0.75 is + 75%).
ATTACK_DAMAGE ➡️ Double - Each 1 is one half damage additional to the item.
KNOCKBACK_RESISTANCE ➡️ Double - Each 1 is additional 100% knockback resistance.

[!IMPORTANT] Information about KNOCKBACK_RESISTANCE.
From 1.8.8 - 1.15.x the value is the probability to ignore knockback as a result of hit, explosion, etc.
However, in 1.16.x and probably newer versions too, it is a scale, not a probability.
Do NOT USE high values, otherwise player will not have knockback.\

Starting from version 1.9.2 (NOT 1.9, NOT 1.9.1) 🟪 ARMOR ➡️ Double - Each 1 is one armor point (full diamond set gives 20 armor points).
ARMOR_TOUGHNESS ➡️ Double - Each 1 is additional toughness point (toughness reduces penetration of high damage).
ATTACK_SPEED ➡️ Double - Each 1 is additional 100% attack speed (0.5 is +50%, 0.75 is + 75%).
LUCK - Double ➡️ Each 1 is additional 100% luck. This works for loot tables, more luck, better loot. It applies also with mob drops.\

Starting from version 1.20 🐫
MAX_ABSORPTION ➡️ Double - Max amount of player absorption.
SCALE ➡️ Double - Player scale (player gets bigger or smaller).
STEP_HEIGHT ➡️ Double - How high a player consider a new high possible to be passed without jumping.
BLOCK_INTERACTION_RANGE ➡️ Double - Range of interaction with blocks.
ENTITY_INTERACTION_RANGE ➡️ Double - Range of interaction with entities.
GRAVITY ➡️ Double - Strength of gravity applied to the player (1.0 is normal, lower values reduce falling speed, 0 disables gravity).
SAFE_FALL_DISTANCE ➡️ Double - Maximum height the player can fall without taking damage.
FALL_DAMAGE_MULTIPLIER ➡️ Double - Multiplier applied to fall damage taken by the player (1.0 is normal, 0.5 is half, 0 is no damage).
BLOCK_BREAK_SPEED ➡️ Double - Speed multiplier for breaking blocks (1.0 is default, 2.0 is twice as fast).
JUMP_STRENGTH ➡️ Double - Multiplier applied to jump height (1.0 is normal, 2.0 is double jump height).
BURNING_TIME ➡️ Double - How long the player stays on fire (in ticks or seconds, depending on implementation).
EXPLOSION_KNOCKBACK_RESISTANCE ➡️ Double - Resistance to explosion-based knockback (1.0 is full resistance).
MINING_EFFICIENCY ➡️ Double - Overall mining efficiency (affects block breaking, especially under adverse conditions).
MOVEMENT_EFFICIENCY ➡️ Double - Efficiency of movement, particularly when walking on difficult terrain (like soul sand).
OXYGEN_BONUS - Double ➡️ Bonus oxygen time underwater (each 1 adds more breathing capacity).
SNEAKING_SPEED - Double ➡️ Speed multiplier while sneaking (1.0 is default, 2.0 is double).
SUBMERGED_MINING_SPEED ➡️ Double - Mining speed multiplier when underwater.
SWEEPING_DAMAGE_RATIO ➡️ Double - Ratio of damage applied to nearby enemies when doing a sweeping attack.
WATER_MOVEMENT_EFFICIENCY ➡️ Double - Efficiency of movement in water (higher means faster swimming).\

Starting from version 1.21 🌀
CAMERA_DISTANCE ➡️ Double - Distance of the third-person camera from the player (higher values increase camera distance).

Available slots

MAIN_HAND ➡️ When equipped in main hand.
OFF_HAND ➡️ When equipped in off hand.
HEAD ➡️ When equipped in helmet slot.
CHEST ➡️ When equipped in chestplate slot.
LEGS ➡️ When equipped in leggins slot
FEET ➡️ When equipped in boots slot.

[!WARNING] Slots are available since 1.9, they won't work in older versions.

Available operations

ADD_VALUE ➡️ Adds the value to the current base.
ADD_MULTIPLIER_BASE ➡️ Multiplies the player base attribute.
ADD_MULTIPLIER_TOTAL ➡️ Multiplies the player total current attribute.

[!NOTE] The most usual is ADD_VALUE as it's what all vanilla armor and weapons use by default.

Example of a talisman

#TEST ALL TALISMANS BEFORE ALLOWING PLAYERS TO CRAFT THEM TO MAKE SURE THEY WORK AS YOU WANT.
#REMEMBER YOU CAN CREATE AS MANY TALISMANS AS YOU WANT. HOWEVER IF MODIFIERS ARE NOT AVAILABLE IN YOUR VERSION, THEY WONT WORK.
#IF YOU USE INVALID MODIFIERS FOR YOUR VERSION IN A TALISMAN. IT WILL BE DISABLED AND ONLY TALISMAN WITH AT LEAST ONE VALID MODIFIER
#WILL BE LOADED.
Talismans:
  #Choose a name to be used internally. It must be unique.
  Life-talisman:
    Item:
      #You can use any item you want, if you want a CUSTOM textured head. you need to use: "CUSTOM_HEAD" and specify a value in "Texture"
      #You can get textures from website https://minecraft-heads.com/custom-heads
      #Choose one and use "Value" value.
      Material: "MAGMA_CREAM"
      #Only available if Material is "CUSTOM_HEAD"
      Texture: "ewogICJ0aW1lc3RhbXAiIDogMTU5NDQ0NjkyMDI5NiwKICAicHJvZmlsZUlkIiA6ICJlMWMxYTE5NDdlODY0MTRmODZiYjQyZDgyYTIxY2ZiOCIsCiAgInByb2ZpbGVOYW1lIiA6ICJBbG9uc29BbGlhZ2EiLAogICJ0ZXh0dXJlcyIgOiB7CiAgICAiU0tJTiIgOiB7CiAgICAgICJ1cmwiIDogImh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTY4YWE3NGNjODg1NzgwNjBkMGZlM2JkOTA4YjM0ZjY5ZjEyZTA3ZjFmODljNWRkYzE1ZTZiZjYwZjA0Y2NjNiIKICAgIH0KICB9Cn0="
      #This option adds enchantment to talisman to make it glow.
      Glow: true
      #Recommended to leave this enabled if equip slots in "Modifiers" list is more than 1.
      #If you disable this, i recommend you to remove {ATTRIBUTES} lines from lore as it will be duplicated.
      #Disabling this will display attributes in vanilla style.
      Hide-attributes: true
      #Item flags that will be added. Add "ALL" to hide all infromation.
      #More item flags here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html
      #Set to Item-flags: [] to disable all flags.
      Item-flags:
      - "ALL"
      #Should item have unbreakable tag?
      Unbreakable: true
      #This option adds custom model in case you wanna make a texture for it.
      #Set it to 0 to disable. This option is only available in 1.14 and newer, will not apply if Material is "CUSTOM_HEAD"
      Custom-model-data: 0
      #This is the uuid of the head, this uuid is generated automatically if absent.
      #This is required in order to keep the items the same on server restarts.
      Head-uuid: "9b77c0e1-b2b3-4aa1-98d1-23803e36f882"
      Displayname: "&c&lHealth Talisman"
      Lore:
      # {ATTRIBUTES} will be replaced with ALL modifiers defined in "Modifiers" section.
      #You can always remove that placeholder and add your own lore.
      - "{ATTRIBUTES}"
      - " "
      - "&7Ancient talisman that gives to"
      - "&7the owner more health to keep"
      - "&7fighting to defeat enemies."
      #Get the enchantments names from /bettertalismans enchantments
      Enchantments:
      - "ADD_ENCHANTMENTS_HERE,LEVEL"
      - "ANOTHER_ENCHANTMENT_HERE,LEVEL"
      - "GET_ENCHANTMENTS_FROM_COMMAND,/bettertalismans enchantments"
    #This is the list of modifiers. Keep in mind some modifiers are not compatible with others.
    Modifiers:
    # Follow the format: MODIFIER_NAME|AMOUNT|SLOTS|OPERATION
    # It can be used also a format to specify slots where the modifier takes effect, otherwise it will available only for main hand and off hand (if available)
    # Example: "attribute=HEALTH_BOOST|value=10|slots=MAIN_HAND,OFF_HAND,HEAD,CHEST,LEGS,FEET|operation=ADD_VALUE" or "attribute=HEALTH_BOOST|value=10|slots=MAIN_HAND,OFF_HAND|operation=ADD_VALUE"
    # Modifiers won't work in version below 1.9, please read all this file before using the plugin to know which boosts work in which versions.
    - "attribute=HEALTH_BOOST|value=10|slots=MAIN_HAND,OFF_HAND|operation=ADD_VALUE"
    Recipe:
      #Should the talisman be craftable?
      #When modifying this, restart the server. Reloading will NOT update recipes.
      #When modifying this, restart the server. Reloading will NOT update recipes.
      #When modifying this, restart the server. Reloading will NOT update recipes.
      #When modifying this, restart the server. Reloading will NOT update recipes.
      Enabled: true
      #Title of the recipe inventory.
      Title: "&8Life Talisman recipe"
      #Permission to craft this talisman. If removed or "none", then no permission will be required.
      #This permission is also used to show players recipes for talismans using /bettertalismans talismans
      #NOTE: This permission is NOT TO BE ABLE TO USE THE TALISMAN. All players can use all talismans if they have the item.
      Recipe-permission: "bettertalismans.recipe.life-talisman"
      #What's the recipe? USE "AIR" or "none" if no item is needed in that slot.
      #Remember it requires a 3x3 pattern.
      Shape:
      - "EMERALD,MAGMA_CREAM,EMERALD"
      - "DIAMOND,DIAMOND_BLOCK,DIAMOND"
      - "EMERALD,MAGMA_CREAM,EMERALD"

⚠️ Some feature are available since 0.7-BETA ⚠️