> For the complete documentation index, see [llms.txt](https://docs.punkland.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.punkland.io/punkland-studio/studio/map-making/add-map.md).

# Add Map

### Creating a New Map

Maps serve as stages for player interactions, such as intro scenes, hunting grounds, or towns. Follow these steps to create a new map:

1. **Right-Click the \[NekoSample] Folder**: Locate the **\[NekoSample]** folder in the file explorer and right-click it.
2. **Select \[New Map]**: From the context menu that appears, click on **\[New Map]**.

This will initiate the creation process for a new map.

<figure><img src="https://2238012829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2Ka7Zw6XRkhbp2nH2Oz3%2Fuploads%2FWWZdNl2g6Wjz8gsYrwxt%2FScreenshot%202024-12-09%20105400.png?alt=media&amp;token=8fcc80f2-05a5-466c-94f1-3b3932ce35f0" alt=""><figcaption></figcaption></figure>

#### Configuring a New Map

When the **\[New Map]** popup window appears (refer to the screenshot below), configure the following settings:

1. **Name**: Enter a unique name for the map.
2. **Size**: Specify the dimensions of the map.
3. **Tileset**: Choose a tileset for the map's visual theme.
4. **BGM Change**: Set the background music for the map.
5. **BGS Change**: Configure the background sound effects.
6. **Single Play**: Enable or disable single-player mode.
7. **Instance Map**: Toggle the instance map setting.
8. **Gravity**: Define the gravity level for the map.
9. **Channel Count**: Specify the number of channels available for the map.
10. **Maximum Players**: Set the maximum number of players allowed on the map.

After entering the desired settings, click **\[Confirm]** to create the map.

<figure><img src="https://2238012829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2Ka7Zw6XRkhbp2nH2Oz3%2Fuploads%2F0H0isv2eTs0V8zTi5J9P%2FCapture2.PNG?alt=media&amp;token=9b131c55-a656-4a42-b307-5f33033f9eb3" alt=""><figcaption></figcaption></figure>

#### Configuring Map Details

When setting up a new map, you can customize the following fields:

1. **Name**:
   * Set the name of the map being edited. This name is unrelated to the game's content and is purely for organizational purposes. Choose a name that clearly indicates the map's purpose.
2. **Size (Width/Height)**:
   * Specify the map's dimensions (in tiles).
3. **Tileset**:
   * Select the tileset to use for creating the map.
     * Example: Choose **\[002: Background Tiles]** for a background map or **\[000: Town]** for creating a village map.
     * Pick a tileset appropriate for the map's intended design.
4. **BGM Change**:
   * Set the background music for the map.
5. **BGS Change**:
   * Configure the background sound effects.
6. **Single Play**:
   * Enable or disable single-player mode.
7. **Instance Map**:
   * Check this option to make the map an instance map.
8. **Gravity (X, Y)**:
   * Set the gravity values for the map's environment.
9. **Channel Count**:
   * Define the number of channels available for the map.
10. **Maximum Players**:
    * Specify the maximum number of players allowed in the map simultaneously.

&#x20;

#### Example: Creating a Map

For example, if you set the following:

* **Name**: `test`
* **Size**: Width 16 / Height 16
* **Tileset**: `000: Town`
* **Instance Map**: Checked

Click **\[Confirm]**, and the newly created map will resemble the screenshot below.

<figure><img src="https://2238012829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2Ka7Zw6XRkhbp2nH2Oz3%2Fuploads%2FM3AwJ8WbMEQyEXaa4Mxl%2FCapture3.PNG?alt=media&amp;token=d5f42893-6d58-423d-920f-7a8daf942f30" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2238012829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2Ka7Zw6XRkhbp2nH2Oz3%2Fuploads%2FXsPDJRLLCy3DiExz1tMZ%2FCapture4.PNG?alt=media&amp;token=a99584b6-8ad0-4e2e-b489-1e65b4be55ac" alt=""><figcaption></figcaption></figure>