# Gesture properties

These are the properties that you can use when configuring a gesture:

```yaml
gestures:
  gesture_id:
    display_name: "Gesture Name"
    permission: "magicgestures.gestures.new_gesture"
    font: ''
    can-move: false
    move-speed: 0.10
    cosmetic: 'cosmeticId'
    equipment:
      head: "oraxen:item_id_1:" #The item ID of the Oraxen item
      left: "itemsadder:item_id_2:" #The item ID of the ItemsAdder item
      right: "vanilla:STONE:-1:false" #The name of the material, the CustomModelData and finally if the item will have glow
    animations:
      start: magicgestures.gestures.sus_start
      idle: magicgestures.gestures.sus_idle
      end: magicgestures.gestures.sus_end
```

`display_name:` The name that the gesture will have in the menu

`permission:` The permission needed by the player to access this gesture.

`font:` This font will represent the gesture icon in all menus.

`can-move:` this option will decide whether your gesture will move or not.

`move-speed:` this option will apply the movement speed of your gesture if it can move.

`cosmetic:` If this option is set it will make the gesture unusable until they have the cosmetic id equipped.

`equipment:` This option allows you to set default items in the available slots.

`animations:`\
&#x20;     `start:` this option defines the start animation (can be omitted)\
&#x20;     `idle:` this option defines the idle animation (cannot be omitted)\
&#x20;     `end:` this option defines the ending animation (can be omitted)


---

# 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://francobm.gitbook.io/magicgestures/gesture-creation/config/gesture-properties.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.
