> 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/in-depthguide/spritemanager.md).

# 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**.