💡 Glowing Furniture

danger

Unless you know exactly what you're doing, we do not recommend using this feature, as it is highly likely to leave light blocks lingering in the world. This can cause issues such as water flow being blocked, the light blocks being washed away by water, or the emitted light failing to prevent monster spawning because it might not be treated as a real server-side light-emitting. If you need glowing furniture, please consider 🫑 Block Entity Renderer instead of this feature. Additionally, if you are certain you do not need this feature, please disable furniture.light-system.enable in the plugin’s config.yml to conserve server resources.

Glowing Furniture makes furniture emit light by placing minecraft:light blocks at configured positions relative to the furniture origin. The light blocks appear on placement, move with the furniture, and vanish on break.

danger

This behavior requires furniture.light-system.enable: true in config.yml.

config.yml

furniture:
  light-system:
    enable: true

Uniform Lighting (All Variants)

When every variant should emit light at the same positions, use the lights key:

furniture:
  default:candelabrum:
    behavior:
      type: glowing_furniture
      lights:
        - position: 0,0,0
          level: 15                         # light level: 1~15 (default 15)
      # shorthand also works:
      # lights:
      #   - "0,0,0 15"                     # "x,y,z level"
      #   - "0,0,0"                         # level defaults to 15

Per-Variant Lighting

When each variant needs different light positions or levels, use the variants map. The keys must match the furniture variant names:

furniture:
  default:candelabrum:
    behavior:
      type: glowing_furniture
      variants:
        ground_lit:
          - "0,0,0 15"                      # light for the "ground_lit" variant
        wall_lit:
          - "0,0,0.3 15"                    # light for the "wall_lit" variant
        ceiling_lit:
          - "0,-1,0 15"                     # light for the "ceiling_lit" variant

Combining with events

A common pattern is using set_furniture_variant to toggle lit/unlit states — right-click with flint and steel to light, left-click barehanded to extinguish. See the default candelabrum config for a complete example.