> For the complete documentation index, see [llms.txt](https://developers.wiki.resourcefulbees.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.wiki.resourcefulbees.com/formats/bees/traits.md).

# Trait Serializer

Serializer ID: `resourcefulbees:trait/v1`

The bee trait serializer assigns reusable trait definitions to a bee and controls the range used by aura-style behavior.

## Fields

| Field       | Type             | Required | Default | Range / accepted forms  |
| ----------- | ---------------- | -------- | ------- | ----------------------- |
| `auraRange` | integer          | No       | `10`    | `3` through `20`        |
| `traits`    | array of strings | No       | `[]`    | Trait identifiers/names |

## Example

```json
{
  "resourcefulbees:trait/v1": {
    "auraRange": 10,
    "traits": [
      "resourcefulbees:fireproof"
    ]
  }
}
```

The standalone custom-trait JSON format is documented separately under [Traits](/formats/traits.md). This serializer only assigns those traits to a bee.