BEFORE YOU START: WARNINGS & GOOD PRACTICE

There are a few things to know to avoid major inconveniences, bugs or crashes.

NEVER USE A CLOUD FOLDER

Don't use a OneDrive, iCloud or any other type of synced folder to store anything related to Dungeondraft (saves, assets, mods...). Dungeondraft doesn't play well with that type of folder and you might break important things, and even lose your work.

NEVER USE THE INSTALL FOLDER

In the same spirit as the first advice, never use the folder where Dungeondraft is installed to store information such as saves, assets or mods. It's not meant to hold anything else than the program itself and might cause some unwanted behavior.

ACCENTS AND SPECIAL CHARACTERS CAUSE ISSUES

In most cases, Dungeondraft can't read accents or special characters (punctuation, cyrillic, greek letters...). Make sure your folders, asset packs, images inside the asset packs, mod folder names or anything related to Dungeondraft doesn't use them or you might get some issues.

ALWAYS CLOSE DUNGEONDRAFT BETWEEN TWO MAPS

This applies only for Custom Assets users.

If you're using custom assets, it is very important to close Dungeondraft before working on a second map. Without closing, Dungeondraft keeps in memory your previous asset packs, so you can visually use them... but it doesn't actually keep the packs enabled, and you might witness missing assets the next time you load your map. Of course this applies only if you use different packs on different maps.

Same goes if you want to update a pack. If you don't close Dungeondraft after a pack has been updated, it won't be processed correctly and it might not even be recognized by the software, even if you reload your map. Always fully close and reopen Dungeondraft when you change something related to custom asset packs.

CHECK IF YOUR VERSION IS UP TO DATE

If you're not using the latest stable release, you might experience some issues that were fixed in the newer/current version. Some topics in this guide won't apply to previous versions as well.

VERIFY YOUR BACKUP SETTINGS

Make sure you've enabled the automatic backups and set a decent frequency so you can easily recover your maps in case of issues.