Import maps from other Illusion games

If you are interested in working with more maps, but do not have the technical expertise to create your own, then you may consider using maps from other illusion games.

This process describes one method to import other maps.

The following tools will be used

• SB3Utility
• PP Extractor

Note: the following procedure only works for games that are supported by SB3Utility. This is a copy/paste sort of guide rather than "make your own map!" 

To organize yourself, you should create a work folder that contains the PP extractor where you will be building your new maps file.

Finding the maps

1. Obtain a copy of the game that you wish to import maps from. I will refer to it as "otherGame"
2. Open the pp files in SB3Utility. The maps are stored in .xx files, so go through each pp file checking if there are any xx files in the package
3. If you see an xx file, double-click to open it in the editor, click on the meshes tab, and highlight all items. If it appears to be a map, then note down the pp filename.
4. Once you have found all of the pp files that contain maps (there's usually only one or two), you can copy them to your work folder.

Preparing a map file

This is an optional step, but it will make things easier for you in the future. You will basically prepare an empty Yuusha map file where you can quickly load map data into.

1. Go to the Yuusha data folder and find "mo_00_00_07.pp". This file contains the map data that the client will use. It supports 12 maps.
2. Create a copy of it and put it in your work folder.
3. Open the new pp file in SB3Utility
4. Click on one of the xx files. Your goal is to clear out the original contents so that you can put in new ones from your desired map.
5. In the object tree, expand "All root", click on SCENE_NEW, then click remove in the frame to the right. It should be deleted when you do so.
6. Click on the textures tab, highlight all files, and click remove.
7. Click on the materials tab, highlight all files, and click remove.
8. Go back to the object tree and you should see pretty much nothing.
9. Repeat steps 1 to 8 for the other 11 xx files.
10. Save your pp and rename it to something convenient like "emptyYuushaMaps.pp"

Importing new maps

Now you can begin adding the new maps. Start by saving your emptyYuushaMaps as a new file.

1. Load one of otherGame's map files into the editor (I will refer to this as "otherMap")
2. Load one of Yuusha's map files into the editor. We can start with ms00_00_00.xx as it is the first stage on the client (refer to as "grassland").
3. Go to File --> New workspace to open a new window
4. In otherMap's object tree, drag "allroot", "materials" and "textures" into the new workspace.
5. Click on allroot in the workspace and ensure that the replace method is "merge"
6. Click on the grassland tab in the editor, then click "Add/Replace" on the workspace window
7. Your grassland object tree should now contain the same number of items as otherMap
8. Click on the meshes tab and highlight all of the files. You should see your new map in the renderer.
9. In the pp list, click on the yuusha file, and then save.
10. rename your yuusha file to mo_00_00_37.pp and move it to the data folder, replacing the existing copy (make back-ups if you haven't already done so)
11. Now start up digital yuusha and click on grassland map. You should see the new map load up. If it doesn't work, then either you have done something wrong, or it just won't work. Usually if it doesn't work then you either see nothing or the colors are wrong, but most maps should load up.
12. Repeat steps 1 to 10 for each map you want to import

Now you have new maps to work with.