SoulFire LogoSoulFire

Click container button

Clicks a container-specific action button. Used for: stonecutter recipes, enchanting, loom patterns, villager trades, beacon effects, crafter slot toggles, lectern page navigation. The action is queued and executed on the next game tick.

POST
/v1/instances/{instance_id}/bots/{bot_id}/container/buttons/{button_id}:click

Clicks a container-specific action button. Used for: stonecutter recipes, enchanting, loom patterns, villager trades, beacon effects, crafter slot toggles, lectern page navigation. The action is queued and executed on the next game tick.

Authorization

AuthorizationBearer <token>

Preferred API authentication. Use a JWT with the api audience.

In: header

Path Parameters

instance_id*string

The UUID of the SoulFire instance containing the bot.

Formatuuid
bot_id*string

The profile UUID of the bot clicking the button.

Formatuuid
button_id*integer

The button ID to click. Valid values depend on container type:

  • Stonecutter: 0-99 (recipe index)
  • Enchanting table: 0-2 (enchantment slot)
  • Loom: 0-99 (pattern index)
  • Villager: 0 to (offer count - 1)
  • Beacon: mob effect registry ID, -1 for confirm
  • Crafter: 0-8 (slot toggle index)
  • Lectern: 1=prev page, 2=next page, 3=take book
Formatint32

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/container/buttons/0:click"
{  "success": true,  "error": "string"}

How is this page?

Send a raw Minecraft packet POST

Previous Page

Click dialog button POST

Clicks a button in the current dialog. Button index depends on dialog type (see BotClickDialogButtonRequest). The dialog is typically closed after the button click. Note: Full dialog button packets are not yet implemented; this clears local state.