SDK recipes

Each recipe starts with a working connection and shows the same job in TypeScript and Python. Copy a program, set the environment variables, and run it against a SoulFire server.

Before you startCopy Anchor Link

Install one SDK:

bun add @soulfiremc/sdk effect @effect/platform

Python requires CPython 3.14 or newer. Set these values for every recipe:

export SOULFIRE_URL="https://soulfire.example.com"
export SOULFIRE_TOKEN="your-api-token"
export SOULFIRE_INSTANCE_ID="your-instance-uuid"
export SOULFIRE_BOT_ID="your-bot-uuid"

The recipes use TypeScript Effect and Python effect-py. See the TypeScript guide or Python guide for runtime setup and scoped cleanup.

Pick a jobCopy Anchor Link

• Reply to chat when a player sends a message.
• Collect blocks and wait for the durable task to finish.
• Follow the entity under the cursor with a connection safe reference.
• Move items through a container and close the menu safely.