# Balloons

Config file:

* `config/dawncosmetics/cosmetics/balloons.json`

## What Goes In A Balloon Entry

* `name` for the menu name
* `permission` for the access node
* `icon` for the menu item
* `item` for the in world balloon item
* `anchor` for the side anchor mode
* `offset` for the balloon position
* `rotate` to spin the balloon
* `rotation_speed` for spin speed
* `model` for an optional model setup
* `price` for shop price
* `rarity` for shop rarity
* `unlocked_lore` for lore when unlocked
* `locked_lore` for lore when locked

## `anchor`

Supported values:

* `left`
* `right`
* `center`

If you leave `anchor` out, DawnCosmetics keeps the older legacy offset behavior.

If you use `left`, `right`, or `center`, the offset becomes player relative, which makes shoulder hugging setups much easier.

## Example

```json
{
  "balloons": {
    "pokeball_balloon": {
      "name": "Pokeball Balloon",
      "anchor": "left",
      "icon": {
        "item": "dawncosmetics:pokeball_balloon"
      },
      "item": {
        "item": "dawncosmetics:pokeball_balloon"
      },
      "offset": [0.08, 0.36, -0.36],
      "rotate": true,
      "rotation_speed": 2.0
    }
  }
}
```

## Good To Know

* use `left` or `right` when you want the balloon off one shoulder
* use negative `z` to pull the balloon farther behind the player
* start small, then tune from there


---

# 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://dawnshade.gitbook.io/dawnshade-docs/docs/dawn-cosmetics/summary/cosmetic-types/balloons.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.