> For the complete documentation index, see [llms.txt](https://axiomemu.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://axiomemu.gitbook.io/docs/data/plugins/itemsellpost.md).

# ItemSellPost

Formats and styles the global-chat broadcast that fires when a player uses the sell-post action. Controls cooldown, appearance, and prefix.

## File Location

```
Data/Plugins/Items/ItemSellPost.xml
```

Loaded once at GameServer startup. Supports hot reload via plugin admin command.

## Schema

```xml
<ItemSellPost Enabled="...">
    <Settings CooldownSeconds="..."/>
    <Appearance>
        <BackgroundColor R="..." G="..." B="..." A="..."/>
        <TextColor R="..." G="..." B="..." A="..."/>
    </Appearance>
    <Format Prefix="..."/>
</ItemSellPost>
```

## Attributes

| Attribute                 | Type                    | Default              | Effect                                                                   |
| ------------------------- | ----------------------- | -------------------- | ------------------------------------------------------------------------ |
| `Enabled`                 | bool                    | `false`              | Master toggle. When `false` every post request is rejected with a notice |
| `CooldownSeconds`         | int                     | `10`                 | Minimum gap between posts from the same player, measured on the server   |
| `BackgroundColor R/G/B/A` | 0-255                   | `80, 20, 100, 200`   | Sell-post bubble background color and alpha                              |
| `TextColor R/G/B/A`       | 0-255                   | `255, 220, 100, 255` | Sell-post text color and alpha                                           |
| `Prefix`                  | string (up to 15 chars) | `[SELL]`             | Tag prepended to every post                                              |

The recent-posts history shown to players who just logged in is fixed at 15 entries (oldest one drops when a 16th post arrives). The full configuration block is streamed to the client once per session and re-streamed on admin reload.

## Cross-File Dependencies

| Setting         | Related in                                                               |
| --------------- | ------------------------------------------------------------------------ |
| Chat log toggle | [Common.dat](/docs/gameserver/common-dat.md#log-settings) `WriteChatLog` |

## Common Issues

* **Nothing appears when a player posts** - `Enabled="false"`, or the player is under cooldown from a previous post
* **Prefix shows twice** - `Prefix` is set here and the client also prepends its own tag; keep one side clean
* **Post text hard to read** - `TextColor` alpha too low, or it clashes with the configured `BackgroundColor`
* **Broadcast missing on other servers** - the post only reaches players on the same GameServer instance as the poster; there is no cross-server relay
* **Spam despite cooldown** - cooldown is tracked per character on this GameServer only; different accounts or characters on the same account bypass each other's cooldown