Item Flex icon

Item Flex -----

Item Flex is a highly customizable plugin that lets players show off their held item!



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 server's 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
Code (YAML):

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
Code (Text):
itemflex.use
Allows using /itemflex
Code (Text):
itemflex.cooldownbypass
Skips the usage cooldown
Code (Text):
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:
https://github.com/BitByLogics/ItemFlex/issues
Resource Information
Author:
----------
Total Downloads: 188
First Release: Jul 9, 2025
Last Update: Apr 18, 2026
Category: ---------------
All-Time Rating:
2 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings