ItemHologram

!Banner

Modern Minecraft hologram plugin that displays item names and amounts above dropped items with RGB & HEX color support.

---

✨ Features

• 🌟 Floating item holograms
• 🎨 RGB & HEX color support
• 🔖 Placeholder support
• 🔧 Multi-version support (1.18 – 1.21.x)
• ⚡ Lightweight & optimized
• 📝 Custom hologram format
• 🌐 Bilingual — English 🇬🇧 & Indonesia 🇮🇩
• 🛠️ Easy configuration

---

📸 Preview

!Preview

Diamond Sword [ ×64 ]

---

📦 Supported Versions

Version	Status
1.17.x	❌
1.18.x	✅
1.19.x	✅
1.20.x	✅
1.21.x	✅

Supported Platforms: Spigot · Paper · Purpur

---

⚡ Installation

1. Download the plugin from the Releases page
2. Put the .jar into your server's plugins/ folder
3. Restart the server
4. Edit plugins/ItemHologram/config.yml
5. (Optional) Switch language: /ih lang id or /ih lang en

---

🛠️ Commands

Command	Description	Permission
/ih reload	Reload configuration	itemhologram.reload
/ih toggle	Enable / disable plugin	itemhologram.admin
/ih lang <en|id>	Switch language	itemhologram.admin
/ih info	Show plugin information	itemhologram.admin

Aliases: /ih · /ihologram

---

🔑 Permissions

Permission	Description	Default
itemhologram.use	View item holograms	true
itemhologram.reload	Reload plugin config	op
itemhologram.admin	Full admin access	op

---

⚙️ Configuration

# Active language: "en" = English | "id" = Indonesia
language: en

hologram:
  lines:
    - "&f%item_name% &7[&6x&e%amount%&7]"

  height-offset: 0.75
  billboard: true
  show-single: true
  single-line: "&f%item_name%"
  view-distance: 32

blacklist:
  - ARROW
  - EXPERIENCE_BOTTLE

enabled: true
update-interval: 4

---

🔖 Placeholders

Placeholder	Description
%item_name%	Item display name or material name
%amount%	Item stack amount
%material%	Raw material name
%rarity%	Rarity-based color code

---

🎨 RGB & HEX Colors

lines:
  - "&#FF55FF%item_name% &7[&#55FFFFx%amount%&7]"

Supports both &a color codes and full &#RRGGBB hex colors (Minecraft 1.16+).

---

🚀 Performance

• ⚡ Optimized entity handling
• 🪶 Minimal server impact
• 🔄 Smart hologram update cycle
• 🗑️ Auto-cleanup on item pickup & world unload

---

📋 Changelog

Spoiler

v1.2.0

• 🔄 Hologram format changed: [N×] → [×N]
• 🌐 Default language changed to English
• 🇮🇩 Added Bahasa Indonesia support
• 🐛 Fixed hex color parser (pure Java, no BungeeCord dependency)
• 🐛 Fixed setMarker() crash on 1.19 early builds
• 🐛 Removed deprecated PlayerPickupItemEvent

v1.0.0

• 🎉 Initial release

---

❤️ Author

Developed by PandaJav

Found a bug or have a suggestion? Open an Issue!