Advanced Abilities

Oct 8, 2019
Advanced Abilities

  • [​IMG][​IMG][​IMG][​IMG][​IMG]



    How can I create my own abilities?(top)

    You can create your custom ability using Ability Creator System, click here or click CREATOR button.

    Also you can create your own ability using the API.

    Abilities and others created using the API(top)


    ABILITIES:
    OTHERS:

    How can I disable a sound?(top)


    All configurable sounds are in 'sounds.properties' file.
    You have to replace the sound by "NONE", example:
    Code (Text):
    menu.next_page=none

    How can I use the RPG system? / How can I change the system?(top)


    You have to go to /AdvancedAbilities/settings.yml and change the default system by 'RPG'.
    Code (Text):
    # Set a system type, it will be the main system.
    # Types: rpg, money.
    system: money

    How can I use the CLASSES system? / How can use MAX_ABILITIES system?(top)


    Go to /AdvancedAbilities/player-settings.yml and change the default value "NONE" by your system:
    Code (Text):
    secondary_abilities_system: MAX_ABILITIES # Or CLASSES

    How can I enable/disable the MANA system?(top)


    Go to /AdvancedAbilities/mana.yml and set to 'true(enable)/false(disable)' the mana_system_enable option:
    Code (Text):
    # Set to true if you want to enable the mana/energy system.
    mana_system_enable: true

    How can I change the ability level description?(top)


    You can change the ability level description in your message file (default: messages_en), but if you want to set a custom description in X level then you can add 'description' in the ability YAML file, example:
    Code (Text):
      '3':
        # Ability will be enabled if the player has a chance lower than this.
        chance: 12

        # This depends on RPG system, players need to have this exp to get this level.
        xp_needed: 6300

        # You can customize this purchase adding conditions.
        # Conditions:
        # - permission: Set a permission to buy this level, example: 'permission=example.example'.
        # - price: Set a price to buy this level, example: 'price=1000'
        # - currency: Set a currency type to the price, default is 'vault', all: [none, vault, playerpoints] also you can hook your money plugin using the API.
        # - by_items: Add items like price, example: 'by_items=5,0,1; 276,0,1,ENCHANTMENTS=KNOCKBACK:1-SHARPNESS:1'. Use ';' to add another item.
        # - by_level: Set a player xp level like price, example: 'by_level=50'.
        buying_options:
        - price=200
        - currency=none
        description: # <---------------------------
        - "&a&lTEST"
        - "&b&lTEST"
        - "&e&lTEST"
        - "&l&lTEST"

    How can I give advantages to my players with ranks (VIP, MVP, etc)?(top)


    You can give advantages to your VIP players using:
    + MAX_ABILITIES: VIP players will be able to select more abilities:
    Code (Text):
    # Add here your custom limit.
    max_abilities_system_limits:
      # This is the max abilities for players without permissions.
      default:
        # This is the limit, players can't have more abilities than this limit.
        max_abilities: 5
      # Don't repeat the name section, you can name this as you want.
      '1':
        # Players need this permission to have this.
        permission: advancedabilities.mvp # <----------------
        # This is the limit, players can't have more abilities than this limit. Use '*' to all abilities.
        max_abilities: '*'
      '2':
        # Players need this permission to have this.
        permission: advancedabilities.vip # <----------------
        # This is the limit, players can't have more abilities than this limit. Use '*' to all abilities.
        max_abilities: 8
    + CLASSES: VIP players will be able to select VIP classes:
    Code (Text):
    # Add here your custom class.
    classes_system_abilities:
      # Don't repeat the name section, you can name this as you want.
      knight_vip:
        # This name will replace the variable symbol in the title.
        name: Knight VIP
        # Classes selector will represent this class with this icon. Format <ID>,<DATA>,<AMOUNT>.
        icon: 267,0,1
        # This is the description of the class.
        description: []
        # If select system isn't enabled, players need this permission to have this.
        permission: advancedabilities.vip.kinght # <----------------------------------
        # Players that selected this class will have these abilities.
        abilities:
        - aggressive_mode
        - vampire_mode
        - sword_push
        - antidote
      tank_vip:
        # This name will replace the variable symbol in the title.
        name: Tank VIP
        # Classes selector will represent this class with this icon. Format <ID>,<DATA>,<AMOUNT>.
        icon: 307,0,1
        # This is the description of the class.
        description: []
        # If select system isn't enabled, players need this permission to have this.
        permission: advancedabilities.vip.tank # <----------------------------------
        # Players that selected this class will have these abilities.
        abilities:
        - vampire_mode
        - feather_weight
        - fire_resistance
        - legendary_protection
        - arrow_tank_skin
        - explosive_arrow
      farmer:
        # This name will replace the variable symbol in the title.
        name: Farmer
        # Classes selector will represent this class with this icon. Format <ID>,<DATA>,<AMOUNT>.
        icon: 294,0,1
        # This is the description of the class.
        description: []
        # If select system isn't enabled, players need this permission to have this.
        permission: advancedabilities.class.farmer
        # Players that selected this class will have these abilities.
        abilities:
        - pirate
        - mining_luck
        - woodchopping_luck
        - adrenaline_boost
      archer:
        # This name will replace the variable symbol in the title.
        name: Archer
        # Classes selector will represent this class with this icon. Format <ID>,<DATA>,<AMOUNT>.
        icon: 261,0,1
        # This is the description of the class.
        description: []
        # If select system isn't enabled, players need this permission to have this.
        permission: advancedabilities.class.archer
        # Players that selected this class will have these abilities.
        abilities:
        - triple_arrow_shot
        - explosive_arrow
        - feather_weight
        - adrenaline_boost
      ninja:
        # This name will replace the variable symbol in the title.
        name: Ninja
        # Classes selector will represent this class with this icon. Format <ID>,<DATA>,<AMOUNT>.
        icon: 298,0,1
        # This is the description of the class.
        description: []
        # If select system isn't enabled, players need this permission to have this.
        permission: advancedabilities.class.ninja
        # Players that selected this class will have these abilities.
        abilities:
        - feather_weight
        - antidote
        - adrenaline_boost
        - sword_push
        - fire_resistance
    + Discounts (Money): VIP players will be able to buy abilities with lower costs!
    Code (Text):
    system_money_discounts_types:
      # Don't repeat the name section, you can name this as you want.
      '1':
        # Players need this permission to have this discount.
        permission: advancedabilities.mvp
        # This percentage will be discounted from the price. example, normal price is 5000, with the discount = 2500.
        discount_percentage: 50
      '2':
        # Players need this permission to have this discount.
        permission: advancedabilities.vip
        # This percentage will be discounted from the price. example, normal price is 5000, with the discount = 1500.
        discount_percentage: 30
    + RPG Exp Boosters: VIP players will earn more experience!
    Code (Text):
    system_rpg_boosters_types:
      # Don't repeat the name section, you can name this as you want.
      '1':
        # Players need this permission to have this booster.
        permission: advancedabilities.mvp
        # This number will be multiplied by the exp amount.
        multiplier: 2.0
      '2':
        # Players need this permission to have this booster.
        permission: advancedabilities.vip
        # This number will
    + More Max Mana (Mana system): VIP players will have more max mana and more regeneration.
    Code (Text):
    mana_system_groups:
      # Don't repeat the name section, you can name this as you want.
      default:
        # This will be the max amount of mana for players without any permission.
        max: 20.0
        # Players will regenerate this amount of mana.
        regeneration: 1.5
      '1':
        # Players need this permission to have this max mana.
        permission: advancedabilities.mvp
        # This will be the max amount of mana for players have this permission.
        max: 30.0
        # Players will regenerate this amount of mana.
        regeneration: 2.0
      '2':
        # Players need this permission to have this max mana.
        permission: advancedabilities.vip
        # This will be the max amount of mana for players have this permission.
        max: 25.0
        # Players will regenerate this amount of mana.
        regeneration: 1.8
    + Also you can add permissions to buy, example: You can add permissions in high abilities levels to only VIP players can buy them:
    Code (Text):
        # You can customize this purchase adding conditions.
        # Conditions:
        # - permission: Set a permission to buy this level, example: 'permission=example.example'.
        # - price: Set a price to buy this level, example: 'price=1000'
        # - currency: Set a currency type to the price, default is 'vault', all: [none, vault, playerpoints] also you can hook your money plugin using the API.
        # - by_items: Add items like price, example: 'by_items=5,0,1; 276,0,1,ENCHANTMENTS=KNOCKBACK:1-SHARPNESS:1'. Use ';' to add another item.
        # - by_level: Set a player xp level like price, example: 'by_level=50'.
        buying_options:
        - price=20000
        - currency="vault"
        - permission: advancedabilities.your.vip.permission

    Where can I download the API?(top)


    Click here: https://www.spigotmc.org/wiki/advancedabilities-api/ -> and "CLICK HERE TO DOWNLOAD API"

    PlaceholderAPI - Placeholders / How to enable / How to use(top)


    If you want to use PlaceholderAPI placeholders you have to enable it in '/AdvancedAbilities/menu.yml' -> 'placeholder_api_enable: true'.
    Placeholders:
    Code (Text):
    %advancedabilities_<ability_name>_level%
    %advancedabilities_<ability_name>_bar%
    %advancedabilities_player_class%
    %advancedabilities_mana%
    %advancedabilities_max_mana%
    If you want to add a variable/placeholder in the menu you should to replace '%' by '{' and '}', example:
    Code (Text):
    placeholder -> %advancedabilities_pirate_level%
    use -> {advancedabilities_pirate_level}


    How can I add items to buy instead of money?(top)


    You can use both; item format: <ID or NAME>,<DATA>,<AMOUNT> add ';' to add more items example here:
    Code (Text):
        # You can customize this purchase adding conditions.
        # Conditions:
        # - permission: Set a permission to buy this level, example: 'permission=example.example'.
        # - price: Set a price to buy this level, example: 'price=1000'
        # - currency: Set a currency type to the price, default is 'vault', all: [none, vault, playerpoints] also you can hook your money plugin using the API.
        # - by_items: Add items like price, example: 'by_items=5,0,1; 276,0,1,ENCHANTMENTS=KNOCKBACK:1-SHARPNESS:1'. Use ';' to add another item.
        # - by_level: Set a player xp level like price, example: 'by_level=50'.
        buying_options:
        - price=1520
        - currency="vault"
        - by_items="STONE,0,1;WOOD,0,1"

    How can I disable/remove an ability?(top)


    Go to /AdvancedAbilities/abilities/<your_ability>.yml and change the option 'enable=true' to 'enable=false'.

    How can I hide disabled abilities in the menu?(top)


    Go to /AdvancedAbilities/menu.yml and change the option 'hide_ability_is_disabled=true' to 'hide_ability_is_disabled=false'.

    How can I order the abilities in the menu?(top)


    Go to /AdvancedAbilities/menu.yml and order the list 'menu_abilities':
    Code (Text):
    menu_abilities:
    - 'triple_arrow_shot'
    - 'adrenaline_boost'
    - 'feather_weight'
    - 'aggressive_mode'
    - 'arrow_tank_skin'
    - 'antidote'
    - 'legendary_protection'
    - 'vampire_mode'
    - 'mining_luck'
    - 'woodchopping_luck'
    - 'pirate'
    - 'fire_resistance'
    - 'explosive_arrow'
    - 'sword_push'

    How can I change the menu hot bar items?(top)


    All menu files has a section named as "hotbar_items" or "items", there you can change the items, example:
    Code (Text):
    # Add here custom items to the hot bar.
    hotbar_items:
      # How can I add/edit an item?
      #  pages:
      #   '1': # All items from here will be added to section number. In this case 1.
      #     item_1: # This section can named as you want.
      #       name: '&6&lStats'
      #       material: '340:0:1'
      #       description:
      #       - '&7Click to see your stats?'
      #       action: CLOSE_MENU # [OPTIONAL].
      #       command: /advancedabilities stats # This is executed by the player. [OPTIONAL].
      #       command_console: /advancedabilities stats {player} # [OPTIONAL].
      #  Actions: CLOSE_MENU, NEXT_PAGE, PREVIOUS_PAGE.
      pages:
        # This means that items in this section will be added to all pages.
        '*':
          item_1:
            # This name supports variables like "{money_vault}". If you're using playerpoints then use "{money_playerpoints]".
            name: '&6Total coins: &e{money_vault}'
            # Item is displayed in menu <ID>,<DATA>,<AMOUNT>
            material: '395,0,1'
            # Description of the item
            description:
            - '&eEarn coins from'
            - '&eplaying games.'
            # Slot from 1 to 7
            slot: 3
          item_2:
            # This name supports variables like "{money_vault}". If you're using playerpoints then use "{money_playerpoints]".
            name: '&6Close menu'
            # Item is displayed in menu <ID>,<DATA>,<AMOUNT>
            material: '340,0,1'
            # Description of the item
            description:
            - '&eClose the abilities menu.'
            action: CLOSE_MENU
            # Slot from 1 to 7
            slot: 4
          item_3:
            # This name supports variables like "{money_vault}". If you're using playerpoints then use "{money_playerpoints]".
            name: '&6Abilities'
            # Item is displayed in menu <ID>,<DATA>,<AMOUNT>
            material: '145,0,1'
            # Description of the item
            description:
            - '&eImprove your pvp buying'
            - '&eabilities.'
            # Slot from 1 to 7
            slot: 5

    How can I change the plugin language?(top)


    Go to '/AdvancedAbilities/settings.yml' and change the value of "locale" (default is 'en'), example:
    Code (Text):
    # You don't have to add 'messages_' prefix, if you want use 'messages_es' then set it to 'es'.
    # All languages in the '/languages' folder.
    locale: zh

    How can I use MySQL?(top)


    You have to change the data_storage type, default is 'local', it's in 'AdvancedAbilities/settings.yml' and replace 'data_storage: local' by 'data_storage: mysql'.

    And set your information in these options:
    Code (Text):
    # MySQL hostname.
    data_storage_mysql_hostname: localhost

    # MySQL username.
    data_storage_mysql_username: root

    # MySQL password.
    data_storage_mysql_password: ''

    # MySQL port.
    data_storage_mysql_port: 3306

    # MySQL database.
    data_storage_mysql_database: database_name

    # MySQL suffix, you can use this if you want to have different tables.
    data_storage_mysql_suffix: ''

    How can I enable WorldGuard?(top)


    Go to '/AdvancedAbilities/settings.yml' and find the option 'worldguard_support' and set it to 'true', if you want to disable abilities, commands, etc in regions you have to find the 'disabled_regions' option and add your region name there.

    How can I enable Factions?(top)


    Go to '/AdvancedAbilities/settings.yml' and find the option 'factions_support' and set it to 'true', if you want to disable abilities, commands, etc in factions you have to find the 'disabled_factions' option and add your faction id there.

    How can I enable/disable the menu item?(top)


    Go to '/AdvancedAbilities/settings.yml' and change the 'menu_item_enable' value by 'true(enable)/false(disable)'.

    How can I create holograms?(top)


    If you have the hologram system disabled, you have to activate it in '/AdvancedAbilities/hologram.yml' -> 'enable: true'.
    To create a hologram in game you have to go to the location that you want to create a hologram and use the command (/abilities hologram create).

    [​IMG]

    How can I configurate the RPG events?(top)


    Go to '/AdvancedAbilities/rpg.yml' and find 'events' section, example:
    Code (Text):
    events:
      # How can I create a reward?
      #  any_event:
      #   '1': # You can name this as you want.
      #     hand_item: 276 # Players need to have this item in their hand to get this reward. (Condition)
      #     give: # You can add many reward of exp.
      #       '1': # As I said, you can name this as you want.
      #         ability: aggressive_mode # The exp will be added to this ability.
      #         exp: 7.8 # This is the exp that will be added.
      #       '2':
      #         ability: vampire_mode # The exp will be added to this ability.
      #         exp: 5.4 # This is the exp that will be added.
      #
      # Conditions: hand_item <ID or List<ID>>, block_break <ID or List<ID>>, min_damage <number>, min_distance <number>.
      # Black lists: enchantments_black_list<List<String(Enchantment)>>.

      # Add worlds name to disable events in those worlds.
      disabled_worlds: []

      # Add regions name to disable events in those regions, to this you need WorldGuard plugin and have "worldguard_support" to 'true'.
      # Use '*' to this in all regions.
      disabled_regions: []

      # Add factions name to disable events in those factions, to this you need Factions plugin and have "factions_support" to 'true'.
      # You can add 'WarZone' to disable commands in War Zone faction.
      # Use '*' to disable this in all factions.
      disabled_factions: []

      # This event is called when a player kills a player.
      kill_player:
        '1':
          hand_item: 276
          rewards:
            '1':
              ability: aggressive_mode
              exp: 7.8
            '2':
              ability: vampire_mode
              exp: 5.2
            '3':
              ability: sword_push
              exp: 3.2
        '2':
          hand_item: 267
          rewards:
            '1':
              ability: aggressive_mode
              exp: 6.5
            '2':
              ability: vampire_mode
              exp: 3.7
        '3':
          hand_item: 272
          rewards:
            '1':
              ability: aggressive_mode
              exp: 4.6
            '2':
              ability: vampire_mode
              exp: 1.8
        '4':
          rewards:
            '1':
              ability: aggressive_mode
              exp: 1.2
            '2':
              ability: vampire_mode
              exp: 0.3

    How can I disable the automatically open abilities selector menu when a player joins?(top)


    MAX_ABILITIES or others:

    • Go to '/AdvancedAbilities/menus/abilities_selector.yml' and disable 'open_menu_join' option.
    CLASSES:
    • Go to '/AdvancedAbilities/menus/classes_menu.yml' and disable 'open_menu_join' option.

    How can I order the classes icons in the selector menu?(top)


    Go to '/AdvancedAbilities/menus/classes_menu.yml' and order your classes there in 'menu_classes' list.
    Code (Text):
    # Classes will be added according to this order.
    menu_classes:
    - knight
    - tank
    - farmer
    - archer
    - ninja

    How can I add my API ability in the mana system?(top)


    File: '/AdvancedAbilities/mana.yml'.
    You have to add your ability using the format; format: <ability_id>:<level>:<amount> or <ability_id>:<amount>. This is the mana spends abilities list (I use in this example the DoubleJump ability (created by API of course):
    Code (Text):
    abilities:
    - 'double_jump:7'
    - 'triple_arrow_shot:1:5'
    - 'triple_arrow_shot:3:6'
    - 'triple_arrow_shot:6:8'
    - 'adrenaline_boost:4'
    - 'adrenaline_boost:5:5'
    - 'feather_weight:5'
    - 'feather_weight:5:6'
    - 'aggressive_mode:1:4'
    - 'aggressive_mode:2:5'
    - 'aggressive_mode:5:7'
    - 'aggressive_mode:7:8'
    - 'arrow_tank_skin:4'
    - 'arrow_tank_skin:4:5'
    - 'antidote:3'
    - 'antidote:5:4'
    - 'legendary_protection:5'
    - 'legendary_protection:2:6'
    - 'legendary_protection:6:7'
    - 'vampire_mode:6'
    - 'vampire_mode:3:9'
    - 'vampire_mode:6:11'
    - 'mining_luck:4'
    - 'woodchopping_luck:2'
    - 'pirate:7'
    - 'fire_resistance:1'
    - 'explosive_arrow:1:6'
    - 'explosive_arrow:2:7'
    - 'explosive_arrow:5:8'
    - 'explosive_arrow:7:9'
    - 'sword_push:2:6'
    - 'sword_push:5:8'
    If your API ability isn't in the list then plugin will use the default value ('mana_ability_default').

    Where can I find the plugin logs?(top)


    Plugin generates the logs when your server is restarting or when the server shutdowns, you can tind this files in /AdvancedAbilities/logs.

    How can I use the API? / API WIKI(top)


    https://www.spigotmc.org/wiki/advancedabilities-api/

    Where can I configure the abilities?(top)


    All abilities configuration files are in /plugins/AdvancedAbilities/abilities.

    How can I contact the author? / Support(top)


    https://www.spigotmc.org/conversations/add?to=AnyBody&title=AdvancedAbilities support

    Where can I find my old/deleted files?(top)


    Plugin does not delete your files, the plugin will move old files to "/AdvancedAbilities/outdated/<your_file>", to avoid an error/issue.
  • Loading...
  • Loading...