Item Flex

Item Flex is a plugin that gives players the ability to showcase their held item with a modern holographic display. With over 60 configuration options, you're able to tailor the plugin to your servers needs!

---

📸 Showcase

---

Features

• /itemflex command to display your held item
• Animated hologram made with display entities for zero lag.
• PlaceholderAPI & Hex Color Support
• Works with items from plugins like Nexo and ItemsAdder
• Fully customizable with over 60+ configuration options
• Internal placeholders like %item_lore% and %item_enchants% for displaying complex item data.
• Built-in cooldown system for limiting spam

---

Default Configuration

View Default Configuration

Settings:
  # Configuration for plugin permissions and cooldowns.
  Permissions:
    # If true, permission nodes will be enforced across the plugin.
    # If false, only server operators (OPs) can use /itemflex reload,
    # and all players will be subject to cooldowns.
    Enabled: true

    # Permission node required to use the /itemflex command.
    Use: "itemflex.use"

    # Permission node that allows a player to bypass the usage cooldown.
    Bypass-Cooldown: "itemflex.cooldownbypass"

    # Permission node required to execute /itemflex reload.
    Reload: "itemflex.reload"

  # Cooldown duration between uses of the /itemflex command.
  # Supports flexible time formats, e.g.:
  #   "1m" = 1 minute
  #   "2h 30m" = 2 hours and 30 minutes
  Use-Cooldown: "1m"

  # Maximum number of lore lines shown from the %item_lore% placeholder.
  # If the item has more lore lines than this value, the rest will be skipped.
  # Set to 0 to disable lore entirely.
  Lore-Line-Limit: 3

  # Whether to skip empty lines when displaying %item_lore%.
  # A line is considered empty if it contains no visible characters,
  # including lines that only contain color codes or formatting.
  Ignore-Empty-Lore-Lines: true

  # Vertical spacing between each hologram line.
  # This controls how far apart the lines appear above the item.
  Line-Spacing: 0.17

  # Text lines displayed above the item hologram.
  # Supports PlaceholderAPI placeholders, and internal such as
  #   %item_name% — The display name of the held item.
  #   %item_lore% — Each line of the item's lore (one hologram line per lore line).
  #
  # ⚠️ NOTE: %item_lore% can produce many lines if the item has a long lore.
  # You can limit this by adjusting the Lore-Line-Limit setting.
  Lines:
    - "&6&lFLEXING"
    - "%item_name%"

  # The format of each enchantment line when %item_enchants% is used.
  Enchant-Format: "&6%enchantment_name% &f%enchantment_level%"

  Spawn-Location:
    # Distance from the player's **eye location** where the hologram spawns.
    Distance: 1.5

    # Offset added to the base spawn location.
    # Useful for raising or shifting the hologram position.
    Offset:
      X: 0
      Y: 1.5
      Z: 0

    # Offset specifically for the item inside the hologram.
    # Should usually match the above offset for best alignment.
    Item-Offset:
      X: 0
      Y: -0.17
      Z: 0

  # How the item is displayed (e.g. NONE, FIXED, GUI).
  # See: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/ItemDisplay.ItemDisplayTransform.html
  Display-Transform: GUI

  # Scale of displayed items (if the item is NOT a block).
  Item-Display-Scale: 0.75

  # Scale of displayed items (if the item IS a block).
  Block-Display-Scale: 0.5

  # How the hologram text faces the viewer.
  # See: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/Display.Billboard.html
  Billboard-Type: "VERTICAL"

  # Background color and opacity of the hologram text.
  # All values are 0–255. Use Opacity: 0 for no background.
  Background-Color:
    Opacity: 0
    Red: 0
    Green: 0
    Blue: 0

  # Brightness of the text lines in the hologram.
  # 0–15, where 15 is the brightest.
  Brightness:
    Block: 15
    Sky: 15

  # If true, text lines will render with a shadow for better readability and visual depth.
  Text-Shadow: true

  # Particle effect played when the animation starts.
  Spawn-Particle:
    # Type of particle.
    # See: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
    Particle: "GLOW"
    Count: 20
    Offset:
      X: 0.1
      Y: 0.2
      Z: 0.1
    Speed: 0.01

  # Sound played when the animation starts.
  Spawn-Sound:
    # See: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
    Sound: "ENTITY_EVOKER_CAST_SPELL"
    Volume: 1.2
    Pitch: 1.5

  # Controls the scale animation (in and out).
  Scale-Settings:
    # Initial scale of the item.
    Starting-Scale: 0.01
    # Amount the item scales up/down per tick.
    Scale-Increment: 0.06

  # Speed of item rotation (in degrees per tick).
  Rotate-Speed: 7

  # Duration of the animation, in ticks (20 ticks = 1 second).
  Animation-Duration: 80

  # Particle effect played when the animation ends.
  Disappear-Particle:
    Particle: "FIREWORK"
    Count: 15
    Offset:
      X: 0.2
      Y: 0.2
      Z: 0.2
    Speed: 0.05

  # Sound played when the animation ends.
  Disappear-Sound:
    Sound: "BLOCK_AMETHYST_BLOCK_BREAK"
    Volume: 0.8
    Pitch: 1.7

  # Ambient particles shown during the animation.
  Ambient-Particle:
    # How often (in ticks) to spawn particles.
    Frequency: 10
    Particle: "ENCHANT"
    Count: 3
    Offset:
      X: 0.1
      Y: 0.1
      Z: 0.1
    Speed: 0

  # Ambient sound played during the animation.
  Ambient-Sound:
    # How often (in ticks) to play this sound.
    Frequency: 20
    Sound: "BLOCK_BEACON_AMBIENT"
    Volume: 0.3
    Pitch: 1.2

# All plugin messages can be customized below.
# Supports PlaceholderAPI placeholders and Minecraft hex colors (e.g. #A020F0).
Messages:
  # Shown when a player lacks the required permission.
  No-Permission: "#FF5555You do not have permission to use this."

  # Shown when the player runs /itemflex without holding an item.
  Must-Hold-Item: "#FFA500You must be holding an item to flex it!"

  # Shown when the player runs /itemflex while already flexing an item.
  Flex-Active: "#FFA500You already have an item flex active!"

  # Shown when the player tries to flex while on cooldown.
  # Placeholders:
  #   %time% — Displays the remaining cooldown duration.
  Cooldown-Active: "#FFD700You're still on cooldown! Please wait #FF5555%time%#FFD700 before flexing again."

  # Shown when a non-player (e.g. console) tries to execute a player-only command.
  Player-Only: "#FF4444This command can only be used by players."

  # Shown when the plugin configuration is successfully reloaded.
  Config-Reloaded: "#55FF55✔ Configuration reloaded successfully."

---

Plugin Permissions

Node	Description
itemflex.use	Allows using /itemflex
itemflex.cooldownbypass	Skips the usage cooldown
itemflex.reload	Allows reloading the configuration

---

Dependencies

• Requires: Spigot/Paper 1.19.4+
• Optional: PlaceholderAPI for custom placeholders

---

Suggestions? Issues?

Reach out to me on Discord @BitByLogic or open an issue on GitHub for support and suggestions!