# Spine

*This feature is available from Spine version 3.8.20 and above.*\
\&#xNAN;*Free Spine resources and example game files for Punkland are attached in the link below for your reference.*

Example Resources: <https://nekoland.net/market/detail/3119>

***

To use the Spine animation and equipment swapping features in Punkland, you must set the animation names and slot names in the Spine file to match Punkland’s requirements.

The keywords are as follows:<br>

### **Animation**

|         |                |
| ------- | -------------- |
| Idle    | idle\_left     |
|         | idle\_right    |
|         | idle\_up       |
|         | idle\_down     |
| Walk    | left           |
|         | right          |
|         | up             |
|         | down           |
| Attack  | attack\_left   |
|         | attack\_right  |
|         | attack\_up     |
|         | attack\_down   |
| Jump    | jump\_left     |
|         | jump\_right    |
|         | jump\_up       |
|         | jump\_down     |
| Damaged | damaged\_left  |
|         | damaged\_right |
|         | damaged\_up    |
|         | damaged\_down  |
| Dead    | dead\_left     |
|         | dead\_right    |
|         | dead\_up       |
|         | dead\_down     |

<figure><img src="/files/zPIGHyyEuqrWABl9lRcy" alt=""><figcaption><p>*스파인 애니메이션 이름 예시</p></figcaption></figure>

### Equipment

| Hat    | hat          |
| ------ | ------------ |
| Armor  | armor        |
| Weapon | weapon       |
| Shield | shield       |
| Wing   | wing         |
| Shoes  | shoes\_left  |
|        | shoes\_right |

<figure><img src="/files/Km3Kh5PUHkDUGqgtyVju" alt="" width="555"><figcaption></figcaption></figure>

<br>

***

* ## Character setting

1. Place the **spine allas.txt**, **json**, and **png** files in the **Spines** folder of the Punkland project.
   * The three files must be in the same folder for the Spine resource to work correctly.
   * The folder name **(Spines)** must be case-sensitive and spelled exactly the same.

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

2. Select the **png** file from **Database > Character > Graphics**.

<figure><img src="/files/1K4Cb100YH50iB3FGGz6" alt=""><figcaption></figcaption></figure>

* **Scale** and **border** features do not apply to Spine resources.

In the **Resource Manager**, select the **png** file and use the Sprite Editor to set the name, position, collision, and ambient light.

\
\
\ <br>

***

* ## Item&#x20;

1. Place the **icon** and **item png** images in the **Icons** folder.

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

2. Select the **icon image** and **Spine image** in **Database > Item**.

<figure><img src="/files/6lxtMmVeLCoWUZ8cHCgc" alt=""><figcaption></figcaption></figure>

* **Icon**: The item icon image that appears in the shop and inventory.
* **Spine Image**: The item image that is placed on top of the Spine character.

3. Select the **item type**.

<figure><img src="/files/46B5HFiL1F97jUMFmujO" alt=""><figcaption></figcaption></figure>

To apply the item as a Spine item, the **item type** and the **slot name in Spine** must be set to the same name.<br>

| Hat       | hat          |
| --------- | ------------ |
| Armor     | armor        |
| Weapon    | weapon       |
| Shield    | shield       |
| Wing      | wing         |
| Shoes     | shoes\_left  |
|           | shoes\_right |
| Ring      | ring\_left   |
|           | ring\_right  |
| Accessory | acc\_left    |
|           | acc\_right   |

***

* ## tip

When modifying and using Spine items from an example file, you need to ensure that the image size and object positions are aligned correctly.

<figure><img src="/files/39PSvmjasb2B3aS9DCsZ" alt=""><figcaption></figcaption></figure>

<br>

\ <br>

<br>

<br>


---

# 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/spine.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.