Lux Comapnion

✨ LuxCompanion
A living light that follows you everywhere.

Never walk in the dark alone. LuxCompanion gives you a personal, glowing companion that trails you through the world — lighting your path, reacting to your every move, and looking exactly how you want it to. Pick an archetype, dial in a color, and carry a light source with personality. It’s fully client-side, so you can enjoy it on any server without asking an admin for anything.

🌟 Meet the companions
Seven built-in archetypes, each with its own idle animation and character:

Floating — hover beside you with lifelike, physics-driven motion:

The Fairy — a small, glowing fairy

The Drone — a floating mechanical drone

The Wisp — wandering wisp, slowly spinning as it hovers

The Swarm — a tiny cluster of glowing motes drifting together

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

The Lantern — a lantern carried on your back

The Beacon — a back-mounted scanner

The Bulb — a glowing bulb perched on your head

🔦 A real light source
Companions emit dynamic light (powered by LambDynamicLights), so yours genuinely illuminates caves, ravines, and late-night builds. Optional automation keeps it effortless:

🎨 The Companion Workbench
Press O to open the Workbench and make your companion yours:

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
Float beside the player or ride worn on the back
Jiggle 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