✨ 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
