# Sprite Manager

> Clicking **\[Settings]** under **\[Resource Manager]** opens the Sprite Manager.\
> You can configure detailed settings for the sprite's actions (e.g., character motions) and images.

<figure><img src="/files/iupoiXJ1TlznqGTJbAUB" alt=""><figcaption></figcaption></figure>

> **\[Sprite Sheet]**
>
> You can view the entire image and divide it into frames by specifying a grid (array).\
> Frames can be added by dragging or clicking to specify the frame area.
>
> ***
>
> **\[Action]**
>
> An action represents a unit of motion used for character animations.\
> You can name actions appropriately based on their purpose to implement suitable motions.
>
> ***
>
> **\[Frame]**
>
> Frames are the building blocks applied to actions.\
> Click on the cells divided by the grid in the sprite sheet to add and edit frames.
>
> * When adding a frame, it is created immediately after the currently selected frame.
> * To deselect a selected frame, click on an empty area in the frame section.
>
> ***
>
> **\[Preview]**
>
> * **Play**: Preview the selected action by playing it.
> * **Repeat**: Toggle whether the playback should loop.
> * **Collision Range**: Used for animation hitboxes or event ranges for NPC-type units.
> * **Ambient Light**: Adjusts the brightened area surrounding the sprite when environmental lighting is set.

> **\[Settings]**
>
> This function allows you to configure the properties of the selected area.
>
> * **Sprite Sheet Area**: Example: `0slime.png` (Sprite)
> * **Action Area**: Example: `0slime.png/down` (Action: down)
> * **Frame Area**: Example: `0slime.png/down/#1` (Frame: #1 of the "down" action)
>
> At the top of the settings window, the navigation bar displays the current focus, helping you identify which area is being configured.

<figure><img src="/files/97rz6NvU31c3XucNUO8S" alt=""><figcaption></figcaption></figure>

> **\[Menu Configuration]**
>
> **Add**
>
> * **Right-Click on the Action Section**: Right-click and select **Add** to create a new action.
> * When an action is selected, **left-click** on an image in the sprite sheet to add it to the frame list.
>
> **Delete**
>
> * Select the action or frame you want to delete, then press the **Delete** key to remove it.
>
> **Cut, Copy, and Paste**
>
> * To copy and paste an action or frame:\
>   Select it and press **Ctrl + C** to copy and **Ctrl + V** to paste.
> * To cut an action or frame:\
>   Select it and press **Ctrl + X**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.punkland.io/punkland-studio/in-depthguide/spritemanager.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.