Skip to main content

Troubleshooting

Troubleshooting Adventure Muncher

When I import the adventure there are no background images​

There are likely two causes:

  1. Ensure you are using the latest version of Adventure Muncher.
  2. You might be hitting the file size limit upload for your proxy configuration. Common if you have followed a guide to configure self hosted Foundry without understanding what you are doing.

My adventure never seems to generate!​

  1. If using Windows, try right-clicking and Run As Administrator. On some setups, this appears to be needed.
  2. Try clearing the downloaded files File -> Remove downloaded files, a download may have become corrupted.
  3. Get the log file! It is cleared everytime the app is opened, and can be found by going to Help -> Log file location.
  4. If you can't identify the problem, please reach out on Discord in the #adventure-muncher channel.

Getting better error messages​

Try running from the command line: s

  • Windows users: right-click on the application icon on the desktop
  • There should be a field called "Target" copy all of the text in there. in mine it's C:\Users\jack\AppData\Local\Programs\ddb-adventure-muncher\ddb-adventure-muncher.exe
  • If you're using a Mac or Linux, you can figure the above out yourself
  • In the start menu, type "command prompt" and open the command prompt
  • Enter the above command that was copied
  • When you click on buttons, it should output information to the terminal window. Look for the error.

Arch (and Arch-based OS) or some Linux distros​

You may get an error:

[2021-10-17 18:58:08.766] [error] Error: SQLITE_NOTADB: file is not a database
--> in Database#each('\n' +
  'SELECT ID as id, CobaltID as cobaltId, ParentID as parentId, Slug as slug, Title as title, RenderedHTML as html\n' +
  'FROM Content\n', [Function: rowGenerate], [AsyncFunction: collectionFinished])
    at Database.<anonymous> (/tmp/.mount_ddb-aduIneDx/resources/app.asar/munch/book.js:1506:8)
    at Object.getData (/tmp/.mount_ddb-aduIneDx/resources/app.asar/munch/book.js:1497:6)
    at /tmp/.mount_ddb-aduIneDx/resources/app.asar/main.js:232:14
    at runMicrotasks (<anonymous>)
    at processTicksAndRejections (internal/process/task_queues.js:93:5)

This is due to newer versions of GTK3 shipping sqllite as a core library. A workaround for now:

Ensure that libsqlcipher is installed:

sudo pacman -Sy sqlcipher

Then run the adventure muncher by first setting the environment variable LD_PRELOAD=/usr/lib/libsqlcipher.so

LD_PRELOAD=/usr/lib/libsqlcipher.so ./ddb-adventure-muncher.appImage

or if running from source:

LD_PRELOAD=/usr/lib/libsqlcipher.so npm start

Getting More Help​

Join us on Discord in the #support channel.