SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedCosmetics, visuals & audio

A Wearable Light

by misterandydandy · for Vintage Story

A Wearable Light is your new best friend

135KDownloads
1.17.11Latest game version
Vintage Story ModDBSource

About A Wearable Light

From Vintage Story ModDB

A Wearable Light is your new best friend

💡 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

 

 Refueling
image

 

 

⚙️ 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

Highlights

From source data

Game versions

Supports 3 Vintage Story versions, the newest being 1.17.11.

Footprint

Rated a light load on a server.

A Wearable Light on Nxeon

From our catalogue
One-click install
Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

Run A Wearable Light on a Vintage Story server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Vintage Story ModDB as “Cosmetics”

Cosmetics, visuals & audio

Skins, textures, shaders, models and sound — how the game looks and sounds.

Runs on your server

From source side support

Vintage Story ModDB lists A Wearable Light as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Compatibility

Game
Vintage Story
Runs on
Serverrequired on the server
Game versions
1.17.11 and 2 earlier

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24
  • ✓Authormisterandydandy, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

A Wearable Light, answered

Generated from the mod’s own source data.

Do my players need to install A Wearable Light?

Vintage Story ModDB lists A Wearable Light as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. A Wearable Light is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run A Wearable Light on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add A Wearable Light in one click.