Blocks and furniture

How custom blocks and Nexo furniture are converted and shown to Bedrock players, how to check the furniture bridge, and the limits.

On this page

This page covers two kinds of placed content: custom blocks, which become real Bedrock blocks, and Nexo furniture, which is shown through a live bridge. You will learn what each needs, what Bedrock players see, and the current limits.

Custom blocks

Content plugins usually draw custom blocks by reusing a vanilla block with many states. NusaPack turns those into real Bedrock blocks.

Which blocks convert

Custom blocks from Nexo, Oraxen, ItemsAdder and CraftEngine convert when they are drawn through one of these vanilla bases:

  • note blocks
  • tripwire
  • chorus plants
  • mushroom blocks
  • leaves

Which base a block uses depends on how it is set up in its plugin. You do not need to change anything for NusaPack.

How blocks look on Bedrock

  • Each custom block is a real Bedrock block with its own model, rotation and textures.
  • Collision follows what the server simulates. A block built on a note block is solid; a plant built on tripwire is not.
  • Mining, placing and block rules stay on the server, handled by your content plugin.

Adding or removing custom blocks needs one server restart after the conversion, because Geyser registers blocks only when it starts. Changing only a block's texture or model needs a rejoin.

Furniture

Furniture in content plugins is usually an item display entity with a model, plus hidden barriers or seats. NusaPack shows the visual part to Bedrock players through its furniture bridge. The furniture still works on the server as before: collision, barriers, seats, storage, permissions and breaking are all handled by Nexo.

What furniture needs

  • Nexo furniture. Only furniture that Nexo owns is shown. Other item displays on your server are not touched.
  • ProtocolLib and Geyser-Spigot on the same server.
  • Minecraft 1.21.4. Furniture display is verified there. On other versions the furniture bridge switches itself off with a log message such as Furniture bridge disabled: ..., and everything else keeps working.
  • A converted pack that contains furniture models. The bridge starts with the server when all of this is in place, and the startup summary lists furniture under Bridges.

How furniture looks on Bedrock

  • The furniture model with its textures, including animated textures, placed, rotated and scaled as on Java.
  • The model follows what the server does: it appears when the furniture comes into view, and it is cleaned up when the furniture is removed, goes out of range, the player changes world or disconnects.
  • The visual model has no hitbox of its own. Players interact with the real furniture on the server, as Java players do.

Check the furniture bridge

/npb status and the nether star in the /npb panel show a Furniture group while the bridge runs:

RowMeaning
Furniture types / Bedrock viewersHow many furniture models the pack has, and how many Bedrock players the bridge serves
Shown nowHow many pieces of furniture are currently shown to Bedrock players
Frames sentHow many updates were sent, and how many were captured from the server
ProblemsRejected or oversized updates, and furniture the bridge cannot show; none when all is well

For the raw counters, run npb status in the console.

When changes show up

ChangeWhat Bedrock players need
A new texture or model for an existing block or furnitureA rejoin
A new or removed custom blockOne server restart
New furnitureFollow the last line of /npb convert

Known limits

  • Furniture from plugins other than Nexo is not shown on Bedrock.
  • Furniture display is only verified on Minecraft 1.21.4.
  • Furniture that turns to face the viewer (a billboard mode other than fixed) is not shown, and is counted under Problems.
  • Colour changes and model variants that switch while furniture is placed are not verified to match Java.
  • How seats and other interactions feel on a Bedrock client has not been verified on every device.

Next steps

Nusa product documentation · NusaPackPaper 1.21.x · Java 21

Loading the index…