Custom Lantern

Latest tested version: Elden Ring 1.16.1

Tested with Elden Mod Loader

The mod (GUI and DLL versions) worked.



Is this mod compatible with the Shadow of the Erdtree DLC?

It should work, but I can't test, I don't have this DLC.





Changelog

- Custom Lantern (DLL) v1.2.2

Fixed incompatibility with other mods. If the DLL version still does not work, you could try with "Custom Lantern Patcher".

Injected DLL unload itself automatically.

- Added "Custom Lantern Patcher"

- Added "Custom Lantern Tester", an application to easily choose a light color for the lantern.

- Custom Lantern (DLL) v1.2.1

luminous_intensity, x_pos, y_pos, z_pos are deprecated, use intensity, x, y, z instead.

x_rot, y_rot and z_rot (rotation) are ignored.





Description

Custom Lantern (DLL) is the mod itself. You can configure the lantern light in `custom-lantern.ini`.

How to find the values for the file `custom-lantern.ini`? I suggest you to use Custom Lantern Tester (GUI tool) for this.

Instead of using the DLL version, you can use the CLI tool Custom Lantern Patcher (CLI) to write your lantern values directly to the file sfxbnd_commoneffects.ffxbnd.dcx. In this case, don't use Custom Lantern (DLL). Custom Lantern Patcher is an alternative to the DLL version. Also, DLL version (and the GUI tool Custom Lantern Tester) may not be compatible with mods that modify the lantern.





How to install

Custom Lantern (DLL)

1. Make a backup of your save.
   
   
2. Download and install Elden Mod Loader: https://www.nexusmods.com/eldenring/mods/117
   
   
3. Disable EAC with something like this: https://www.nexusmods.com/eldenring/mods/90
   
   This is a requirement for the loader "Elden Mod Loader".
   
   If Easy Anti-Cheat is not disabled, the game will crash on launch and you will get an Easy Anti-Cheat error.
   
   
4. Download "Custom Lantern (DLL)". Extract the archive content in "Elden Ring\Game\mods\".
   
   

Elden Ring/

├─ Games/

│  ├─ mods/

│  │  ├─ CustomLantern/

│  │  │  ├─ config.ini

│  │  │  ├─ custom-lantern.ini

│  │  ├─ CustomLantern.dll

│  ├─ mod_loader_config.ini

│  ├─ dinput8.dll

│  ├─ eldenring.exe

│  ├─ anti_cheat_toggler_config.ini

│  ├─ anti_cheat_toggler_mod_list.txt

│  ├─ mod_loader_config.ini

│  ├─ start_game_in_offline_mode.exe

│  ├─ steam_appid.txt

│  ├─ toggle_anti_cheat.exe

│  ├─ winhttp.dll

You can edit the values of the lantern light in the file custom-lantern.ini.

If you want to test values in real time without the need to restart the game, you can use the "Cheat Engine table" or the application "Custom Lantern Tester (GUI tool)".





Custom Lantern Tester (GUI)

How to use: https://youtu.be/t3psNSjGWJs





Custom Lantern Patcher (CLI) - obsolete

This tool is obsolete. It is better to use the DLL version. This tool will not be updated.

How to use: https://youtu.be/ACx25TNYabE





Requirements

Custom Lantern (DLL)

Elden Mod Loader ⇨ https://www.nexusmods.com/eldenring/mods/117

Custom Lantern (GUI tool)

.NET Desktop Runtime 6 ⇨ https://dotnet.microsoft.com/en-us/download/dotnet/6.0

Custom Lantern (CLI) - obsolete

.NET Runtime 7 ⇨ https://dotnet.microsoft.com/en-us/download/dotnet/7.0

Mod Engine 2





Known bugs and issues

• Custom Lantern (DLL) and Custom Lantern Tester (GUI tool) may not work if you use an another mod that modifies sfxbnd_commoneffects.ffxbnd.dcx; more specifically, if a mod modifies f000302421.fxr inside sfxbnd_commoneffects.ffxbnd.dcx. f000302421.fxr is the file for the lantern light effect. Nevertheless, you can use Custom Lantern Patcher to write your lantern values directly to the file sfxbnd_commoneffects.ffxbnd.dcx. In this case, don't use Custom Lantern (DLL).
  
  

FAQ



The game throws an error, crash at launch or the mod does not work

Check the log files for error messages.

The log files are "mods\CustomLantern\log.txt" and "mod_loader_log.txt" in "Elden Ring\Game\" directory.



Try to increase the value load_delay in CustomLantern\config.ini. The value is in milliseconds.

load_delay = 60000

You can also try to set an empty value on other keys.

start_address=

region_size=

protect=

type=

How to set my own values for the lantern light?

You can change the values of the light in the file custom-lantern.ini.

If you want to test values in real time without the need to restart the game, you can use the Cheat Engine table or the new application Custom Lantern Tester (GUI tool).



When I modify `position` (xyz), I don't see any change

When you modify position while the game is open, you need to re-equip the lantern to take effect.





Cheat Engine table

It can be used to test the the the light values in real time. But do NOT use it if the anti-cheat is enabled.

Requirements: Cheat Engine https://www.cheatengine.org/





Misc.



Game default values

color

|-red = 1

|-green = 0.6313726

|-blue = 0.36862746

|-alpha = 1

spec. color

|-red = 1

|-green = 0.6313726

|-blue = 0.36862746

|-alpha = 1

position

|-x = 0

|-y = 0

|-z = 0

rotation

|-x = 0

|-y = 0

|-z = 0

radius = 16

luminous intensity = 1.25

Mod default values

color

|-red = 1

|-green = 0.75

|-blue = 0.5

spec. color

|-red = 1

|-green = 0.75

|-blue = 0.5

position

|-x = 0.75

radius = 30

luminous intensity = 2.5

Source code

https://github.com/0-F/CustomLantern



Credits

Libraries

SoulsFormats (.NET library for reading and writing various FromSoftware file formats) - https://github.com/kotn3l/SoulsFormats

PixiEditor ColorPicker (WPF Color Picker) - https://github.com/PixiEditor/ColorPicker

ini-parser-netcore3.1 (C# library for manipulating INI files) - https://www.nuget.org/packages/ini-parser-netcore3.1

ProcessMemoryUtilities.Net - https://github.com/michel-pi/ProcessMemoryUtilities.Net

mINI (C++ library for manipulating INI files) - https://github.com/pulzed/mINI

Misc.

Elden Mod Loader - https://www.nexusmods.com/eldenring/mods/117

Souls Modding - http://soulsmodding.wikidot.com/