HipLantern

Craft a little lantern and place it on your hip to cast away the darkness.

If you like darker nights you can also check CircletExtended and Firefly mods.

Must be installed on server in multiplayer. Configuration is synchronized with Conditional Config Sync.

EpicLoot integration supports both legacy releases and EpicLoot 0.13 or later.

Features

You can change some item and light properties:

• crafting station and recipe
• fuel usage and refuel recipe
• light color
• light intensity, range and shadows strength (indoors and outdoors)
• lantern hip position and rotation
• equip duration
• AzuEPI custom slot support
• lantern can be enchanted with EpicLoot or socketed with Jewelcrafting (disabled by default)

Item recipe is confurable: SurtlingCore x3, BronzeNails x10, FineWood x4.

Refuel recipe is configurable: SurtlingCore x1.

The Lantern takes its own equipment slot. That slot ID is configurable to avoid potential incompatibilities. You can also configure it to use the standard Utility item type. Utility mode is compatible with EquipmentAndQuickSlots 3.x, including its additional Utility slots.

The goal of the mod is to make fighting easier at dungeons or at night. Default light intensity is only good to barely see your enemy up close.

It serves the same purpose as the Hand Lantern in Bloodborne and Elden ring.

Lantern can be placed an item stands to provide light. At the night it will lure insects to create cozy effect.

Heat sound

The continuous heat sound plays only while an equipped lantern's heat mode is active. The Heat / Enable heat sound option is enabled by default. Heat sound volume and Heat sound pitch both default to 0.5; the allowed ranges are 0 to 1 for volume and 0.1 to 3 for pitch.

Switch sound volume controls the one-shot light/heat toggle sounds and defaults to 0.5. Toggle sounds are positional world sounds and are emitted once per actual lantern toggle. Switch effects are local audio instances synchronized by HipLantern, preventing the vanilla effect prefabs from being network-replicated a second time.

Changes apply without restarting or re-equipping the lantern; adjusting volume or pitch does not restart the playing loop. Disabling the sound does not change the heat aura, fuel consumption, or the separate Emit sound effects on switch setting. These settings use ConditionalConfigSync, so server policy determines whether clients control their own values. The heat loop is positional, fades with distance from other players, and follows the local client's Master and SFX volume settings.

Fuel and crafting presets

• Default settings - craft at forge, refuel(recraft) at hands, can't be repaired
• To make lantern repairable - clear Refuel recipe (if refuel crafting station is set - it will be used as repair station)
• Crafting station minimum level is also level required for repair (vanilla behaviour)
• To make fuel infinite - set Fuel minutes to 0
• Fuel is set in minutes to better displayed in tooltip
• All crafting and item settings is applied on the fly

Installation (manual)

Install Conditional Config Sync, then extract the HipLantern folder to your BepInEx\Plugins\ folder.

Configurating

The best way to handle configs is Configuration Manager.

Or Official BepInEx Configuration Manager.

Dependencies

• BepInExPack Valheim 5.4.2350
• ConditionalConfigSync 1.0.5

Install ConditionalConfigSync as a separate dependency; do not copy its DLLs into this mod's package.

Donation

Buy Me a Coffee

Discord

Join server

1.1.13

• Preserved HipLantern's off/heat icon variants against Valheim 1.0.17's new ItemDrop variant validation, preventing unwanted variant resets when dropped items are saved.
• Kept vanilla variant validation for other items and unsupported indices; the patch is skipped on game versions without this method.

1.1.12

• Fixed multiplayer switch sounds being duplicated by both HipLantern event synchronization and the vanilla ZNetView on candle/fire effect prefabs.
• Switch effect clones are now local-only while keeping the existing positional SFX mixer and volume handling.

1.1.11

• Fixed switch sounds replaying after teleport/loading.
• Limited each toggle action to one switch sound and made switch sounds positional.
• Added switch sound volume setting, default 0.5.

1.1.10

• Fixed multiplayer lantern audio so live remote-player sound instances use the local client's Master/SFX mixer and positional distance attenuation.
• Prevented light/heat switch effects from replaying when an already-active lantern visual is first created for a local or remote player.

1.1.9

• Made lantern and light/heat switch sounds follow the game's Master and SFX volume settings.
• Added the client-side Heat / Enable heat sound option, enabled by default and applied immediately without changing heat or switch effects.
• Added client-side Heat sound volume and Heat sound pitch settings, both defaulting to 0.5 and applied immediately without restarting the heat sound.

1.1.8

• Fixed light and heat toggle state synchronization when the lantern uses the Utility slot, including EquipmentAndQuickSlots utility slots.
• Unified lantern fuel drain, heat multiplier and switched-off auto-charge rules across the custom slot, vanilla Utility slot and additional utility slots provided by compatible equipment mods.
• Preserved equipped state when switching between the custom lantern slot and Utility mode at runtime.
• Made Jewelcrafting item-type compatibility exception-safe and verified its current 2.0.9 target methods.

1.1.7

• Checked lantern shortcuts before invoking player input/UI checks on idle updates.
• Removed iterator-based inventory scans when applying lantern data after loading.

1.1.6

• Updated for the Valheim 1.0.7 release.
• Updated required dependencies to BepInExPack Valheim 5.4.2350 and ConditionalConfigSync 1.0.5.
• Fix lantern detection on item stands using the new item prefab hashes.

1.1.5

• added explicit runtime compatibility branches for EpicLoot versions before 0.13 and EpicLoot 0.13+
• migrated configuration synchronization from ServerSync to Conditional Config Sync

1.1.4

• fixed lantern auto charge over maximum durability

1.1.3

• fixed durability drain of the switched-off lantern
• added new config Auto charge speed of the switched-off lantern

1.1.2

• fixed incompatibility issue with DragonRider

1.1.1

• light and heat switch hotkeys made not server synced
• light and heat switch keypress is now registered only when you control your character (not in chat, map, console and such)

1.1.0

• light and heat switch
• more and now editable localizations

1.0.24

• distinct light settings for itemstand variant

1.0.23

• custom slots for AzuEPI and ExtraSlots can now be dynamically enabled and disabled (this fixes the issue when slot is disabled on a client and enabled on a server)
• utility and custom type value can now also be changed without restart

1.0.22

• minor improvements

1.0.21

• fixed potential technical issue with finding item by itemdata

1.0.20

• enchantments from EpicLoot and sockets from Jewelcrafting will persist after refueling

1.0.19

• new config option to make Lantern socketable by Jewelcrafting
• new config option to make Lantern enchantable by EpicLoot

1.0.18

• patch 0.220.3
• ServerSync updated

1.0.17

• Lantern no longer drain fuel if crafting station is opened

1.0.16

• ExtraSlotsCustomSlots support

1.0.15

• fix for MMHOOK dependent mods generating warnings on ExtraSlots API initialization

1.0.14

• ExtraSlots API rework

1.0.13

• ExtraSlots API removed

1.0.12

• occasional NRE fix

1.0.11

• more precise position on horizontal stand
• correct vertical position on vertical stand

1.0.10

• minor light tweaks

1.0.9

• bog witch patch

1.0.8

• lantern can now be placed on a stand

1.0.7

• fix for rare equipment issue

1.0.6

• fix for non AzuEPI users

1.0.5

• AzuEPI custom slot support

1.0.4

• consistent light state for other players in multiplayer

1.0.3

• fix for lantern staying equipped after refueling recraft
• disabled recycle option on refuel recipe

1.0.2

• Ashlands refinements

1.0.1

• configurable equip duration

1.0.0

• Initial release