☄️ ArcaneTinkerer | Turn items in commands ☄️

actions.md

Default Actions

Actions that doesn't require any other plugin installed to work

Player Command

• [PLAYERCOMMAND]
• Makes the player execute a command
• Arguments
  • command
• Example: [PLAYERCOMMAND] balance

Console Command

• [CONSOLECOMMAND]
• Executes a command as the console
• Arguments
  • command
• Example: [PLAYERCOMMAND] eco give %player_name% 1000

Sound

• [SOUND]
• Plays a sound to every online player
• Arguments
  • sound (a list with all available sounds can be found here)
  • volume
  • pitch
• Example: [SOUND] ENTITY_ARROW_HIT_PLAYER;2.0;2.0

Sound Broadcast

• [SOUNDBROADCAST]
• Plays a sound to every online player
• Arguments
  • sound (a list with all available sounds can be found here)
  • volume
  • pitch
• Example: [SOUNDBROADCAST] ENTITY_ARROW_HIT_PLAYER;2.0;2.0

Message

• [MESSAGE]
• Sends a message to the player
• Arguments
  • message
• Example: [MESSAGE] &fHello &a%player_name%&f!

Center Message

• [CENTERMESSAGE]
• Sends a centered message to the player (This is not guaranteed to display perfectly)
• Arguments
  • message
• Example: [CENTERMESSAGE] &fHello &a%player_name%&f!

Broadcast

• [BROADCAST]
• Sends a message to every online player
• Arguments
  • message
• Example: [BROADCAST] &fHellp &aeveryone&f!

Center Broadcast

• [CENTERBROADCAST]
• Sends a centered message to every online player (This is not guaranteed to display perfectly)
• Arguments
  • message
• Example: [CENTERBROADCAST] &fHello &aeveryone&f!

JSON Message

• [JSONMESSAGE]
• Sends a JSON message to the player. Executes Minecraft's /tellraw command, so usage may change between versions
• Arguments
  • json
• Example: [JSONMESSAGE] {"text":"Go to Google","color":"red","clickEvent":{"action":"open_url","value":"google.com"}}

JSON Broadcast

• [JSONBROADCAST]
• Sends a JSON message to every player on the server. Executes Minecraft's /tellraw command, so usage may change between versions
• Arguments
  • json
• Example: [JSONBROADCAST] {"text":"Go to Google","color":"red","clickEvent":{"action":"open_url","value":"google.com"}}

Title Message

• [TITLEMESSAGE]
• Sends a title message to the player
• Arguments
  • title
  • subtitle
  • fade-in ticks
  • display ticks
  • fade-out ticks
• Example: [TITLEMESSAGE] Hello;%player_name%;20;60;20

Title Broadcast

• [TITLEBROADCAST]
• Sends a title message to every player
• Arguments
  • title
  • subtitle
  • fade-in ticks
  • display ticks
  • fade-out ticks
• Example: [TITLEBROADCAST] Hello;Players;20;60;20

ActionBar Message

• [ACTIONBARMESSAGE]
• Sends a message to the player through the actionbar
• Arguments
  • message
• Example: [ACTIONBARMESSAGE] &cThis shows in the actionbar

ActionBar Broadcast

• [ACTIONBARBROADCAST]
• Sends a message to every player in the server through the actionbar
• Arguments
  • message
• Example: [ACTIONBARBROADCAST] &cEveryone sees this in the actionbar

TokenEnchant Actions

Requires TokenEnchant to work

Give TokenEnchant Tokens

• [GIVETETOKENS]
• Give the player tokenenchant tokens
• Arguments
  • amount
• Example: [GIVETETOKENS] 100

Vanilla actions

Give XP

• [GIVEXP]
• Give the player xp points or levels by adding a L at the end
• Arguments
  • amount
• Example: [GIVEXP] 20 [GIVEXP] 5L

Vault Actions

Requires Vault to work

Give Vault Money

• [GIVEVAULTMONEY]
• Give the player money using vault
• Arguments
  • amount
• Example: [GIVEVAULTMONEY] 100

config.yml

#
# ArcaneTinkerer v1.0 by Fortified Dev (GabyTM & LemmoTresto)
# The plugin depends on PlaceholderAPI and ActionUtil
#
# • PlaceholderAPI - https://www.spigotmc.org/resources/6245/
# • ActionUtil     - https://www.spigotmc.org/resources/60408/
# • Discord        - https://gabytm.me/
#

messages:
  no_items: "&cCouldn't find any items to tinker"
  no_permission: "&cYou can't use this command!"
  players_only: "&cOnly player can run this command."
  reload: "&aThe plugin has been successfully reloaded!"

gui:
  title: '&5Arcane Tinkerer'
  #
  # The sound played to the player, set to 'null' or comment out to disable
  # A list with the valid sounds for each version can be found here https://git.io/JeoHM
  #
  sound: BLOCK_ANVIL_USE
  #
  # The button that is used to convert the items in actions
  #
  # • material     - (required) the material
  # • damage       - (optional) the material damage or data value (for older versions)
  # • glow         - (optional) make the item glow (true / false, default - false) (v1.1+)
  # • display_name - (optional) the item display name
  # • lore         - (optional) the item lore
  #
  button:
    material: ANVIL
    damage: 0
    display_name: '&5Click to tinker'
    lore:
      - '&7Add some cool lore'
  #
  # The border around the gui (same customization options as above)
  #
  border:
    material: STAINED_GLASS_PANE
    damage: 7
    display_name: ' '

packs:
  #
  # Pattern packs are used to give access to multiple patterns using one permission (v1.1+)
  #
  # • identifier    - the pack id, must be unique and is used for the permission ('arcanetinkerer.pack.ID HERE')
  # • patterns list - the patterns list, the pattern name is case sensitive (eg 'pattern' isn't the same as 'Pattern')
  #
  example:
    - arcaneAxe

patterns:
  #
  # The first line is the pattern identifier and it MUST be unique, as well as the priority
  # The permission 'arcanetinkerer.pattern.ID HERE' is required in order to get access to a pattern
  #
  # • priority   - (required) lower number = higher priority
  # • amount     - (optional) the amount of items required in order to pass the checks
  # • type       - (optional) the check type, available options: name or lore (default - name)
  # • materials  - (required) the materials list that would be accepted for this pattern
  # • expression - (required) the expression used to check the item name or lore (color codes are ignored)
  # • actions    - (required) he actions that will be executed if the item pass the checks
  #
  arcaneAxe:
    priority: 1
    amount: 1
    type: name
    #
    # Accepted formats for each version:
    #
    # • Format - MATERIAL,DAMAGE
    #          - STONE,1
    #   Note! DAMAGE is optional
    #
    # Materials list:
    #
    # • Latest - https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
    # • 1.13.2 - https://helpch.at/docs/1.13.2/org/bukkit/Material.html
    # • 1.12.2 - https://helpch.at/docs/1.12.2/org/bukkit/Material.html
    # • 1.11.2 - https://helpch.at/docs/1.11.2/org/bukkit/Material.html
    # • 1.10.2 - https://helpch.at/docs/1.10.2/org/bukkit/Material.html
    # • 1.9.4  - https://helpch.at/docs/1.9.4/org/bukkit/Material.html
    # • 1.8.8  - https://helpch.at/docs/1.8.8/org/bukkit/Material.html
    #
    materials:
      - STONE_AXE
    #
    # More info about regex can be found here https://www.javatpoint.com/java-regex
    #
    expression: '.*Arcane Axe.*'
    #
    # A complete list can be found here https://git.io/JeoHX
    #
    actions:
      - '[CONSOLECOMMAND] eco give %player_name% 100' # or '[GIVEVAULTMONEY] 100' if Vault is installed
      - '[MESSAGE] &7You have been given &d100&5$ &7in exchange for your &5Arcane Axe'