Sueta

V-Souls | Souls that execute rewards when in inventory (Like

1.0.7

Souls that give you rewards when you fulfill certain requirements.

·Plugin


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
Spoiler

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>
  • Requirements to execute the rewards
Spoiler
  • [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:

  • Different types of actions to be performed on rewards
  • Rewards
Spoiler
  • 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
Spoiler
  • %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
Spoiler
  • [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
Spoiler

Example:

  • Conditionals available for rewards
Spoiler
  • Conditionals available
    • || (Conditional meaning OR)
    • && (Conditional meaning AND)
  • Configure the item visually
Spoiler
  • 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%

Example:

  • Configure the cost of the levels
Spoiler
  • The cost for the next level is multiplied by the cost in configuration for the next level
  • Code option
Spoiler
  • 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
Spoiler
  • %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

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

Similar projects

Plugin →