Troubleshooting FAQ
Contents
Lorekeeper 500 Errors - How to find and read your logs
500 errors are some of the most common errors you'll encounter on your site. If you are in your production server, they'll show up with very little information to inform you what has happened.
There are two main ways to get more information
- Re-produce the error on your local environment, which should have error verbosity turned on. (Don't have a local? Go make one)
- Find the error in your log files
Finding the error in your log files can be a little confusing if you've never done it before, so we'll walk through that here.
- Navigate in your file manager to
/storage/logs/from your root LK folder - Find the file named with today's date
- Open the file and scroll all the way to the bottom
At that point you should see a bunch of lines that look something like this ([...] added to represent bits that were removed for brevity):
#47 /[...]/laravel/framework/[...]/Pipeline.php(167): [...]\\PreventRequestsDuringMaintenance->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#48 /[...]/laravel/framework/[...]/Pipeline.php(103): [...]\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#49 /[...]/laravel/framework[...]/Kernel.php(141): [...]\\Pipeline->then(Object(Closure))
Notice the lines are numbered! What you'll want to do is carefully scroll up until you see those numbers count down to #0. We don't want to go past this set of lines and into the next error up, so it's important to not scroll through them too quickly or it'll be easy to miss.
When you get to #0 it'll look like this:
[stacktrace] #0 [...]
And will have one additional line above that. That's your error message. It'll have a timestamp in front of it, and that's what you'll want to pay attention to, to try to solve the error, or copy into the discord so that others can help you parse what it means.
How to Read a 500 error
Most 500 errors will give you two important pieces of information - a variable name, and a file name.
An example of a 500 error:
Trying to get property 'name' of non-object (View: \site\resources\views\[...]\create_edit_submission.blade.php)
create_edit_submission.blade.php is the file where something is going wrong, and name is the variable, or function where things aren't working as expected.
While it's good to then go double check that template file to see if anything looks out of the norm, often template errors are occurring because of an issue deeper in the code. Tutorial: Adding Fields to Users/Characters/Etc has a great explanation about how the different parts of Lorekeeper hand-off to each other to explain how you can start to trace issues from a template to their cause.
Common Sources of 500 Errors
Deleted Entities
Whether it's a character, item, currency, or any other 'entity' in Lorekeeper, it's rare to delete one, and doing so can cause issues in parts of the application that don't have robust checks against something not existing. This is especially true when you start adding extensions to the mix. If you've deleted something recently and it's remotely related to the page giving you a 500 error, it's a good bet that it's the cause. If you're not sure how to fix it, then it's a good candidate for asking about in the discord server, as it can be very case by case!
Changes not showing up?
Were the changes in the .env, config files, or route files?
Try using php artisan optimize. If the site stops work at all, run it a second time.
Initial Setup Common Issues
Root composer.json requires php ^7.4 but your php version (8.1.6) does not satisfy that requirement
You probably downloaded the wrong version of XAMPP!
Go to XAMPP's Downloads page and make sure you grab the version that matches the php version in your composer.json.
