---
title: "Packet 7: PaintBlockPacket"
description: "Requests a block colour mutation. The server validates the paint tool, range, and voxel solidity, then journals the authoritative RGB change for late joiners."
canonical: "https://aosplay.net/protocol-168/packets/7"
markdown: "https://aosplay.net/docs/protocol-168/packets/7.md"
last_updated: "2026-07-16"
protocol: "Ace of Spades Battle Builder 168"
packet_id_decimal: "7"
packet_id_hex: "0x07"
direction: "C→S"
family: "Building"
implementation_status: "Handled"
evidence: "Implementation-backed"
wire_size: "14 bytes"
---

# Packet 7: PaintBlockPacket

> Requests a block colour mutation. The server validates the paint tool, range, and voxel solidity, then journals the authoritative RGB change for late joiners.

- **Decimal ID:** 7
- **Hex ID:** 0x07
- **Direction:** C→S
- **Family:** Building
- **Status:** Handled
- **Evidence:** Implementation-backed
- **Wire size:** 14 bytes

## Exact wire layout

The application packet ID is the first byte. The remaining rows are in decode order. Byte sizes exclude ENet headers, wrapper prefixes, LZF chunk framing, and compression effects.

| # | Field | Encoding | Bytes | Purpose | Condition |
| ---: | --- | --- | ---: | --- | --- |
| 0 | `packet_id` | u8 | 1 | Always 7 (0x07). | — |
| 1 | `loop_count` | i32 LE | 4 | Simulation-loop stamp used for ordering, prediction, or reconciliation. | — |
| 2 | `x` | i16 LE | 2 | x value. | — |
| 3 | `y` | i16 LE | 2 | y value. | — |
| 4 | `z` | i16 LE | 2 | z value. | — |
| 5 | `color` | BGR888 | 3 | Three colour channels written blue, green, then red. | — |

## Encoding conventions

- `LE` means least-significant byte first.
- `fixed16` is two-byte sign-magnitude at 1/64 precision.
- `orientation16` uses the measured 1/8192 orientation mapping.
- NUL strings consume their encoded byte length plus one `00` terminator.
- Counted arrays repeat immediately in the documented order.

## Related resources

- [HTML packet page](https://aosplay.net/protocol-168/packets/7)
- [Complete packet catalog](https://aosplay.net/protocol-168/packets)
- [Packet catalog in Markdown](https://aosplay.net/docs/protocol-168/packets.md)
- [Protocol 168 guide](https://aosplay.net/protocol-168)