General Info

Overriding Assets

MagicaVoxel

Directories

You need to open airshipper, click the settings icon and paste the absolute path to the directory with your assets. Within it, you need to copy the folder structure from the airshipper\profiles\default\assets

Making Maps and Panoramas

Veloren Airship-Thingy

1. Set up an environment within which you can compile Veloren. Refer to this document.
2. Install rustup and then install the nightly version of the rust toolchain using rustup (refer to the readme on leviticoh's repo)
3. Clone the newest Veloren repo
4. Download the map-search directory from Leviticoh's github.
5. Edit the cargo.toml in your downloaded Veloren repo to include the map-search folder, like in the screenshot.
6. Compile the game
7. Execute ./target/debug/veloren-map-search -s <SEED> --map-path <MAP_PATH> <COMMAND>
• Get the <SEED> from /airshipper/profiles/default/userdata/singleplayer_worlds/<FOLDER>/meta.ron
• Get the <MAP_PATH> from /airshipper/profiles/default/userdata/singleplayer_worlds/<FOLDER>/meta.bin
8. Enter routes into the <COMMAND> field to get the airship routes, and locations to get locations of the more important sites.

Extract the game map png with RenderDoc

1. Download and install RenderDoc
2. Into the Executable Path field enter the absolute path to the veloren-voxygen.exe. Then click launch.
3. Enter into the world you want to extract the map graphic from and click M to open the map screen.
4. Press F12 to capture a snapshot using RenderDoc.
5. Alt+Tab out of the game and go back into RenderDoc to open up the saved capture. Double click on the thumbnail to open it.
6. Open the Texture Viewer tab.
7. On the left side, open up the Colour Pass #4 subtree. Scroll the individual positions from the bottom. You can find the texture without the height-lines further up the list.
8. Look on the Inputs tab for the correct texture. Click on it, then click on the Save icon in the Actions grouping.
9. Save as PNG or JPG.

Paint.NET and useul plugins

Download Paint.NET from this link.

You can search through the plugin list using the Plugin Index. I reccomend you install these:

• Pyrochild's plugin pack for the Outline Object plugin

Some useful tips:

• Have every airship route use a specific color and position it on a separate layer.
• To make the map bigger, change it's size using Nearest Neighbour scaling, which will keep the pixelated look.

Autopano Giga

Download it from the link present here: https://hdrmaps.com/blog/autopano-giga-is-now-free/. (in case it gets taken down, here is a direct mediafire link.) To download it from the official site, you are required to create a TerraBox account or log in with Google or another platform of your choice. You skip this part of the process by downloading it from the link above. Both the link itself as well as the executable itself do not show any signs of malicious behaviour after being scanned by Virus Total.

After installing the file, register it with the following details:

User: freecopy@kolor.com Registration code: KAPG7-K3A9X-IZJHX-FIIT7-C5IM8-MQF2N

To make the photo work with Pannellum without self-hosting it, you need to export the photo with the Spherical projection with 2:1 size ratio.

If you want to see the differences between the different Interpolator settings, visit this link. The examples shown are using outdated settings, nevertheless they illustrate the diversity of the options available. I used Spline64 for my panoramic shot and it seems to work fine.

Pannellum

If you do not want to self host Pannellum, you need to host your image on a web host that supports Cross-origin resource sharing (CORS). One such site is Imgur. Make an account, upload your photo there and copy the direct link to an image (i.e. click on an image and the choose "Open image in another tab") to the simple tutorial Panorama URL field. Be aware that this will compress the original image quite heavily (the image will weigh around 1MB this way), as well as downsize it to 5000x2500.