V-Souls | Souls that execute rewards when in inventory (Like Pets) [1.8-1.19] icon

V-Souls | Souls that execute rewards when in inventory (Like Pets) [1.8-1.19] -----

Souls that give you rewards when you fulfill certain requirements.

Download Now
126.5 KB .jar


[​IMG]
V-Souls is a fairly customizable plugin that focuses on giving rewards to players through items called Souls. Souls that can be leveled up and perform better rewards.
It's a plugin that you can also use it for other types of things, like running "advantages" when you are using the Soul.
​
Features
  • Different types of ways to level up
o BREAKING | Level up by breaking blocks.
o BUILDING | Level up by placing blocks.
o FISHING | Level up by fishing.
o KILLING | Level up by killing.
  • You can set the amount of experience that each entity gives when executed. You can set a specific entity or all entities give the same experience.
    • Conditional available
      • || (Conditional meaning OR)
    • Example:
      • <entity>;<exp>
      • <block type>:<block data>;<exp>
        [​IMG]
  • Requirements to execute the rewards
  • [level] | Requirement that compares the level of the Soul.
    • Conditionals available
      • || (Conditional meaning OR)
      • <, >, <=, >=, !=, ==
  • [papi] | Compares PlaceholderAPI placeholders
    • || (Conditional meaning OR)
  • [type] | Requirement that verifies what type of action is needed to execute the reward.
    • Conditionals available
      • || (Conditional meaning OR)
      • <, >, <=, >=, !=, ==
      • equals, !equals, equalsIgnoreCase, !equalsIgnoreCase, startsWith, !startsWith, contains, !contains
    • Types
      Cancellable option in green allows you to cancel the event (false/true).
      • BREAKING (Cancellable)
        > (Ex: [type] BREAKING(true);STONE:0)
      • BUILDING (Cancellable)
        > Ex: [type] BUILDING(true);STONE:0)
      • FISHING (Cancellable)
        > (Ex: [type] FISHING=CAUGHT_FISH(true);RAW_FISH:3)
        • CAUGHT_ENTITY
        • CAUGHT_FISH
        • FISHING
        • BITE
        • FAILED_ATTEMPT
        • IN_GROUND
        • REEL_IN
      • COMBATING
        > (Ex: COMBATING=ATTACK;ZOMBIE)
        • ATTACK (Cancellable)
        • ATTACKED (Cancellable)
        • DIE
        • KILLS
      • ITEM_CONSUME (Cancellable)
        > ( Ex: [type] ITEM_CONSUME(true);GOLDEN_APPLE:0(name:&dLegendary Apple&& lore:This is created|n|by Tenges&& enchants:LURE;1 && attributes:HIDE_ENCHANTS,HIDE_UNBREAKABLE && unbreakable) )
      • ITEM_BREAK
        > ( Ex: [type] ITEM_BREAK(true);DIAMOND_PICKAXE:0(name:&eOP Pickaxe&& lore:&aAmazing pickaxe&& enchants:DURABILITY;3,EFFICIENCY;5 && attributes:HIDE_ENCHANTS) )
      • ITEM_PICKUP (Cancellable)
        > ( Ex: [type] ITEM_CONSUME(true);GOLDEN_APPLE:0(name:&dLegendary Apple&& lore:This is created|n|by Tenges&& enchants:LURE;1 && attributes:HIDE_ENCHANTS,HIDE_UNBREAKABLE && unbreakable) )
      • ITEM_DROP (Cancellable)
        > ( Ex: [type] ITEM_BREAK(true);DIAMOND_PICKAXE:0(name:&eOP Pickaxe&& lore:&aAmazing pickaxe&& enchants:DURABILITY;3,EFFICIENCY;5 && attributes:HIDE_ENCHANTS) )
      • ITEM_INTERACT (Cancellable)
        > ( Ex: [type] ITEM_INTERACT=RIGHT_CLICK_AIR(true); DIAMOND_PICKAXE:0(name:&eOP Pickaxe&& lore:&aAmazing pickaxe&& enchants:DURABILITY;3,EFFICIENCY;5 && attributes:HIDE_ENCHANTS) )
        • LEFT_CLICK_BLOCK
        • LEFT_CLICK_AIR
        • RIGHT_CLICK_BLOCK
        • RIGHT_CLICK_AIR
      • ITEM_HELD (Cancellable)
        > ( Ex: [type] ITEM_BREAK(true);DIAMOND_PICKAXE:0(name:&eOP Pickaxe&& lore:&aAmazing pickaxe&& enchants:DURABILITY;3,EFFICIENCY;5 && attributes:HIDE_ENCHANTS) )
      • PLAYER_COMMAND (Cancellable)
        > (Ex: [type] PLAYER_COMMAND(true);/command)
      • PLAYER_JOIN
        > (Ex: [type] PLAYER_JOIN)
      • PLAYER_LEAVE
        > (Ex: [type] PLAYER_LEAVE)
      • PLAYER_RESPAWN
        > (Ex: [type] PLAYER_RESPAWN)
      • PLAYER_FLY
        > (Ex: [type] PLAYER_FLY)
      • PLAYER_SNEAK
        > (Ex: [type] PLAYER_SNEAK)
      • PLAYER_SPRINT
        > (Ex: [type] PLAYER_SPRINT)
      • PLAYER_BED_ENTER (Cancellable)
        > (Ex: [type] PLAYER_BED_ENTER(true))
      • PLAYER_BED_LEAVE
        > (Ex: [type] PLAYER_BED_LEAVE)
      • PLAYER_CHANGE_WORLD
        > (Ex: [type] PLAYER_CHANGE_WORLD;world)
      • PLAYER_INTERACT_BLOCK
        > (Ex: [type] PLAYER_INTERACT_BLOCK=RIGHT_CLICK_BLOCK(true);STONE:0)
        • RIGHT_CLICK_BLOCK
        • LEFT_CLICK_BLOCK
      • PLAYER_INTERACT_ENTITY (Cancellable)
        > (Ex: [type] PLAYER_INTERACT_ENTITY(true))
Examples:
[​IMG]
[​IMG]

  • Different types of actions to be performed on rewards
  • Rewards
  • console_command | Execute a command from the console
  • message | Sends a message to the player (Opponent support)
  • title | Sends a message on screen to the player (Opponent support) (Ex: title:<title>;;<subtitle>)
  • sound | Executes a sound to the player (Opponent support) (Ex: sound:<sound>;;<volume>;;<pitch>)
  • broadcast_message | Sends a message to all online players
  • broadcast_title | Sends an on-screen message to all players (Ex: title:<title>;;<subtitle>)
  • json | Sends a chat message to the player. These messages allow you to add click and hover events. You can create JSON messages from this link: www.minecraftjson.com (Opponent support)
  • json_broadcast | Sends a chat message to all players. These messages allow you to add click and hover events. You can create JSON messages from this link: www.minecraftjson.com
  • effect | Gives an effect to the player (Opponent support) (Ex: effect:<effect>;;<duration>;;<amplifier>)
  • Placeholder available for rewards
  • %random_<min>-<max>% | Placeholder to give a random number
  • %level:random_<min>-<max>% | Placeholder to give a random number and multiply it by the level of the soul
  • %percentage:random_<min>-<max>% | It takes a percentage of the number, considering the level of the soul and adds it to the number
  • %player%
  • %opponent%
  • Probability to execute the rewards
  • [per_level:<probability>] | For each level of the soul the probability of executing the reward increases
  • [all_level:<probability>] | You have a base probability of executing the reward
  • Execute rewards to other players
Example:
[​IMG]
  • Conditionals available for rewards
  • Conditionals available
    • || (Conditional meaning OR)
    • && (Conditional meaning AND)
  • Configure the item visually
  • Configures the item's amterial, description and name
    • Item option support custom heads, to set the head you must first type basehead-<head value>. Heads page: minecraft-heads.com
  • Available variables
    • %level%
    • %progress%
      • Progress section
        • Available variables
          • %exp%
          • %cost%
          • %progress_bar%
            [​IMG]
Example:
[​IMG]
  • Configure the cost of the levels
  • The cost for the next level is multiplied by the cost in configuration for the next level
  • Code option
  • The code option allows the Soul to be upgraded and all actions work. It also allows to update the lore and name of the item when it is change in the config.yml. If code option is changed that kind Souls will stop working
  • Souls work when right-clicked (You can only have one active soul)
  • PlaceholderAPI placeholders
  • %vsouls_random_<min>-<max>%
  • %vsouls_percentage_random_<soul>_<min>-<max>%
  • %vsouls_level_random_<soul>_<min>-<max>%
  • %vsouls_active_<soul>%
  • %vsouls_level_<soul>%
  • %vsouls_has_active_soul%


​
Screenshots
[​IMG]

​

Commands
o /vsouls reload (Permission: vsouls.reload)
o /vsouls give <player> <soul> (Permission: vsouls.give)
o /vsouls list (Permission: vsouls.list)
o /vsouls check (Permission: vsouls.check)
o /vsouls use <worldguard/nbtapi> (Permission: vsouls.use)
o /vsouls help (Permission: vsouls.help)
o /vsouls addexp <exp> <player> (Permission: vsouls.addexp)
o /vsouls setexp <exp> <player> (Permission: vsouls.setexp)
o /vsouls addlevel <level> <player> (Permission: vsouls.addlevel)
o /vsouls setlevel <level> <player> (Permission: vsouls.setlevel)
o / vsouls setlevelhand <level> (Permission: vsouls.setlevelhand)​



Files
Code (YAML):
Config:
  V-Soul:
    counter : 0
  Souls:
    ZenghSoul:
      code : Zengh
      upgrade:
        level-cost : 4000
        progress:
        - '&7Progress : &b%exp%&7/&b%cost%'
        progress-maxed :
        - '&b&lMAX LEVEL'
      actions:
        type : BREAKING
        list-exp:
          BREAKING :
            - ' ALL;5'
        rewards:
          Basic:
            requirements :
              - ' [level ] %level% <= 50'
              - ' [type ] BREAKING; ALL'
            list-rewards :
              - ' [all_level:0.1 ] console_command:vme add gems %player% %level:random_1-1000% || console_command:vme add Kran %player% %level:random_1-1000% && message:&aYou received BASIC reward from Zengh'
          Advanced:
            requirements :
              - ' [level ] %level% > 50'
              - ' [type ] BREAKING;DIAMOND_ORE:0'
              - ' [papi ] %vault_rank% equals Vip'
            list-rewards :
              - ' [per_level:0.001 ] console_command:vme add gems Vingma %random_20000-50000% || console_command:vme add KRAN Vingma %random_20000-50000% && message:&aYou received ADVANCED reward from Zengh'
      info:
        item : basehead-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTFiZmE5OWRiMzQyZWNmMjdlZGUxOTU0NDE5MGIzMTg3NzY2NDkwZjJlNDUzMmYxMDYyZjQ3ODFhYjdjNmJlYyJ9fX0=
        data : 0
        name : '&b&lZengh &8| &fSoul'
        lore:
          - '&8Type : Mining Soul'
          - ''
          - '&aGemeed'
          - '&8A &a0.1 &8chance of receiving a random'
          - '&8amount of Gems from &71-1000&8. For each'
          - '&8level the amount is multiplied'
          - ''
          - '&cKriner'
          - '&8Receive a random amount of Krans from'
          - '&720,000 &8to &750,000&8. Initial probability'
          - '&8of &c0.001&8, for each level of the soul'
          - '&8the probability multiplies.'
          - ''
          - '&7Level : &b%level%'
          - ' %progress%'
          - ''
    VenkantoSoul:
      code : Venkanto
      upgrade:
        level-cost : 1000
        progress:
          - '&7Progress : &c%exp%&7/&c%cost%'
        progress-maxed :
          - '&c&lMAX LEVEL'
      actions:
        type : KILLING
        list-exp:
          KILLING :
            - ' ALL;10'
        rewards:
          Ability1:
            requirements :
              - ' [type ] COMBATING=ATTACK; ALL'
            list-rewards :
              - ' [per_level:0.001 ] effect= %opponent%:POISON;3;1 && message=%opponent%:&aYou received Poison effect.'
          Ability2:
            requirements :
              - ' [type ] COMBATING=ATTACKED; ALL'
            list-rewards :
              - ' [per_level:0.001 ] effect:REGENERATION;3;1 && message:&aYou received regeneration of Venkanto'
          Ability3:
            requirements :
              - ' [level ] %level% > 50'
              - ' [type ] COMBATING=ATTACK;PLAYER || COMBATING=ATTACKED;PLAYER'
              - ' [papi ] %player_health% <= 6'
            list-rewards :
              - ' [per_level:0.001 ] effect:ABSORPTION;5;1 && message:&aYou received absorption of Venkanto'
      info:
        item : basehead-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYzJiNzIwZDFkODUzNjRhZThhNDZlZGFhNzQ5YTE1NGUyN2VhZWQ3YjE4N2U0MmMwZmU1ZGIwNmI3MGVlY2U5YiJ9fX0=
        data : 0
        name : '&c&lVenkanto &8| &fSoul'
        lore:
          - '&8Type : Combating Soul'
          - ''
          - '&5Poisoner'
          - '&8Applies the Poisoner effect when attacking.'
          - '&8Depending on the level of the soul, the'
          - '&8probability of the effect being applied is higher.'
          - ''
          - '&dRejuvenator'
          - '&8Receives the Regeneration effect for 3 seconds.'
          - '&8when you are attacked. The probability of receiving'
          - '&8the effect depends on the level of the soul.'
          - ''
          - '&eAbsorber'
          - '&8Depending on the level of the soul you can'
          - '&8receive the Absorption effect for 5 seconds.'
          - '&8This ability is exclusive to &aVips&7.'
          - '&8You need a level higher than 50 for it to work.'
          - ''
          - '&7Level : &c%level%'
          - ' %progress%'
          - ''
    VisserSoul:
      code : Visser
      upgrade:
        level-cost : 1000
        progress:
          - '&7Progress : &3%exp%&7/&3%cost%'
        progress-maxed :
          - '&3&lMAX LEVEL'
      actions:
        type : FISHING
        list-exp:
          KILLING :
            - ' ALL;20'
        rewards:
          Ability1:
            requirements :
              - ' [type ] FISHING=CAUGHT_FISH;RAW_FISH:3'
            list-rewards :
              - ' [all_level:0.1 ] console_command:give %player% fishing_rod 1 name:&3Visser_&8|_&fRod
              durability:5 luck:2 lure:3 vanishingcurse:1 lore:&r|&7Rod_created_by_the_angler_Visser.|&7Owner:_&3 %player%
              && title:&6&lREWARD;;&fYou received the rod from Visser && message:&6&lREWARD!
              &fYou received the rod from Visser.'
          Ability2:
            requirements :
              - ' [type ] FISHING; ALL'
              - ' [level ] %level% >= 50'
            list-rewards :
              - ' [per_level:0.0001 ] console_command:give %player% enchanted_book 1 mending:1 && message:&5&lREWARD! &aYou received a mending book.'
          Ability3:
            requirements :
              - ' [type ] FISHING; ALL'
              - ' [papi ] %checkitem_getinfo:mainhand_namecontains:% contains Visser'
              - ' [papi ] %checkitem_getinfo:mainhand_lorecontains:% contains Rod created by the angler Visser.'
              - ' [papi ] %checkitem_getinfo:mainhand_lorecontains:% contains %player_name%'
            list-rewards :
              - ' [all_level:0.01 ] console_command:give %player% golden_apple:1 && message:&5&lREWARD! &aYou received a enchanted golden apple.'
          Ability4:
            requirements :
              - ' [type ] FISHING; ALL'
              - ' [papi ] %checkitem_getinfo:mainhand_namecontains:% contains Visser'
              - ' [papi ] %checkitem_getinfo:mainhand_lorecontains:% contains Rod created by the angler Visser.'
              - ' [papi ] %checkitem_getinfo:mainhand_lorecontains:% contains %player_name%'
              - ' [papi ] %crazycrates_Side_physical% >= 1'
            list-rewards :
              - ' [all_level:100 ] console_command:crazycrates take physical Side 1 %player% && message:&b&lCONSUME! &7You consumed a Side.'
              - ' [all_level:0.1 ] console_command:give %player% totem 1 && sound:ITEM_TOTEM_USE;;10;;0.1 && message:&6&lREWARD! &aYou received a totem. && title:&6&lREWARD;;&eYou received a Totem'
      info:
        item : basehead-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmI2NTZiYWM2NGFkYTY0ZmEyMjFlOWY0OGZiZjhhYjkzMzRiNzkzNGVmYjk3OWQ3NThkZjRkMGMxYmQxNzY5NSJ9fX0=
        data : 0
        name : '&3&lVisser &8| &fSoul'
        lore:
          - '&8Type : Fishing Soul'
          - ''
          - '&9Attrazione'
          - '&8When you catch a puffer fish, you have a 0.1'
          - '&8chance of getting Visser''s rod.'
          - ''
          - '&7Enchanter'
          - '&8You have a chance to get Mending book, this'
          - '&8chance increases each level (Base level : 0.0001 ).'
          - '&8Minimum level 50 required.'
          - ''
          - '&eApfel'
          - '&8Fishing gets enchanted golden apples with the'
          - '&8Visser Rod. You can only receive the rewards'
          - '&8using your rod.'
          - ''
          - '&5Side'
          - '&8If you catch something, you have a chance to'
          - '&8get a Totem, but it will consume a &5Side&8. You are'
          - '&8also required to use your Visser rod.'
          - ''
          - '&7Level : &3%level%'
          - ' %progress%'
          - ''
Code (YAML):
Messages:
  no-permission : '&8 [&fV-Souls&8 ] &cYou don''t have permissions.'
  soul-doesnt-exist : '&8 [&fV-Souls&8 ] &cThat soul doesn''t exist.'
  not-a-soul : '&8 [&fV-Souls&8 ] &cThis isn''t a soul.'
  inventory-no-space : '&8 [&fV-Souls&8 ] &c %player% has no space in his inventory.'
  offline-player : '&8 [&fV-Souls&8 ] &cThat player is offline.'
  given-soul-player : '&8 [&fV-Souls&8 ] &aYou have received a %soul% soul.'
  given-soul-admin : '&8 [&fV-Souls&8 ] &aYou gave %player% the soul %soul%.'
  set-level-hand : '&8 [&fV-Souls&8 ] &aThe level of the soul in your hand has been set to %level%!'
  add-exp-player : '&8 [&fV-Souls&8 ] &aYour active soul has received %exp% exp.'
  add-exp-admin : '&8 [&fV-Souls&8 ] &aAdded to the active soul of %player% %exp% exp.'
  set-exp-player : '&8 [&fV-Souls&8 ] &aYour active soul exp was set to %exp%.'
  set-exp-admin : '&8 [&fV-Souls&8 ] &aThe exp of the active soul of %player% was set to %exp%.'
  add-level-player : '&8 [&fV-Souls&8 ] &aYour active soul received %level% level(s), and went up to %newLevel% level.'
  add-level-admin : '&8 [&fV-Souls&8 ] &aThe active soul of %player% was added %level% level.'
  set-level-player : '&8 [&fV-Souls&8 ] &aThe level of your active soul is set to %level%.'
  set-level-admin : '&8 [&fV-Souls&8 ] &aThe soul level of %player% is set to %level%.'
  maxed-soul : '&8 [&fV-Souls&8 ] &cThe active soul of %player% is already at maximum level.'
  has-active-soul : '&8 [&fV-Souls&8 ] &c %player% doesn''t have an active soul'
  soul-levelup : '&8 [&fV-Souls&8 ] &aYour soul %soul% level up to %level%.'
  invalid-level : '&8 [&fV-Souls&8 ] &cThe level you mentioned is invalid.'
  invalid-exp : '&8 [&fV-Souls&8 ] &cThe exp you mentioned is invalid.'
  activate-soul : '&8 [&fV-Souls&8 ] &aThe soul has been activated.'
  deactivate-soul : '&8 [&fV-Souls&8 ] &cThe soul has been deactivated.'
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 363
First Release: Feb 18, 2023
Last Update: Apr 21, 2023
Category: ---------------
All-Time Rating:
5 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings