A Wearable Light

💡 A Wearable Light

 

Equipable light sources that provide both utility and style while exploring the world.
Designed to integrate seamlessly with gear slots for a more immersive experience.

Recommend Auto Config Lib  — install it to customize mod settings.

🧰 Available Equipment Slots

 

• Head
• Waist
• Backpack (currently disabled)

🪔 Current Item Types

 

Head

• Head Torch (doesn't need fuel)
• Head Oil Lamp
• Head Candle I
• Head Candle II
  
  

Waist

• Heavy Belt Brass Lantern
• Heavy Belt Copper Lantern
• Heavy Belt Iron Lantern
• Heavy Belt Tinbronze Lantern
• Heavy Belt Blackbronze Lantern
• Heavy Belt Bismuthbronze Lantern
• Heavy Belt Silver Lantern
• Heavy Belt Gold Lantern
  
  

Backpack

 

• Backpack Lantern (disabled for now)

✨ Key Features

🔦 Hotbar Light Control

Toggle your light on or off using a customizable keybind
Default: L
Works directly from the hotbar for quick access.

🎒 Gear Slot Light Control

Toggle equipped lights while hovering over them in your inventory
Default: Ctrl + L

⛽ Fuel System

Wearable lights now use a fuel system for more immersive gameplay.

• Lights must be refueled to operate
• Fuel is consumed over time while active
• Lights will automatically turn off when fuel is depleted
• When Crafted will automatically add fuel to the item.

🔥 Refueling (Quick Guide)

• Hold a valid fuel item (e.g. candle, fat)
• Left-click the light to refill

 

 

 

⚙️ Configurable Options

EnableSound (Client Side)

Enable or disable wearable light sound effects.

Default: true

RainExtinguish

Allows a light to be extinguished by rain when exposed to the sky.

Default: false

InLiquid

Allows a light to be extinguished when submerged in water or other liquids.

Default: false

OnCraftedFueled

Automatically fills a newly crafted light with fuel.

Default: false

🛠️ Custom Fuel Types

Each light can define its own valid fuel sources via config:

FuelList = new()
{
    { "game:candle", 8f },
    { "game:fat-rendered", 9f }
}

FuelList Format

 

String

• Item code used as fuel.
• Supports wildcards (*).

Double

• Amount of fuel provided in hours.

Fuel Capacity

Capacity = 24f

Maximum amount of fuel the light can store.

 

Light HSV

LightHsv = [1, 2, 3]

Controls the colour and brightness of the light emitted by the wearable light.

Format:
[Hue, Saturation, Value]

Example:
LightHsv = [0, 7, 16]

Notes:
- Hue controls the light colour.
- Saturation controls colour intensity.
- Value controls brightness.

See also Vintage Story Light Wheel

 

📄Mods

• ✅ Can jewelry  is now compatible and work. Fixed by Author
• ✅ Overhaul & Player Inventory, Custom Player Models, Player Model is working fine, Please make sure you are using up-to-date version.
• ❎ Careers not Classes set value of LightHsv to null. I have posted on there page. 

⚠️ Know issues 

• Please make sure your Dynamic light setting isn't too low before reporting that you can't see the light.

🔮 Planned Additions

• More wearable light types
• Adjustable brightness / shutters
• Solar-powered lights
• Particle effects and visual improvements
• Backpack slot rework