LightColor

Hover over an object that gives off light (e.g., sconce, campfire, portal) and press L to enter a color for its light, brightness, and range. It makes the text on signs glow with a colored halo, lit letters or an outline.

• Type a color name like red, yellow, or purple, or a hex color like #0F0 or #002B49
• Add a brightness and range after the color, like blue 150% 20m - see Brightness and Range
• Works on item stands too - the color applies to the mounted Dverger circlet, torch or anything else that glows, and the color stays with the stand when you swap the item
• Traveling through a colored portal turns the swirl on the loading screen to the portal's color, then fades it ring by ring from the center outward to the color of the portal you arrive at
• Works on signs too - the text glows in the color so it's easy to read, even at night - see Signs
• Set the Helmet setting to color the Dverger circlet you're wearing - see Configuration
• Type default or blank to go revert to the original color
• The hover text shows the key on every object it works with
• Respects wards - you can't change lights inside a ward you don't have access to
• Servers can let only their admins change colors - see Admin Only

Multiplayer Servers

An object's color / brightness / range is stored on the object and saved with the world. The server does not need this mod installed in order to save the color.

Colors are shared with everyone who uses this mod, and changes are seen by all players.

The Helmet setting is copied to your character; other players with this mod see your Dverger circlet in the color you set.

Admin Only

To let only admins change colors, install the mod on the server and set AdminOnly = true in the server's BepInEx\config\kriona.LightColor.cfg. Admins are the players listed in the server's adminlist.txt. Other players don't see the key in the hover text, and pressing it tells them only admins can change colors. The change takes effect as soon as the file is saved, for players already connected too.

When a player hosts the world from their game instead of a dedicated server, the setting comes from the host's config file, and the host can always change colors. A player's own AdminOnly setting does nothing on someone else's server.

To let only admins use the Helmet setting as well, set AdminOnlyHelmet = true the same way. Other players' circlets keep their own light, and they're told once that only admins can use the setting. The two settings work separately, so you can turn on either one or both.

The check happens in each player's game, so it keeps honest players from changing colors but can't stop someone running a modified copy of the mod.

Screenshots

A mounted purple Dverger circlet

Blue campfires and sconce

Cosplaying as Cyclops from the X-Men

The Helmet setting set to #F00 500% 50m.

Portal hub with multiple colors

Going from a yellow portal to a blue portal (mid-transition)

Color Brightness

The game treats black as "no light". If you set an object's color to black, it does not emit light. #111 (dark gray) emits very little light, while #FFF (white) emits a lot of light.

The left portal is set to #0F0 (bright green) while the right portal is set to #010 (dark green).

Brightness and Range

Add a brightness ending in % or a range ending in m after the color. Both are optional, and work without a color too:

• blue 150% - blue, and one and a half times as bright
• blue 150% 20m - blue, brighter, and lights up 20 meters around it
• 50% - the object's original color at half brightness
• 0% - turns the light off, while the flame or glow stays

Brightness can be from 0% to 500%, and range from 1m to 50m. The range sets the size of the object's largest light, and its other lights are scaled to match, so a fire that runs low on fuel still shrinks. Flames and glowing parts only change color - their size stays the same.

Bigger lights light up more of the world around them, which costs more performance when there are a lot of them.

A campfire set to 500% brightness and a 50m range.

Signs

Hover over a sign and press L to make its text glow. Type a color, a brightness, and any of these styles:

• halo - a soft glow in the color behind the letters
• lit - the letters are drawn in the color and lit from within
• outline - a crisp edge in the color around the letters

white gives a white halo, lit white letters, and yellow 200% halo outline a bright yellow halo and outline. Default style is halo, and default color is white. High brightness values quickly become glowing orbs of light instead of text.

Glowing text isn't shaded by the light around it, so it reads the same by day and night. Colors typed into the sign's text with <color=...> still show (though lit might wash them out).

Default Colors

default or blank reverts an object to its original color. Fires that burn low when they run out of fuel switch to a smaller, dimmer light. Objects with more than one light have one of each color listed - the color you type is used for all of them.

Typing one of these colors instead of default or blank gets you the same light, but the flame comes out paler than the original.

Configuration

BepInEx\config\kriona.LightColor.cfg is created on first run, and changes take effect as soon as the file is saved. You do not need to restart Valheim or rejoin the world.

• ColorKey - the key to press while looking at a light, optionally with modifiers, e.g. L or LeftControl + L (default L)
• Helmet - the color, brightness and range for the light on your equipped Dverger circlet. Seen by other players with this mod (default blank, which keeps the circlet's own light)
• AdminOnly - on a server, or in the game of the player hosting the world, lets only admins change colors - see Admin Only (default false)
• AdminOnlyHelmet - on a server, or in the game of the player hosting the world, lets only admins use the Helmet setting - see Admin Only (default false)

Installation

With a mod manager, install Light Color from Thunderstore using r2modman or the Thunderstore Mod Manager (which install BepInExPack for Valheim), or from Nexus Mods using Vortex.

By hand:

1. Install BepInExPack for Valheim from Thunderstore or Nexus Mods
2. Extract the zip into your Valheim folder, or copy LightColor.dll into BepInEx\plugins

Client-side - the server only needs it to let only admins change colors. Other players only need it to see the colors.

Other Mods By Me

See all my mods on Thunderstore.

Source

The source code is on GitHub.