Maps

## Downloading Maps on PC, Android or IOS

After downloading the **map.wbox or map.json** from a source such as the Discord you can view the respective platform related information below to download and use maps.

It is important that all files must be named exactly as specified (for example, **map.wbox**, **map.json** or **preview.png**) otherwise **the game will not recognize them** and the map will not load.

## File Info

Below will provide a short documentation of the various files you may see when downloading maps, and so you have a basic understanding of what they are before going through install instructions.

* **map.json**- Old map format prior to update 0.7.0. This format still loads and run within worldbox, but will ***not*** have a ***map.meta*** file.
* **map.wbox**- New map format released in update 0.7.0. Generates a ***map.meta*** file.
* **map.meta**- Meta information that helps preview maps in-game. This file is generated with ***map.wbox*** files and is not necessary to share to other users for your map to work.
* **preview.png**- Image that shows in the save manager that gives a preview of what the map looks like. This file is optional, but without it the files will have a blank ocean background and may appear "empty" when they are not.

Files are can only be grouped like such with (o) denoting optional files:

* **map.json** and (o)**preview.png**
or
* **map.wbox,** (o)**map.meta**, and (o)**preview.png**.

## Map installations

### PC Installation

1. Locate Save files in `%AppData%\..\LocalLow\mkarpenko\WorldBox\saves` (copy and paste this into your file explorer address field and press enter)
If the folder does not exist create it, and inside of "saves" create a folder named "save1"
this will be the first save in your game when you launch.
2. Select a pre-existing save folder or the folder you just created. (save1, save3, save5, etc) and Place your downloaded map.wbox or map.json file here. Optional files such as map.meta or preview.png are also placed here.

#### Do not have the "AppData" folder on your Windows 10?

1. Go to Explorer.
2. Open the **C:** drive.
3. Click **View** on the menu bar.
4. Click the **Options** icon. (If you click the small arrow below it instead, choose **Change Folder and Search options**).
5. Select the **View** tab.
6. Under **Files and Folders > Hidden files and folders**, select the option to **Show hidden files, folders and drives**.
7. Click **OK**.

### Android Installation

1. Locate Save files in Android\data\com.mkarpenko.worldbox\files\saves
If the folder does not exist create it, and inside of "saves" create a folder named "save1"
this will be the first save in your game when you launch.
2. Select a pre-existing save folder or the folder you just created. (save1, save3, save5, etc) and Place your downloaded map.wbox or map.json file here. Optional files such as map.meta or preview.png are also placed here.

*Video Installation*

### IOS Installation

***Currently Maps can't be installed on IOS devices that aren’t jailbroken as IOS devices do not provide users with access to the game's files which need to be used for map installation. map.json Files are not supported***

*If your iOS device is jailbroken, you can follow these instructions (Instructions assume you are using Filza File Manager)*

1. Locate WorldBox Folder in `/var/mobile/Containers/Data/Application/` (Folder name is WorldBox)
2. Once inside WorldBox Folder, navigate to “Documents”, and then to “saves” folder
If the “saves” folder does not exist, create it, and inside of "saves" create a folder named "save1"
this will be the first save in your game when you launch.
3. Select a pre-existing save folder or the folder you just created. (save1, save3, save5, etc) and Place your downloaded map.wbox file here. Optional files such as map.meta or preview.png are also placed here.

*Note that this has not been tested thoroughly. Files such as map.json have failed, but it is unknown if they truly are not compatible. For now, only use map.wbox, map.meta, and preview.png files.*

***Any problems that occur will be at your own risk!***

### **Mac Installation**

Do Command+Shift+G Then paste this in `/Users/NAME/Library/Application Support/mkarpenko/WorldBox/saves`

Change *"NAME"* to your name

This may only pop up if you've saved maps prior

Select a pre-existing save folder or the folder you just created. (save1, save3, save5, etc) and Place your downloaded map.wbox or map.json file here. Optional files such as map.meta or preview.png are also placed here.

## Map Making Types

There are many ways maps are created, used, and shared. Below lists the various types of creation methods and generic info about what they are.

### Default Maps

The first and normal way, maps generated naturally through the game's generator tool with sizes from 2x2 to 7x7. The generator has attributes like small island factors and random shape factors, which affect the way the game generates these islands. You can also click the earth button and generate islands, archipelagos, or an empty ocean.

Default maps sizes:

* **Tiny:** 128x128 tiles (2x2)
* **Small:** 192x192 tiles (3x3)
* **Standard:** 256x256 tiles (4x4)
* **Large:** 320x320 tiles (5x5)
* **Huge:** 384x384 tiles (6x6)
* **Gigantic:** 448x448 tiles (7x7)
* **Titanic:** 512x512 tiles (8x8)
* **Iceberg:** 576x576 tiles (9x9)

### Modded Sizes

The other way is to modify the sizes of the natural generator to go beyond or below what the game is set to, with maps as large as you want.

Generally, 30x30 is the maximum size of a playable map for most advanced computers, requiring a computer with at least 16 GB of RAM to run.

There are bigger map sizes, such as 40x40 and 50x50, but they can take 3-5 minutes just to load (always assuming 16 GB of RAM), and they are enormously game-crashing, making it impossible to play on them.

Below that is 20x20 which is where most advanced phone's limit may hold.

Average newer phones should get 15x10 without awful lag.

For less powerful machines the game's limits are as far as they can work with.

These sizes are produced either through using a memory editor like Cheat-Engine, or Game-Guardian with the use of the generator tool. Or the Image-To-Map program.

### Image-To-Map

The last kind and the best for accurate maps is the image to map method. It produces an image by taking input and applying a palette to it. It also produces a map.wbox which you will need to place in your saves folder. There are bots that utilize the imagetomap's functions on the discord. The original imagetomap code was produced by Destring, and is located on the discord (discord.gg/worldbox).