ItemSellPost.xml

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#

<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 `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