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:

<pre dir="ltr">FuelList = new() { { "game:candle", 8f }, { "game:fat-rendered", 9f } }</pre>

FuelList Format

&nbsp;

String

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

Double

• Amount of fuel provided in hours.

Fuel Capacity

<pre dir="ltr">Capacity = 24f</pre>

Maximum amount of fuel the light can store.

&nbsp;

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&nbsp;Vintage Story Light Wheel

&nbsp;

📄Mods

• ✅&nbsp;Can jewelry&nbsp; is now compatible and work. Fixed by Author