Item Flex

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit paper purpur spigot

标签： social

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 ```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
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!