Config and permissions for the ShowItem plugin: https://showitem.phoenix616.dev/

config.yml

# If the messages should try finding a text icon for this item from WolfieMarios Resourcepack (http://imgur.com/a/oHvbX)
texticon-rp: true
# If you have WorldResourcepacks (https://l.phoenix616.dev/wrp) or ForceResourcepacks (https://l.phoenix616.dev/frp) installed
# then you can specify which  pack contains the icons. So if WRP/FRP has not send a pack to the player or a pack
# that does not include the icons according to the below list then it wont show the icon characters to him.
# Set to an empty list [] in order to completely disable this compatibility.
packs-with-icons: []
# - serverpack

# The default language to use when there is no language file for a player's client locale
default-language: en

# If you have issues with item names not translating and showing their id you can enable this option
# and use the manual mapping in transmapping.yml for all items
use-translation-mapping: false
# The default radius for the /showitem (/show, /si) command if no -r(adius) parameter is specified
# Can also be "all" or "world" if the command without argument should target everyone (in the world)
default-radius: 16
# The amount of time in seconds that an inventory should be viewable after showing it
show-inv-timeout: 300
# This will show a live view of the inventory rather than the state when the command/variable was used
show-live-inv: false
# Try to automatically get the color of named items to color the brackets with
use-name-color-for-brackets: true
# Try to trim spaces from the start and end of an item's name
trim-item-name: true

# Disable the sending of metrics data
disable-metrics: false
# Whether or not to check for updates. Ingame notifications are controlled by the showitem.updatenotification permission.
update-check: true
# Use the plugin' name prefix for any component click commands to ensure ShowItem's command is run
# E.g. /showitem:showinv when opening a players inventory from a chat message
namespaced-commands: true

# Config options for the help functionality in the inventory
# In order to use this players need the showitem.helpclick permission
help-click:
  # Which type of click should send the help
  # LEFT, SHIFT_LEFT, RIGHT, SHIFT_RIGHT, MIDDLE, NUMBER_KEY (see numbers), DOUBLE_CLICK, DROP, CONTROL_DROP
  click-types:
  - MIDDLE
  # Which slots should send the help message
  # ARMOR, CONTAINER, QUICKBAR (hotbar)
  # Star is wildcard for every slot
  slot-types:
  - "*"
  # If click is of type NUMBER_KEY then these numbers will trigger the help
  # Star is wildcard for every number
  numbers:
  - "*"

chat:
  variables:
  # Which variables should be replaced in the chat with the player's current item
  # %slot% is the place where the slot name/number should be
  - "%item%"
  - "%item%slot%%"
  # Which variables should be usable to show a clickable text directly in the chat
  # to show your current inventory
  inv-variables:
  - "%inv%"
  - "%inventory%"
  # Which variables should be usable to show a clickable text directly in the chat
  # to show your current enderchest
  ender-variables:
  - "%ender%"
  - "%enderchest%"
  commands:
  # A list of commands where we should replace the variable with the item info
  - "msg"
  - "say"
  - "me"
  - "ch"
  # Maximum count of variables per message
  # Bypass with the showitem.chat.spam permission
  # 0 = unlimited
  max-per-message: 1
  # How to display variables that exceed the max count
  # An empty string removes them completely
  overflow-display: ""
  # Allow variable with no item in hand?
  # Uses lang.error.noitem as error message when false
  show-empty-hand: true
  # How should packets be handled? (requires a restart)
  # Possible values:
  # auto        - automatically detect the best solution
  # ProtocolLib - use ProtocolLib (if installed)
  # nms         - directly access native Minecraft server code
  # reflection  - access Minecraft server via reflections
  packet-handler: auto
  # Priority of the ProtocolLib listener (requires restart)
  # Possible values: lowest, low, normal, high, highest
  listener-priority: highest

# Filter strings out of item names and lore
filter:
  # Strings are compared case-insensitive
  # r= prefix indicates that the string should be handled as a regex
  list:
  - "faggot"
  - "r=f.ck"
  # Replace with the following string.
  # If the string is only one character long it will fill up the word's length with it
  replace: "*****"

# Block certain items from getting shown.
# Can be bypassed with showitem.blockbypass and showitem.blockbypass.<blockname>
block:
  # Whether or not this match is inverted (match only items that don't match the values)
  inverted: false
  
  # List of materials to block
  # Materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
  material: []
  # - STONE
  # - DIAMOND_SWORD

  # Block items with certain strings in their names from getting shown (case-insensitive)
  # r= prefix indicates that the string should be handled as a regex
  name: []
  # - "name 1"
  # - "r=name \\d"

  # Block items with certain strings in the lore from getting shown (case-insensitive)
  # r= prefix indicates that the string should be handled as a regex
  lore: []
  # - "name 1"
  # - "r=name \\d"

  # Item durability value, can use comparators, <x, >x, =x, !=x or just equal a single number
  # An empty string matches all durabilities
  # Also supports chaining of comparators with a comma. E.g. >5,<20 for between 5 and 20
  durability: ""

  # Block items with the unbreakable tag
  unbreakable: false

  # Block items with certain enchantments, can block both all or only certain levels
  # Names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html
  # Can take the same comparators as the durability for the level
  enchantments: []
  # - "DAMAGE_ALL"
  # - "ARROW_DAMAGE:>2"

  # Serialize the item to YAML and filter it with regex.
  # This is only for advanced users and is less efficient, leave empty to disable.
  serialized: ""

  specific:
    # Block only specific items that match certain block types. All global types can be used.
    # Can by bypassed with showitem.blockbypass.specific.<name> e.g. showitem.blockbypass.specific.special-sword
    special-sword:
      material:
      - DIAMOND_SWORD
      name:
      - "Phoenix616's Sword"
      unbreakable: true
      enchantments:
      - "DAMAGE_ALL:>9000"
    # Add multiple matcher, e.g. an inverted matcher that
    # blocks everything that isn't in this matcher
    # inverted-match:
    #   inverted: true
    #   material:
    #   - WRITTEN_BOOK

cooldowns:
# Cooldowns for the radius and the direct show command in seconds.
# 0 to disable cooldowns entirely.
# Exempt permission: showitem.cooldownexempt
  all: 300
  world: 60
  radius: 10
  direct: 0
  chat: 60

# Whether or not we should attempt to send the nickname instead of the username
# This will also include colors/prefixes of the team the player is in!
use-nick-name: true

lang.en.yml

no-permission: "&cYou don't have the permission %permission%"
count: "%count% "
item:
  # Title for the inventory that is shown when clicking the item in chat
  inventory-title: "Shown item:"
  # The different texts that display the item
  # Possible placeholders:
  # %icon%    - will only be displayed when texticonrp is set to true
  # %count%   - will be replaced with lang.count if more than 1 item is shown
  # %color%   - the item name color based on its enchantments
  # %name%    - the item's display name with color codes
  # %rawname% - the item's display name without color codes
  # %type%    - the name of the item's type (based on client translations)
  # The string will be automatically colored but it tries to respect custom codes
  unnamed: "%count%%color%\\[%icon%%color%%type%%color%\\]"
  named: "%count%%color%\\[%icon%%color%%name%%color%\\]"
  none: "\\[None\\]"
  unknown: "&cUnknown Item"
  # Add custom formatting for special item display names
  # Works with or without formatting/color codes in the key
  custom:
    "your custom displayname": "%count%&6\\[%icon%%color%Custom Display Name&6\\]"
# The %type% variable is also usable in the named string for example like this:
#   named: "%icon%%type% &anamed %name%
slot:
  numbered: " from slot %slot%"
  hand: ""
all:
  self: "&aYou show %item%%slot%&a to everyone!"
  target: "%player% &ashows everyone %item%%slot%!"
world:
  self: "&aYou show %item%%slot%&a to everyone in your world!"
  target: "%player% &ashows %item%%slot%&a to everyone in his world!"
radius:
  self: "&aYou hold up %item%%slot%!%customradius%"
  custom: "&8(View distance: %radius%&8 blocks)"
  target: "%player%&a holds up %item%%slot%!"
player:
  self: "&aYou show %player% %item%%slot%"
  target: "%player% &ashows you %item%%slot%"
inv:
  chat: "&a\\[%player%'s Inventory\\]"
  title: "&r%player%'s Inventory"
  hover: "&5Click to view the inventory of &e%player%"
  inventory-not-viewable: "&cThat inventory is not viewable!"
  all:
    self: "&aYou show your inventory to everyone!"
    target: "&a%player% &ashows everyone his inventory!"
  world:
    self: "&aYou show your inventory to everyone in your world!"
    target: "&a%player% &ashows his inventory to everyone in his world!"
  radius:
    self: "&aYou show your inventory to everyone around you!%customradius%"
    custom: "&8(View distance: %radius%&8 blocks)"
    target: "%player%&a shows his inventory!"
  player:
    self: "&aYou show %target%&a your inventory. (Click)"
    target: "%player%&a shows you his inventory. (Click)"
ender:
  chat: "&a\\[%player%'s Enderchest\\]"
  title: "&r%player%'s Enderchest"
  hover: "&5Click to view the Enderchest of &e%player%"
  inventory-not-viewable: "&cThat Enderchest is not viewable!"
  all:
    self: "&aYou show your Enderchest to everyone!"
    target: "%player%&a shows everyone his Enderchest!"
  world:
    self: "&aYou show your Enderchest to everyone in your world!"
    target: "%player%&a shows his Enderchest to everyone in his world!"
  radius:
    self: "&aYou show your Enderchest to everyone around you!%customradius%"
    custom: "&8(View distance: %radius%&8 blocks)"
    target: "%player%&a shows his Enderchest!"
  player:
    self: "&aYou show %target%&a your Enderchest. (Click)"
    target: "%player%&a shows you his Enderchest. (Click)"
help:
  item-info: "&eOptions for showing %item%&e from slot %slot%:"
  suggest-hover: "&9Click to insert &f%insert%&9 into input"
  chat: "&e> &aWrite &f%variable%&a into chat."
  player: "&e> &aShow a specific player: &f%command%"
  default: "&e> &aShow people in a %radius% block radius: &f%command%"
  radius: "&e> &aShow people in a custom radius: &f%command%"
  world: "&e> &aShow to everyone in your world: &f%command%"
  all: "&e> &aShow every online player: &f%command%"
error:
  no-item: "&cYou don't have an item to show in that slot. :("
  item-no-longer-cached: "&cThis item is no longer cached and can't be viewed anymore!"
  invalid-slot: "&e%input% &cis not a valid slot!"
  radius-too-small: "&cError: Your input %input% is too small!"
  radius-not-integer: "&cError: Your input %input% is not a valid integer!"
  missing-radius: "&cError: Please input a number after the radius argument!"
  item-blocked: "&cYou are not allowed to show this item! (Blocked by %definition%&c)"
  player-offline: "&cThe player %player%&c is not online"
  noone-around: "&cThere are no players around which you could show it to :("
  cooldown: "&cYou have to wait %remaining%&c more seconds before showing another item!"

permissions.yml

permissions:
   showitem.chat:
      description: Gives permission to use the chat variable
      default: true
      children:
         showitem.command.itemexecutor: true
   showitem.chat.slot:
      description: Gives permission to use the chat variable with a slot
      default: true
      children:
         showitem.command.slotexecutor: true
   showitem.chat.inv:
      description: Gives permission to use the inventory chat variable
      default: op
      children:
        showitem.command.invexecutor: true
   showitem.chat.ender:
      description: Gives permission to use the enderchest chat variable
      default: op
      children:
        showitem.command.enderexecutor: true
   showitem.chat.spam:
      description: Gives permission to bypass the spawm protection
      default: op
   showitem.command:
      description: Gives permission to the plugin command
      default: true
      children:
         showitem.command.itemexecutor: true
   showitem.command.itemexecutor:
      description: Gives permission to run the showitem command executor
      default: false
      children:
         showitem.command.itemexecutor.viewgui: true
   showitem.command.itemexecutor.viewgui:
      description: Gives permission to open the item GUI with the showitem command executor
      default: false
   showitem.command.slot:
      description: Gives permission to show an item in a slot
      default: true
      children:
         showitem.command.slotexecutor: true
   showitem.command.slotexecutor:
      description: Gives permission to run the showslot command executor
      default: false
      children:
         showitem.command.slotexecutor.viewgui: true
   showitem.command.slotexecutor.viewgui:
      description: Gives permission to open the item GUI with the showslot command executor
      default: false
   showitem.command.inv:
      description: Gives permission to show the whole inventory
      default: op
      children:
         showitem.command.invexecutor: true
   showitem.command.invexecutor:
      description: Gives permission to run the showinv command executor
      default: false
   showitem.command.ender:
      description: Gives permission to show the enderchest
      default: op
      children:
         showitem.command.enderexecutor: true
   showitem.command.enderexecutor:
      description: Gives permission to run the showender command executor
      default: false
   showitem.command.player:
      description: Gives permission to show an item to a specific player wherever he is
      default: true
   showitem.command.radius:
      description: Gives permission to show an item in a radius you give
      default: op
   showitem.command.world:
      description: Gives permission to show an item to all players in his current world
      default: op
   showitem.command.all:
      description: Gives permission to show an item to all online players
      default: op
   showitem.command.reload:
      description: Gives permission to use the reload command
      default: op
   showitem.command.debug:
      description: Gives permission to use the debug command
      default: op
   showitem.helpclick:
      description: Gives permission to use the help click functionality in the inventory
      default: true
   showitem.rightclick.viewinv:
      description: Gives permission to right click a player to view their inventory
      default: false
   showitem.cooldownexempt:
      description: Gives permission to bypass the command cooldowns
      default: op
   showitem.blockbypass:
      description: Gives permission to bypass all item blocks
      default: op

ShowItem information.md

This gist contains information about the config and permissions of the ShowItem spigot plugin.