File information

Last updated

Original upload

Created by

RedRoryOTheGlen

Uploaded by

RedRoryOTheGlen

Virus scan

Safe to use

Tags for this mod

About this mod

Auto-extinguish lights (except lanterns) when you don't have a hand free to hold them. Optional "drop light" mechanics as well as first-person graphics when using torches. Android version available.

Permissions and credits
Changelogs
SHOWCASE VIDEO

I was a bit annoyed how light sources currently just lit everything evenly from the player's POV and I really wanted to emphasize DFU's already excellent lighting and shadows so I started with making Item-Based Lighting less of a set-and-forget kind of thing with the Free Hand Requirement. Then it just snowballed into this. Funny how that works.

FEATURES
  • Free hand requirement for light source
  • Droppable light sources
  • First-person torch graphics
---

FREE HAND REQUIREMENT
  • Handheld light sources like Torches, Candles and Holy Candles require a free hand to be used.
  • If there is no free hand, the light source will be either stowed or dropped (configurable in Mod Settings)
  • If a light source was stowed, it will be automatically re-equipped when a hand becomes free once again.
  • Trying to equip a light source without a free hand is disallowed.
  • With melee weapons and unarmed, the hands they are equipped in are occupied when unsheathed.
  • With two-handed melee weapons, the off-hand will only be occupied when attacking with the weapon.
  • Shields and bows will always occupy the hand they're equipped in, even when sheathed.
  • OPTIONAL: Spellcasting (readying or casting a spell) will occupy both hands for the duration of the cast. Toggle through Mod Settings.
  • OPTIONAL: Climbing will occupy both hands. Toggle through Mod Settings.
  • OPTIONAL: Swimming will occupy both hands. Toggle through Mod Settings.
DROPPABLE LIGHT SOURCES
  • When an equipped light source is forcibly stowed, it will be dropped onto the ground in front of the player instead.
  • Dropped light sources will continue to shed light.
  • Their condition will also continue to decay as normal and during Resting and Loitering.
  • They can be picked up by interacting with them in either GRAB or STEAL mode.
  • Picking up a dropped light source with a hand free and without a light source equipped automatically equips it. Otherwise, it is just sent to your inventory.
  • Light sources can be dropped manually with a bindable input (DEFAULT: TAB). You must have a free hand to drop light sources this way. See Unity KeyCodes for a list of usable key codes to bind.
  • If a light source is dropped into water, it will be doused and not shed light. Thanks to Ralzar for allowing me to use these doused Candle and Holy Candle sprites from Darker Dungeons.
FIRST-PERSON GRAPHICS
  • Have a visible torch out front with a burning SFX loop on when you have a Torch equipped
  • Only works for Torches (May change in the future)
  • Freely configure the sprite's offset and scale in the Mod Settings.
  • OPTIONAL: Ambidexterity setting mirrors the graphic depending on which hand is free (eg, if carrying a shield or bow in your left, your torch will be held in your right hand instead)
  • OPTIONAL: Bob and Inertia modules for more dynamic sprite behavior
---

ANDROID VERSION
  • Made for use specifically with Vwing's DFU port. I can't guarantee it will work with different forks or projects. Refer to the github for instructions on installing mods.
  • My access to Android devices is limited, so I'd appreciate any feedback regarding the mod working on other devices. As with the previous point, I can't guarantee it will work perfectly with every device, but with your help, I will try my best to figure out whether it's in my capability to fix.
  • Many thanks to Vwing for their work on porting DFU to Android as well as being extra mindful of modding support.
---

MOD COMPATIBILITY
  • May not play nice with custom weapon mods like Future Shock Weapons or Crossbow mod. It won't detect those weapons as occupying hands and other similar problems.

RECOMMENDED MODS
  • Darker Dungeons by Ralzar, if only for the feature that lets you grab torches off the walls with STEAL mode, but the whole package just elevates the dungeon diving experience!
  • Improved Interior Lighting by ShortBeard to kick the atmosphere up by a few notches.
  • First-Person-Lighting by DunnyOfPenwick to stop the FP sprites from ruining your night vision!
  • HUD Torch Indicator by AverniteDF, lets you quickly toggle your lightsource or cycle between light source types as well as an auto-extinguish feature when exiting into daylight
---

KNOWN ISSUES
  • The Ambidexterity toggle for the first-person graphics was made for compatibility with Shield Widget and an unreleased mod of mine. If you wield the weapon (or unarmed strike) in your left hand while your right hand is free without that unreleased mod, the sprite will overlap your main weapon. Just sit tight until that mod releases, I guess, or don't do that edge-case that causes it. lol.

Thanks to Ralzar and Magicono43 for making their mods' source available for study and for being extremely helpful with my questions on the DFU Lysandus' Tomb discord server, doubly so for Ralzar who allowed the use of assets from Darker Dungeons. And special mention to thenameisthegame for continuously breaking the work-in-progress with shenanigans as well as reminding me that DFU lets you change the time-scale.