Item Flex

# 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 <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/se-l9HxaWlA" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> --- ## 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 <details> <summary>View Default Configuration</summary> ```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 u