Lux Companion

LuxCompanion

A client side companion or prop that provides you with dynamic light

**
These are included by default:**

The Fairy

The Drone

The Wisp

The Swarm

Worn — rigidly attached, moving as one with your body:

The Lantern

The Beacon

The Bulb

Join my discord to request more companions: https://discord.gg/6rpRVkjqBV

A light source
Companions emit dynamic light (powered by LambDynamicLights), so they illuminates caves, ravines, and late-night builds

Press O to open the Workbench

Choose and customize companions:

Archetype selector — swap between all seven freely

Color matrices — full RGB tint with quick-pick presets

Behavior profile — Steady (calm and close), Orbit (circles you), or Agile (snappy and reactive) (w.i.p)

Transform sliders — fine-tune size, position (X/Y/Z), and rotation (X/Y/Z)

Press L anytime to toggle your companion’s light on or off.

🛠️ Bring your own companion
Creators can add fully custom companions — no coding required. Drop a folder into .minecraft/luxcompanion/companions/ with a GeckoLib model, texture, animation, and an optional glow mask:

my_dragon/
  companion.json          { "id": "my_dragon", "name": "My Dragon", "mount": "back" }
  model/my_dragon.geo.json
  textures/my_dragon.png
  textures/my_dragon_glowmask.png   (optional — the glowing parts)
  animations/my_dragon.animation.json

They can be set to Float beside the player or be worn as attached to the body.

Swing physics — name any bone …_physics and it sways naturally as you move, start, stop, and turn (great for hanging lanterns, ropes, charms)

Emissive glow masks, colorable with the same tint controls

Two ready-to-edit example companions are generated on first launch to learn from

👥 Multiplayer
Your companion is client-side and yours to see by default. (Currently working on server sync to see each others companions)

📦 Requirements

GeckoLib
LambDynamicLights