Lantern Engine help
Fixes for crashes, the right graphics settings for your PC, and how to send a report we can act on.
You need your own legal copy of Bloodborne. Lantern Engine contains no game files, and nobody here shares or links to them. Dump the game from your own PS4 and your own disc or purchase (see Is this legal?). Don't ask for game files in the Discord: the bot mutes it (see which words).
The game crashed
The graphics driver stopped responding: the GPU hung or lost the game's memory. It ran for 42 min.
Safe mode starts the next run with the experimental engine options and mods off. Copy report puts the details and the end of the log on the clipboard, for a bug report.
Nothing matches that. Try another word, or ask in the Discord.
Before you post a problem
Send the log. Without it nobody can tell what went wrong.
Copy the crash report
When the game crashes, the launcher shows The game crashed with a short reason. Press Copy report. The launcher says when it is on the clipboard.
Use safe mode starts the next run with mods and the experimental engine options off. If the game works in safe mode, one of those caused it.
Or export the log
No crash window? In the launcher open More › Log, then Export… Do it right after the problem, before you start the game again.
The last session's log is also saved as logs\last_session.log in the Lantern Engine folder.
Post it in #issues
One thread per problem in the #issues forum on the Discord. Attach the log as a file and say where you were and what you pressed.
For anything visual, add a short video or a screenshot, and say whether it also happens with mods off.
The game crashed
The graphics driver stopped responding: the GPU hung or lost the game's memory. It ran for 42 min.
Lantern Engine 0.9.37 GPU: NVIDIA GeForce RTX 3070 Ti Shaders: 4,812 pipelines ready Loading: begins Game started Device lost while waiting for a submission - the game exited (code 23) -
- Copy report
- Export the log
- Post it
The game crashed: copy the crash report
When the game crashes, the launcher shows The game crashed with a short reason. Press Copy report and paste it into your post. It has your version, GPU, driver, settings and the end of the log.
Use safe mode starts the next run with mods and the experimental engine options off. If the game works in safe mode, one of those caused it.
How do I copy or export my log?
In the launcher: More › Log, then Copy or Export… Do it right after the problem happens, before you start the game again.
The log of the last session is also saved as logs\last_session.log in the Lantern Engine folder.
What else to put in a report
- The log or crash report (above).
- What you were doing: where in the game, what you pressed, how long it ran.
- For anything visual (flicker, missing or stretched textures): a short video or a screenshot.
- Whether it also happens with mods off.
Post it in the #issues forum on the Discord, one thread per problem.
Why was my Discord message deleted, or why was I muted?
The Discord's bot deletes messages with these words and mutes the sender for 60 minutes, because they are how people ask for pirated game files.
- Anywhere in a message, even inside another word:
ebooteboot.bin - As a word on its own:
dumpdownloadgame fileshow to download filesromboot
- Say "game folder" or "my copy of the game" instead.
- "Download" counts too, even for the launcher: say "get it from the releases page".
- Send logs as a file, not pasted lines: More › Log › Export…, or Copy report after a crash (Discord turns a long paste into a file). Log lines contain some of these words.
Getting started
Lantern Engine runs your own copy of Bloodborne on a Windows or Linux PC.
Is this legal?
Lantern Engine is free, open-source software (GPL). It contains no game files: no Bloodborne data, no PS4 system files, nothing from Sony or FromSoftware. It is not affiliated with either of them.
To play, you need your own legal copy of Bloodborne, dumped from your own PS4 with your own disc or digital purchase, plus the 1.09 update. Downloading the game from the internet instead of dumping your own copy is piracy, and this project does not support it: nobody here shares or links to game files. Don't ask for them in the Discord.
What do I need?
- Your own legal copy of Bloodborne CUSA03173 with the 1.09 update, dumped and decrypted from your own PS4 (the folder with
eboot.binandsce_module). No game files come with Lantern Engine. - Windows 10 or 11, or Linux (Ubuntu 24.04 or newer, Arch, Fedora, SteamOS, Bazzite and similar).
- A Vulkan graphics card with a current driver. Players run it on NVIDIA GTX 10 series and newer, and AMD RX 400 series and newer.
- The game takes about 6 GB of memory (RAM plus page file), about 10 GB above 1080p. 16 GB of RAM is comfortable.
How do I install it and play?
- Get the latest package from Releases and unpack it somewhere you can write to (not
Program Files, not a OneDrive folder). - Open Lantern Engine.exe (on Linux: Lantern Engine).
- On the Play page, choose the game folder.
- Accept Settings for this PC when the launcher offers them. You can get them again later from Graphics › Best settings for this PC › Recommend…
- Press Play.
How do I update?
The launcher updates itself and the engine: Settings › Updates. Your settings, saves, mods and logs are kept. To get test builds early, see the Beta guide.
If the Play page shows Engine update available, press Update engine. Playing on an old engine means the crash fixes since then are missing.
On Linux the launcher updates itself too. Packages older than 0.9.37 beta 7 are updated by getting the new one from Releases.
Does it work on Linux?
Yes. Get the linux-x64.tar.gz package, unpack it, and open Lantern Engine, or run ./lantern.sh /path/to/CUSA03173 from a terminal. It runs natively on Wayland and X11.
DLSS Super Resolution works on Linux on RTX cards with NVIDIA's driver. DLSS Frame Generation is Windows only.
Graphics settings guide
Not sure what to pick? Start with Graphics › Best settings for this PC › Recommend… and change things from there.
Which upscaler should I use?
Graphics › Upscaler. The upscaler renders the game below your screen's resolution and rebuilds a sharp image, which gives you more FPS.
| Your graphics card | Best choice |
|---|---|
| NVIDIA RTX (20 series and newer) | DLSS |
| AMD RX 9000 series | FSR 4 |
| Other GPUs with the needed Vulkan features | FSR 4.1.1 (experimental; the launcher says if your GPU can run it) |
| Any other card | FSR 3 |
| Fast card, sharpest image without upscaling | DLSS or FSR with the Native AA preset, or TAA |
Quality preset: Native AA, Quality, Balanced, Performance…
Graphics › Quality preset sets how far below your screen the game renders.
- Native AA: no upscaling, only anti-aliasing (with DLSS this is DLAA). Best image, lowest FPS.
- Quality (x1.5) and Balanced (x1.7): a good mix for most PCs.
- Performance (x2) and Ultra Performance (x3): for slower cards, or 4K screens.
Output resolution
Display › Output resolution is the size of the finished picture, usually your screen's. The upscaler renders below it and fills it in. On cards with 3–4 GB of video memory, 1080p is the safe choice.
Frame rate: 30, 60, 90, 120, 144 or Uncapped?
Display › Frame rate. 30, 60, 90, 120 and 144 are the game's own frame-rate patches. Pick the one your PC holds steadily that is not above your monitor's refresh rate.
- Uncapped has no fixed rate, but it never goes above your monitor's refresh rate: on a 60 Hz monitor it stops at 60. To go past it anyway, add
BB_CAP_TO_REFRESH=0in Settings › Extra variables. - Uncapped can freeze at the end of a boss intro (Vicar Amelia's). 120 and 144 use another patch and don't.
Presentation mode (VSync)
On the Display page, Presentation mode:
- Mailbox (default): low latency without tearing.
- FIFO (VSync): classic vertical sync. On a 60 Hz monitor at 60 FPS it can be smoother than Mailbox, which drops a frame now and then.
- FIFO Relaxed: VSync that tears instead of stuttering when a frame is late.
- Immediate: lowest latency, may tear.
Frame generation and NVIDIA Reflex
Graphics › Frame generation adds generated frames between the game's own. It needs an upscaler (or TAA) on.
- DLSS frame generation: NVIDIA RTX 40 and 50 series, with Hardware-accelerated GPU scheduling on in Windows. RTX 50 can generate several frames, and dynamic frame generation picks how many for your refresh rate.
- FSR 3.1 frame generation: any GPU. Not in menus or movies.
- NVIDIA Reflex lowers input lag, and also keeps NVIDIA cards at their boost clocks.
Frame generation feels best when the game already runs at 50–60 FPS or more.
HDR
Display › HDR output. Windows HDR has to be on (Windows Settings › Display › Use HDR). Turning it on or off applies after restarting the game.
In-game menu (Insert or L3 + R3)
Press Insert on the keyboard, or L3 + R3 on a controller, to change graphics settings while you play: upscaler, sharpening, the FPS counter and more. Most changes apply at once.
Common questions
Shaders, co-op, online play, mods, keys and saves.
Why does the game stutter when I enter a new area?
The first time the game shows something new, the engine builds its shaders, which can cause a short hitch. It only happens once: shaders are saved and built at the start the next time.
- After an engine update the first start takes longer: it rebuilds the saved shaders before the game starts, so you don't get them as stutters in play.
- A small Building shaders note shows in the corner while it happens. A stutter with the note is shader building; one without it is loading.
- You can share shaders: Settings › Shader catalog › Export catalog, and a friend with the same kind of graphics card adds it with Add catalog.
Should I clear the shader cache?
Usually not. A new engine version recompiles it by itself. Clear it (Settings › Shader cache › Clear) only if something draws wrong in every save, such as missing skin or hair. The next start compiles everything again and stutters for a while.
Are my saves backed up?
Yes. The launcher backs up your saves at each start, and every 10 minutes while you play when they changed. Find them in Play › Save backups.
How do I play with a friend (co-op)?
- Both players: in the game's Settings › Network, set the same Password Matching, and Matching Regions to Worldwide.
- The host rings a Beckoning Bell, the helper rings a Small Resonant Bell. Both can be bought in the Insight shop.
- Wait for the bells to resonate. It can take a while.
How do I play online (The Hunter's Dream)?
- In the launcher open the Online page. If you have no account yet, press Open website and sign up on The Hunter's Dream.
- Connect your Hunter's Dream account on the Online page.
- Start the game and choose Play Online. A welcome message appears when you are connected.
Server problems go to The Hunter's Dream's own Discord.
How do I play seamless co-op?
Seamless co-op lets up to 4 hunters play the host's world together in a private, encrypted room. Nobody is sent home after a boss or when someone dies, and you don't need The Hunter's Dream or open ports.
- Everyone: in the launcher open the Online page, turn on Play online and Seamless co-op, and set your Plate name, the name the others see above your hunter (up to 16 characters, spaces and symbols allowed).
- The host picks Host, presses Copy invite code and sends the code to friends.
- Friends pick Join, copy the code and press Paste invite code.
- Start the game. The host picks Start summon in the co-op menu (F2, or L3 + D-pad Up) and friends pick Send sign: no bells needed. The bells still work too: anywhere, even after the area boss is dead, and need no Insight. The screen shows how the summon is going: looking, found, connecting, connected.
In the game, F2 (or hold L3 and press D-pad Up) opens the co-op menu. The host can start a session without ringing a bell, bring or kick each hunter, bring everyone and end the session. A guest can start a summon, ask the host to bring them and return to their own world. Bring works within the same area. The list shows each hunter's ping and connection state; the Co-op tab of the in-game menu can turn off connection status, join and leave notices, and requests.
Voice chat is in the same menu: turn it on or off, mute your microphone or a single hunter, pick push to talk (V by default, or any key or mouse button) or talking, and set the voice volume up to 500%. Voice goes through the room's encryption on its own connection, sent only while you speak, so it never slows down the game.
Rooms are private unless the host chooses otherwise. Open my room to visitors is off by default. While it is on, the host's game gives the room's invite code to Lantern's co-op server, and the Lantern event team can see it in Discord and join for surprise events, so that room is not private from them. Everyone in the room sees a line when a visitor joins, the host can Kick them, and nobody is moved: guests keep control of their own summons. Turning it off or leaving takes the room off the list at once; New room retires a code they already saw.
Guests keep their own stats in the host's world. A guest's lamp takes only that guest home and on to the lamp; the host's world stays put.
With Play online off the game is fully offline: no seamless room, and cheats work.
Your room and invite code stay the same through updates. New room makes a new code and the old one stops working.
Guests keep the progress made while they were in the host's world (bosses, lamps, shortcuts, story and NPC steps) in their own save, never the host's earlier progress. Chalice dungeons work with the party too. Everyone needs the same Lantern Engine version.
Who hosts the co-op servers?
Lantern's seamless co-op rooms run on a server in Frankfurt, Germany, sponsored by 1337 Hosting. Thank you to them for keeping co-op free for everyone. It works well across Europe and reaches the Middle East and the US East Coast with decent latency.
How do I install mods?
Unpack each mod into its own folder inside mods, so that it holds dvdroot_ps4:
mods\Mod name\dvdroot_ps4\chr\…
Then turn it on and set the load order in More › Mods. The lowest mod in the list wins when two mods change the same file. ZIP or 7z archives have to be unpacked first. Mods that replace eboot.bin, DLL injectors and script plugins don't work. Mods work on exFAT and FAT32 drives too.
How do I change keys?
In Controls, click an action and press the new key or mouse button.
The + next to an action adds another key or a combination like Shift+E or Ctrl+Mouse4, up to five per action. A combination wins over its plain key.
Mouse sensitivity goes down to -10 for high-DPI mice; each step below 0 is 20% slower. Mouse side buttons are bound in the Elden Ring style profile.
The Debug Menu won't start
The debug menu needs the font files DbgFont14h.ccm and DbgFont14h.tpf in dvdroot_ps4\font, either in your game folder or in an enabled mod (More › Mods). The fonts are on Nexus Mods.
They have to be the packed files. A DbgFont14h-tpf-dcx folder (unpacked with WitchyBND) does not work: repack it. Don't copy them into an out\mod-game-… folder. The engine makes that folder new at every start.
Trophies
The Trophies page lists them with their pictures. You can use your own trophy sound in WAV, MP3 or M4A, and set its volume.
Fixing problems
First steps for almost anything: update the launcher and engine, update your GPU driver, and try once with mods off (or Use safe mode after a crash).
The game opens, shows a black screen and closes
- Check that the engine is current: the Play page shows Engine update available when it isn't.
- Update the graphics driver.
- An antivirus can block the engine's files. Allow the Lantern Engine folder in it.
- Don't install into
Program Filesor a OneDrive folder. - If it started after a beta update, check the Beta guide: it may be a known beta problem, and you can go back to the version before.
"The graphics driver stopped responding" (0x17)
The GPU hung or lost the game's memory.
- Update to the newest version and update the NVIDIA or AMD driver.
- If it keeps happening, try once with
BB_GUEST_IN_PLACE=0in Settings › Extra variables, and say in your report whether it helped.
"Out of video memory", or crashes on a 3–4 GB graphics card
- Lower Display › Output resolution to 1080p or less, and use a lower Quality preset (Performance).
- Use fewer texture or model mods: HD texture packs need much more video memory.
- Close browsers and recorders while playing.
- Keep More › Engine › Use more VRAM for textures off on cards with 4–6 GB.
"Windows could not give the game its memory" at the start
The game needs about 6 GB of RAM plus page file (about 10 GB above 1080p).
- A game left running in the background holds it: end
bb-probe.exein Task Manager (Details), or restart the PC. - Set the page file to System managed size: Windows Settings › System › About › Advanced system settings › Performance Settings › Advanced › Virtual memory › Change.
- Or choose a lower output resolution or upscaler preset.
The game crashes while loading (missing or damaged game files)
If the crash report mentions missing files or FileTransferTask, the game folder is incomplete or damaged. Turn mods off first. If it still crashes, dump or extract the game again (base game plus the 1.09 update), and keep it out of OneDrive.
Flickering, stretched or missing textures
- Update to the newest version. 0.9.37 fixes shaders reading the wrong buffers, which caused stretched geometry and flicker, especially on older AMD cards (RX 400/500) and on NVIDIA.
- If it happens in every save (missing skin or hair), clear the shader cache once: Settings › Shader cache › Clear.
- Try with mods off, and with frame generation off.
- Still there? Post a short video and your log.
Small stutters at 60 FPS on a 60 Hz monitor
Set Presentation mode to FIFO (VSync) on the Display page. At 60 FPS on a 60 Hz screen, Mailbox can drop a frame every so often, and that feels like a micro-stutter. Stutters the first time you see an area are shader building, see Why does the game stutter.
The game is stuck at 30 FPS
The game runs slower while its window is in the background, to save power. Click into the game window. FPS staying low after you switch back, or after lantern travel, is fixed in 0.9.37.
"Cannot create save file"
The saves folder can't be written, and the launcher now says why. Move Lantern Engine out of OneDrive and other synced folders, and out of Program Files. If Windows' Controlled folder access is on, allow the Lantern Engine programs in it.
Mods don't load ("cannot link … dvdroot_ps4")
This happened on exFAT and FAT32 drives before 0.9.37, which reads mod files in place there: update. Also check that each mod's folder holds dvdroot_ps4 (see How do I install mods?). The start's log says how many game files each mod replaced.
Linux: the window closes at the start on Wayland
If the log says Wayland display connection closed by server, the compositor ended the connection, a driver and compositor mismatch (NVIDIA 615 drivers on KDE Plasma did this; 580 runs clean). Try another driver version, or start with SDL_VIDEODRIVER=x11 ./lantern.sh to run through XWayland.
What players asked
Recent questions and reports from the Discord, with the answer.
Is there a guide for graphics settings?
Yes, see the graphics settings guide. The quickest start is Graphics › Best settings for this PC › Recommend…
After I updated to the newest beta, I cannot launch the gameIt opens, black screen, closes. RX 9070 XT.
An engine bug that hit AMD cards at every start of 0.9.37 beta 6.
Game crash after 10 min, sometimes 1h laterThe graphics driver stopped responding. RTX 2070, RTX 3070 Ti, GTX 1660 Super.
0.9.37 fixes the likely cause. See "The graphics driver stopped responding", and tell us if it still happens.
Uncapped seems locked at 60
Uncapped stops at your monitor's refresh rate on purpose. Add BB_CAP_TO_REFRESH=0 in Settings › Extra variables to go past it, or pick FIFO (VSync) for smoother 60.
Very small micro stutters when rolling or running
Mostly shaders built the first time something shows; they are built at the start from then on. At 60 FPS on a 60 Hz screen, try FIFO (VSync).
It uses the D-pad when I press WASD after a menu
W/A/S/D no longer acts as the d-pad after a message or a menu.
Can I bind more than one key, or Shift+key?
Yes: the + next to an action in Controls adds up to five keys, mouse buttons or combinations. Mouse sensitivity goes from -10 to 20.
Debug Menu won't start even with the patch
The fonts have to be the packed files in dvdroot_ps4\font of the game folder or an enabled mod. See The Debug Menu won't start.
Flickering and missing textures with the BB PC Remaster mod
Update to 0.9.37 first: it fixes a shader bug behind flicker on NVIDIA. If it stays, try with frame generation off and post a short video.
Known issues
Reported and not fixed yet. Lantern Engine is moving to its own native engine, so expect bugs even in stable releases. A log or a video of any of these helps.
- Some lights, smoke and lamp glow missing, and blocky lighting, on some PCs.
- Green or white flashes at doors in the Research Hall, and white or blue screens in the Forbidden Woods.
- FPS dropping after long sessions on some PCs.
- 4K with DLSS or FSR above Performance: light dotted outlines around tree branches.
- Steam Deck: a crash in Game Mode after the intro (Desktop Mode works).
- Falling snow missing in Cainhurst.
- Crashes on graphics cards with 3 GB of video memory.
Beta guide
Betas get the newest fixes and features first. How to get them, what the current one changes, and how to report what it breaks.
Updates
Nothing matches that. Try another word, or ask in the Discord.
What the beta is
Test builds that come before a stable release.
Should I use the beta?
Betas are test builds that come before a stable release. They have the newest fixes and features, and sometimes new bugs. Use one if a problem you have is fixed in it, or if you want to help test. Stay on stable if you just want to play.
Your settings, saves, mods and logs are kept when you switch between beta and stable.
Join or leave the beta
One setting in the launcher, and you can go back any time.
Get the beta
- In the launcher: Settings › Updates.
- Set Update channel to Beta.
- Press Check now and install the update.
On Linux, the launcher updates itself from 0.9.37 beta 7 on. Before that, get the Linux package from Releases and unpack it over your folder.
Go back to stable, or to the version before
Set Update channel back to Stable to get stable updates again. To install a particular version right away (for example the beta before, when a new one breaks your game): Settings › Updates › Version, pick it, and press Install.
No beta right now
The newest version is the stable 0.9.37; on the beta channel the launcher installs it too.
Reporting beta problems
Say which beta, and whether the one before had it.
What helps
- The crash report or log (see Before you post). Both start with your version, so we know which beta it was.
- Whether it also happened on the version before. If not, say so: it means the new beta caused it.
- Post in #issues on the Discord.