DynLight

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper purpur

标签： equipment game-mechanics magic

A dynamic entity-based lighting plugin, which allows for integrations with other plugins.

Held items, dropped items, burning mobs, and other entities glow. Fully configurable, and other plugins can use the API or scoreboard tags to define their own custom glowing entities.

Features

Light Sources

• Held Items - Torches, lanterns, glowstone, and 40+ other items emit light when held
• Dropped Items - Items on the ground emit their light level
• Burning Entities - Any entity on fire glows with configurable intensity
• Flaming Projectiles - Arrows on fire, fireballs, and spectral arrows emit light
• Enchanted Equipment - Players wearing enchanted armor or holding enchanted items emit a subtle glow
• Always-Lit Entities - Blazes, Glow Squids, Magma Cubes, and Allays always emit light
• Scoreboard Tag Lights - Any entity with a dynlight:<level> scoreboard tag emits light, enabling cross-plugin integration without compile-time dependencies

Special Mechanics

• Water Sensitivity - Fire-based items (torches, campfires) are extinguished underwater while waterproof items (glowstone, sea lanterns) continue to glow
• Client-side only - Light blocks are packet based, and don't modify the world. Inspired by DynamicLights
• Per-Player Toggle - Players can individually enable/disable dynamic lights client side
• Async Rendering - Light calculations run asynchronously for minimal server impact

Configuration

Performance settings:

# Update interval in ticks (20 ticks = 1 second)
# smaller values = more frequent updates = smoother light movement but higher CPU usage
update-interval: 1

# Maximum distance to render dynamic lights (blocks)
render-distance: 96

# How often to check for fire expiration on entities (ticks, 10 = 0.5 seconds)
fire-sweep-interval: 10

Enable or disable specific light source types:

detection:
  held-items: true
  dropped-items: true
  burning-entities: true
  flaming-arrows: true
  enchanted-armor: true
  enchanted-items: true
  always-lit-entities: true
  tagged-entities: true

Configure light intensity for enchanted equipment:

light-levels:
  enchanted-armor: 3
  enchanted-items: 3

Configure how items emit light:

items:
  TORCH:
    light: 10
    water-sensitive: true
  LANTERN:
    light: 12
    water-sensitive: false

Water-sensitive items stop emitting light when submerged.

Configure how entities emit light when on fire:

entities:
  # Properties: base-light, fire-light, horizontal-radius, height
  BLAZE:
    base-light: 8    # Always emits light
    fire-light: 15

The light column will once place one light block -- we search wider than you'd think to avoid obstacles, since light blocks can't be placed inside things like vines, tall grass, ladders, etc.

Commands

Scoreboard Tag Lights

Any entity with a scoreboard tag matching dynlight:<level> will emit light. No API dependency required — just add the tag via commands or another plugin.

Format: dynlight:<level> or dynlight:<level>:<radius>:<height>

Examples:

/summon armor_stand ~ ~ ~ {Tags:["dynlight:15"]}
/summon armor_stand ~ ~ ~ {Tags:["dynlight:10:3:5"]}

Note: the /tag command does not support colons in tag names — use NBT Tags when summoning, or add tags programmatically from another plugin.