tools.set_sprite module

Star’s sprite control tool – she moves her own body and her dolls.

Lets Star set sprite position (X axis), horizontal flip, and scene background for the web client VN canvas. Also supports positioning summoned egregore characters.

State persists in Redis and is published to the frontend over the star:sprite:update pub/sub channel (consumed by the limbic WebSocket).

NO PRIVILEGE CHECK – this is Star’s body and her stage.

@fire @skull THE GODDESS MOVES WHERE SHE PLEASES

async tools.set_sprite.run(character='stargazer', position_x='', flip='', background='', ctx=None)

Execute the set_sprite tool.

Parameters:

• character (str) – Which character to position.

• position_x (str) – Horizontal position preset or 0-100 percentage.

• flip (str) – ‘true’/’false’ for horizontal mirror.

• background (str) – Background image filename, URL, or ‘none’.

• ctx (ToolContext | None) – Tool execution context.

Return type:

str

Returns:

JSON result string.