Wonderdraft Installing assets for Wonderdraft

Not open for further replies.


Lead staff-member
Staff member
This page explains the procedure for installing your own custom mapping symbols.

There is an example asset pack on your Humble Bundle download page. Starting with the example asset pack is a good idea as it has a pretty complete structure already with examples of different types of assets.

Basic Steps
To add custom assets into Wonderdraft, follow these steps.

Step 1
Go to this location in your File Explorer.

Windows: C:\Users\<User Name>\AppData\Roaming\Wonderdraft\assets\
MacOS: /Users/<username>/Library/Application Support/Wonderdraft/assets/
Linux: /home/<username>/.local/share/Wonderdraft/assets

OS Specific Tips: Windows, MacOS, Linux
Step 2
Create a new folder and give it a name that will be meaningful to you. In this example, the name MyAssets
is used but you can name it however you like. You can have as many
asset folders as you like at this level but the folder structure
underneath must follow a specific structure.

Windows: C:\Users\<User Name>\AppData\Roaming\Wonderdraft\assets\MyAssets\
MacOS: /Users/<username>/Library/Application Support/Wonderdraft/assets/MyAssets
Linux: /home/<username>/.local/share/Wonderdraft/assets/MyAssets

Step 3
Create sub-folders for your assets following the structure found in the Example Asset Pack. You can see the structure here.

Symbols, including mountains and trees, go under the sprites folder. Each sub-folder of the sprites folder must be named according to the type (mountains, symbols or trees) of assets it contains.

Under the mountains, symbols and trees folders you add additional
folders, using names of your choice, to organize your symbols into
categories. See sprites folder.


Assets placed into trees or mountains will be randomly selected as you paint with the Tree or Mountain tools. In the Symbol Palette for these tools, each sub-folder of mountain will show as a selection that represents all the mountains in that sub-folder. The same idea applies to sub-folders of trees.

Assets under symbols are treated more like stamps repeating the same one again and again unless you enable Shuffle in the Advanced settings on the Symbol Tool palette. Each sub-folder under symbols appears as a choice in the Symbol Set drop-down selection.

Running Wonderdraft after you have added your assets creates new metadata files called .wonderdraft_symbols. Inside are various options you can modify.

Also see this wiki page.

OS Specific Tips

The AppData folder is hidden by default in Windows. There are two easy ways to get there:
  1. Type in %AppData%\Wonderdraft in the address bar on your File Explorer
  2. In Wonderdraft, select Open User Folder from the menu.
For simpler long term access you can enable viewing of Hidden Files/Folders in the File Explorer by going to the View tab and checking the Hidden items checkbox.

Library might be hidden for you, but you can do this:
  1. From the OS X Finder, open a new window and go to the users Home folder (hit Command+Shift+H to jump to Home instantly)
  2. Pull down the “View” menu and select “Show View Options” (or hit Command+J if you like keyboard shortcuts)
  3. Check the box for “Show Library Folder” then close the View Options panel
  4. Navigate in the users home folder to see the newly visible “Library” directory

Under Linux, .local is a hidden folder so in whichever Desktop Environment is being used (ie. Cinnamon, XFCE, Gnome) the file explorer will have to show hidden files and folders. In Cinnamon, Nemo is the file explorer and when opened, the View menu option has a check box to Show Hidden Files or Ctrl+H as a shortcut.

Creating a shortcut to the desktop: Hold Ctrl+Shift and drag the folder to the desktop. It will create a shortcut or symbolic link to the folder.

Information from the official Wonderdraft Wiki
Last edited:
Not open for further replies.

Forum statistics

Latest member

Latest profile posts

Working on top down city blocks...
SrAndrewRyan wrote on transylvanlig's profile.
Hi! I was wondering if your desert assets can be used for commercial purposes? Let me know, thanks!

Mystilik_Mew wrote on Nexoness's profile.
Sorry for bothering you, but I'm having trouble trying to use one of your themes for Wonderdraft.
I've got the zip file in my folders, and I tried unzipping and just putting that in their alone. I'm using Mac btw, hope you can help? Thanks

Join the platform as a developer!

If you are developing software or maintaining a community related to map-making in any way then you are more than welcome to join our platform!

Learn More!
  • Legend Keeper
  • MapForge
  • Campaign Cartographer
  • Dungeon Builder
  • Other World Mapper
  • Top