> 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/honey/block.md).

# Block Serializer

Serializer ID: `resourcefulbees:block/v1`

This optional serializer controls the custom honey block's appearance, movement behavior, and optional beekeeper trade data. The registered honey block and its block item are derived from the honey filename rather than configured by serializer fields.

## Fields

| Field         | Type                 | Required | Default                              | Range / notes                                     |
| ------------- | -------------------- | -------- | ------------------------------------ | ------------------------------------------------- |
| `color`       | ResourcefulLib color | No       | `#ffffff`                            | Number, color string/special name, or RGBA object |
| `jumpFactor`  | number               | No       | `0.5`                                | No additional codec range supplied                |
| `speedFactor` | number               | No       | `0.4`                                | No additional codec range supplied                |
| `tradeData`   | trade object         | No       | serializer-level `TradeData.DEFAULT` | See omitted-vs-explicit behavior below            |

## Example

```json
{
  "resourcefulbees:block/v1": {
    "color": "#f6b83f",
    "jumpFactor": 0.5,
    "speedFactor": 0.4
  }
}
```

The honey identifier, registered honey block, and its block item are derived from the filename. There are no block or block-item identifier fields in `resourcefulbees:block/v1`.

## Serializer default vs explicit object

The entire block serializer is optional. If it is absent, Resourceful Bees uses its serializer-level block default internally.

`tradeData` has a second important distinction: omitting `tradeData` uses `TradeData.DEFAULT` (the non-tradable/zero-valued serializer default), while explicitly writing an empty object causes the trade codec's own field defaults to apply.

```json
"tradeData": {}
```

is therefore not semantically identical to omitting `tradeData`.