AdvancedAbilities

Mar 9, 2019
AdvancedAbilities
  • [​IMG]


    How can I create my own abilities?(top)


    At the moment you can create your own abilities using the API (Basic Java knowledge).

    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 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...