Skip to content

feat: Add collision support for display entities using invisible Shulker proxies #4

Description

@TheOne-Player

Use Case
Display entities are perfect for creating decorative visuals, but they currently have no physical collision. Shulker entities are the only Minecraft entity with a movable, solid collision box, making them ideal for enabling realistic interactions:

  • Themed structures: Create decorative walls, pillars, or platforms that players can actually walk on and collide with, without using solid blocks
  • Custom stairs/slopes: Build creative staircase designs or ramps using display entities for visuals while Shulkers provide the collision surface
  • Custom parkour: The parkour opportunities for this are endless.

Solution
Spawn invisible Shulker entities as collision proxies alongside display entities. The Shulker's bounding box serves as the physical collision surface while the display entity handles all visuals.

Technical Considerations

  • Shulker's bounding box should match the display entity's visual bounds
  • For displays with custom pitch/matrix transformations that rotate the model, voxelizing collision Shulkers (we can also use the scale attribute to scale them) can approximate the transformed shape as 1:1 replication in those cases can be impossible (at least as of Minecraft 26.2)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions