Item display entity

ItemDisplay

An ItemDisplay renders an item as a display entity in the world (1.19.4+). Unlike dropped items, display entities don't have physics, don't despawn, and can use billboard modes.

---

Constructor

ItemDisplay(location, item, billboard="FIXED")

Create and spawn an item display entity.

• Parameters:
• location (Location) — Spawn position.
• item (Item | str) — The item to display. If a string, interprets as a material name.
• billboard (str) — Billboard mode. Default "FIXED".

Billboard	Description
"FIXED"	No rotation (default)
"CENTER"	Always faces the player
"HORIZONTAL"	Only rotates horizontally
"VERTICAL"	Only rotates vertically

display = ItemDisplay(
    Location(100, 70, 200, "world"),
    Item("DIAMOND_SWORD", name="§bExcalibur"),
    billboard="CENTER"
)

---

Attributes

billboard

• Type: str

Current billboard mode.

---

Methods

teleport

display.teleport(location)

Move the display entity. This is synchronous.

• Parameters:
• location (Location) — New position.

remove

display.remove()

Despawn and destroy the display entity. This is synchronous.

---

Example: Floating reward indicator

from bridge import *

@command("Show reward")
async def reward(player: Player, args: list[str]):
    loc = player.location.add(0, 2, 0)
    display = ItemDisplay(loc, "NETHER_STAR", billboard="CENTER")
    await player.send_message("§e⭐ Reward available above you!")