◽Command Types

All the command types you can use to create awesome commands!

Alert

Example

alert:
  type: "alert"
  enabled: true
  name: "alert"
  permission: "leaf.alert"
  # %message% : The alert message.
  message: "&8&l[&f&lAlert&8&l]&r &a%message%"

/[name] [message]

The alert command type sends a message to all players.

Alert Raw

Example

alertraw:
  type: "alertraw"
  enabled: true
  name: "alertraw"
  permission: "leaf.alertraw"

/[name] [JSON]

The alert raw command type sends a JSON message to all players.

Chat

Example

staffchat:
  type: "chat"
  enabled: true
  name: "staffchat"
  aliases: [ "sc" ]
  permission: "leaf.staffchat"
  # Should the messages be logged in console?
  log: true
  # %message% : The players message.
  format: "{server_formatted}&r {rank_colour}<player>&r &7: {vanish_colour}%message%"

/[name] [message]

The chat command is used to send a message to other players with the same permission.

Find

Example

find:
  type: "find"
  enabled: true
  name: "find"
  permission: "leaf.find"
  not_found: "{error_colour}Player could not be found."
  # Placeholders will parse in terms of the player.
  found: "{message} Player was found on {server_formatted}"
  # Let vanishable players find vanishable players?
  vanishable_players: false

/[name] [player]

The find command is used to get information about an online player.

Info

Example

info:
  type: "info"
  enabled: true
  name: "leaf"
  message:
    - "&8&m&l-------&r &a&lLeaf &8&m&l-------"
    - "&7"
    - "&7Velocity Proxy Plugin"
    - "&7Version &f<version>"
    - "&7Author &fSmudge"
    - "&7"
    - "&8&m&l--------------------"

Example

hello:
  type: "info"
  enabled: true
  name: "hello"
  message: "world"

/[name]

The info command is used to display information.

List

Example

stafflist:
  type: "list"
  enable: true
  name: "stafflist"
  permission: "leaf.stafflist"
  header: "&8&m&l-----&r &a&lStaff List &8&m&l-----"
  footer: "&8&m&l--------------------"
  list:
    admin:
      permission: "leaf.rank.admin"
      header: '&7[&f%amount%&7] &c&lAdmins'
      # Placeholders will parse in terms of the player.
      section: '&7- &f<player> {server_formatted}'

/[name]

The list command is used to display a list of online players.

Reload

Example

reload:
  type: "reload"
  enabled: true
  name: "leafreload"
  permission: "leaf.reload"
  message: "{message} Reloaded all configs! <3"
  error: "{error_colour}An error occurred and the reloading was aborted!"

/[name]

The reload command is used to reload the leaf plugin. Reloading the plugin reloads the configs and re-adds the commands with the new configuration. If you remove a command and reload the plugin, it will be removed from the server.

Report

Example

report:
  type: "report"
  enable: true
  name: "report"
  # Who is able to run the command :
  permission: "leaf.report.use"
  # Who is able to see the report :
  see_report: "leaf.report.see"
  # %message% : The players message.
  message: "&f<player> {server_formatted} &chas reported &7: &f%message%"

/[name] [message]

The report command is used to send a message to a group of players.

Send

Example

send:
  type: "send"
  enable: true
  name: "send"
  permission: "leaf.send"
  # %from% : From command argument.
  # %to% : To command argument.
  # %amount% : Amount of players successfully sent.
  message: "{message} Sending %from% to %to% &7[&f%amount% &7players]"
  server_not_found: "{error_colour}Server not found."
  server_offline: "{error_colour}Server requested is offline."

/[name] [from] [to]

The send command is used to warp a group of players to a server.

Servers

Example

servers:
  type: "servers"
  enable: true
  name: "servers"
  permission: "leaf.servers"
  # The order of how the servers will be displayed.
  order:
    - name_of_a_server
    - testing1
    - testing2
  header: '&8&m&l------&r &a&lServers &8&m&l------'
  # Placeholders registered in context of the server.
  server: '{server_formatted} &f%online% &7Online Players'
  footer: '&8&m&l---------------------'

/[name]

The servers command is used to display the list of online servers.

Mesage

Example

message:
  type: "message"
  enable: true
  name: "globalmessage"
  aliases: ["gmsg"]
  not_found: "{error_colour}Player is not online."
  message_self: "{error_colour}You cannot message yourself."
  # Placeholders will parse in terms of the other player.
  to: "&f✉ &7&ome -> &f&o<player> &7&o: &f&o%message%"
  from: "&f✉ &f&o<player> -> &7&ome &7&o: &f&o%message%"
  # Let vanishable players message other vanishable players?
  vanishable_players: false

/[name] [player] [message]

The message command is used to send a message to a specific online player.

Reply

Example

reply:
  type: "reply"
  enable: true
  name: "globalreply"
  aliases: [ "gr" ]
  not_found: "{error_colour}You have no conversation to reply to."
  # Placeholders will parse in terms of the other player.
  to: "&f✉ &7&ome -> &f&o<player> &7&o<server> &7&o: &f&o%message%"
  from: "&f✉ &f&o<player> &7&o<server> -> &7&ome &7&o: &f&o%message%"

/[name] [message]

The reply command is used to reply to a previous message.

Ignore

ignore:
    type: "ignore"
    enable: true
    name: "ignore"
    not_found: "{error_colour}Player is not online."
    ignore_self: "{error_colour}You cannot ignore yourself."
    message: "{message} You are now ignoring <player>"

/[name] [player]

The ignore command is used to ignore other players. This stops them from sending a message to you.

Unignore

unignore:
    type: "unignore"
    enable: true
    name: "unignore"
    not_found: "{error_colour}You are not ignoring this player."
    message: "{message} You are no longer ignoring <player>"

/[name] [player]

The unignore command is used to remove a player from your ignore list.

Ignore List

ignorelist:
    type: "ignorelist"
    enable: true
    name: "ignorelist"
    message:
      - "&8&m&l------&r &a&lIgnored Players &8&m&l------"
      - "%players%"
      - "&8&m&l---------------------"

/[name]

The ignore list command is used to display your ignore list.

Toggle Messages

togglemessages:
    type: "togglemessages"
    enable: true
    name: "togglemessages"
    # %toggle% will be replaced with true or false
    message: "{message} Toggled messages %toggle%"

/[name]

Used to toggle messages. When this is sent to false you can't send or receive messages.

Toggle Spy

togglespy:
    type: "togglespy"
    enable: true
    name: "togglespy"
    permission: "leaf.togglespy"
    # %toggle% will be replaced with true or false
    message: "{message} Toggled spy %toggle%"

/[name]

Used to toggle spy. When set to true you will be able to see other players' messages.

History

Example

history:
  type: "history"
  enable: true
  name: "history"
  not_found: "{error_colour}Player could not be found."
  # Amount of sections on a page.
  page_size: 5
  # %page% : The number of the page the player is currently viewing.
  # %page_amount% : The amount of pages they can see.
  header: "&8&m&l------&r &a&l<player>''s History &7[&f%page%&7/&f%page_amount%&7] &8&m&l------"
  # %event% : The history event.
  # %server% : The server.
  # %date% : The date and time it occurred.
  section: '&7- %event%&r %server%&r &7%date%'
  # %page% : The number of the page the player is currently viewing.
  # %page_amount% : The amount of pages they can see.
  footer: '&8&m&l---------------------'

/[name] [player]

The history command is used to get a player's history from the database. The dataase.yml must be enabled.

Message History

/[name] [query]

The message history command is used to get message data from the database.

Example: /messagehistory p:Smudge t:10d i:"Hi!" e:"Bye","Byebye"

Example: /messagehistory p:Smudge,Smudge2 t:1d-2d

Query Types p: Is used to include a player or players. t: Is used to specify a time period. i: is used to only show message that include the strings. e: is used to remove messages that include the strings.

message_history:
    type: "messagehistory"
    enabled: true
    name: "messagehistory"
    not_found: "{error_colour}Player could not be found."
    # Amount of sections on a page.
    page_size: 8
    # %page% : The number of the page the player is currently viewing.
    # %page_amount% : The amount of pages they can see.
    header: '&8&m&l------&r &a&lMessages &7[&f%page%&7/&f%page_amount%&7] &8&m&l------'
    # %message% : The content of the message.
    # %from% : The player the message was from.
    # %to% :  player the message was sent to.
    # %date% : The date the message was sent.
    section: '&7%date% &f%from% &7: &e%message%'
    # %page% : The number of the page the player is currently viewing.
    # %page_amount% : The amount of pages they can see.
    footer: '&8&m&l---------------------'

Inventory

Example

inventory:
  type: "inventory"
  enabled: true
  name: "menu"
  inventory:
    size: GENERIC_9X6
    title: "&8&lMenu"
    content:
      "top,bottom":
        material: LIME_STAINED_GLASS_PANE
      "center0":
        skull: "<player>"
        name: "&a&l<player>"
        lore:
          - "&7You are amazing!"

/[name]

The inventory command is used to display an inventory to the player. For more information on inventories click here.

Teleport

teleport:
  type: "teleport"
  enabled: true
  name: "go"
  not_found: "{error_colour}Player could not be found."
  message: "{message} Teleporting..."

/[name] [player]

The teleport command is used to teleport to a server a player is connected to.

Join

join:
  type: "join"
  enabled: false
  name: "survival"
  # The name of the server to send the player to.
  server: "survival"
  no_server: "{error_colour}This server is offline"

/[name]

The join command is used to connect to a server.

Friends

For more information on friends click here.

Example

friends:
    type: "friends"
    enabled: true
    name: "friends"

    proxy_join: "&8[&a+&8] &7Your friend &a<player> &7joined {server_formatted}"
    proxy_leave: "&8[&c-&8] &7Your friend &c<player> &7left the network"
    server_change: "&8[&e=&8] &7Your friend &e<player> &7switched to {server_formatted}"

    list:
      name: "list"
      enabled: true
      # Lets you see other players friend lists.
      permission_see_any: "leaf.friends.see"
      not_found: "{error_colour}Player could not be found."
      error: "{error_colour}Error occurred when opening inventory."
      # %name% : Formatted name.
      # %date% : Date they started being friends
      # %last_mail% : The last mail that was sent.
      # %mail_status% : If the mail was read or not.
      player:
        skull: "%name%"
        name: "&6&l%name%"
        lore:
          - "&7Friends since %date%"
      no_player:
        material: LIGHT_GRAY_STAINED_GLASS_PANE
      # The inventory displaying the friend list.
      inventory:
        size: GENERIC_9X6
        title: "&8&lFriends List"
        content:
          "top,bottom":
            material: LIME_STAINED_GLASS_PANE
          "row1,row2,row3,row4":
            function:
              type: "player"
          "45":
            function:
              type: "last_page"
              always_show: false
            material: YELLOW_STAINED_GLASS_PANE
            name: "&a&lLast Page"
            lore:
              - "&7Click to go back a page"
          "53":
            function:
              type: "next_page"
              always_show: false
            material: YELLOW_STAINED_GLASS_PANE
            name: "&a&lNext Page"
            lore:
              - "&7Click to go to the next page"


    request:
      name: "request"
      enabled: true
      not_found: "{error_colour}Player has never played on this server."
      requests_off: "{error_colour}This player has there friend requests off."
      self: "{error_colour}You can not be friends with your self."
      # Placeholders will parse in terms of the other player.
      sent: "{message} You have sent a friend request to &f<player>"
      # Placeholders will parse in terms of the player that sent the request.
      from: "{message} You have received a friend request from &f<player>. &aTo accept run the command &e/friends accept"

    accept:
      name: "accept"
      enabled: true
      error: "{error_colour}Error occurred when opening inventory."
      requests_off: "{error_colour}This player has there friend requests off."
      already_requested: "{error_colour}You have already requested to be friends with this player."
      # Placeholders will parse in terms of the player that sent the request.
      # Message is sent to the friend accepter.
      from: "{message} You are now friends with &f<player>"
      # Placeholders will parse in terms of the player that accepted the friend request.
      # Message is sent to the requester.
      sent: "{message} You are now friends with &f<player>"
      # %name% : Formatted name of the player that is requesting.
      player:
        skull: "%name%"
        name: "&6&l%name%"
        lore:
          - "&7Click to open request options."
      no_player:
        material: LIGHT_GRAY_STAINED_GLASS_PANE
      # The inventory displaying the friend requests list.
      inventory:
        size: GENERIC_9X6
        title: "&8&lFriend Requests"
        content:
          "top,bottom":
            material: LIME_STAINED_GLASS_PANE
          "row1,row2,row3,row4":
            function:
              type: "player"
          "45":
            function:
              type: "last_page"
              always_show: false
            material: YELLOW_STAINED_GLASS_PANE
            name: "&a&lLast Page"
            lore:
              - "&7Click to go back a page"
          "53":
            function:
              type: "next_page"
              always_show: false
            material: YELLOW_STAINED_GLASS_PANE
            name: "&a&lNext Page"
            lore:
              - "&7Click to go to the next page"
      options:
        size: GENERIC_9X3
        title: "&8&lFriend Request"
        content:
          "0-2,9-11,18-20":
            function:
              type: "deny"
            material: RED_STAINED_GLASS_PANE
            name: "&c&lDeny"
            lore:
              - "&7Anonymously remove this player"
              - "&7from your requests."
          "6-8,15-17,24-26":
            function:
              type: "accept"
            material: LIME_STAINED_GLASS_PANE
            name: "&a&lAccept"
            lore:
              - "Click to &aaccept &7friend request."

    settings:
      name: "settings"
      enabled: true
      error: "{error_colour}Error occurred when opening inventory."
      inventory:
        size: GENERIC_9X3
        title: "&8&lFriend Requests"
        content:
          "row0,row2":
            material: GRAY_STAINED_GLASS_PANE
          "10":
            function:
              type: "toggleProxyJoin"
              # When true what should the item be overridden with
              true:
                material: LIME_STAINED_GLASS_PANE
            # Default item
            material: RED_STAINED_GLASS_PANE
            name: "&6&lToggle Join Messages"
            lore:
              - "&7Click to toggle join messages"
              - "&6Currently &f%toggleProxyJoin%"
          "11":
            function:
              type: "toggleProxyLeave"
              # When true what should the item be overridden with
              true:
                material: LIME_STAINED_GLASS_PANE
            # Default item
            material: RED_STAINED_GLASS_PANE
            name: "&6&lToggle Leave Messages"
            lore:
              - "&7Click to toggle leave messages"
              - "&6Currently &f%toggleProxyLeave%"
          "12":
            function:
              type: "toggleServerChange"
              # When true what should the item be overridden with
              true:
                material: LIME_STAINED_GLASS_PANE
            # Default item
            material: RED_STAINED_GLASS_PANE
            name: "&6&lToggle Server Change Messages"
            lore:
              - "&7Click to toggle server change messages"
              - "&6Currently &f%toggleServerChange%"
          "15":
            function:
              type: "toggleMail"
              # When true what should the item be overridden with
              true:
                material: LIME_STAINED_GLASS_PANE
            # Default item
            material: RED_STAINED_GLASS_PANE
            name: "&6&lToggle Mail"
            lore:
              - "&7Click to toggle mail"
              - "&6Currently &f%toggleMail%"
          "16":
            function:
              type: "toggleRequests"
              # When true what should the item be overridden with
              true:
                material: LIME_STAINED_GLASS_PANE
            # Default item
            material: RED_STAINED_GLASS_PANE
            name: "&6&lToggle Friend Requests"
            lore:
              - "&7Click to toggle friend requests"
              - "&6Currently &f%toggleRequests%"

    unfriend:
      name: "unfriend"
      enabled: true
      not_found: "{error_colour}Invalid player name."
      # Placeholders will register in terms of the friend.
      message: "{message} You are no longer friends with <player>"