Chases one entity and attacks it until it's defeated or maximumAttacks is
reached.
Attacks the nearest entity matching selector within radius, then the
next, up to maximumTargets.
Keeps the best armor the bot has equipped.
Eats when the food level drops to foodLevel. An empty foodItemIds (the
default) eats any safe food.
Respawns after each death.
Keeps a totem of undying in the offhand.
maintainLoadout once: a single rebalance, done when satisfied.
Feeds pairs of adult animals until the server confirms both are in love mode.
Brews count potion bottles matching input, using one ingredient per
bottle. count defaults to 1, at most 4096.
Places blocks, each at origin plus its offset. At most 8192 blocks.
Start block collection and return a typed handle after acceptance.
Block IDs or #-prefixed tags, as one string or an array.
Additional tags, block count, search distance, and scheduling options.
An Effect that produces the collection task handle.
const task = yield* bot.tasks.collectBlocks([], {
tags: ["minecraft:logs"],
count: 16,
});
const result = yield* task.result();
recipeId comes from recipes.list, e.g. "display:42", and must be a
minecraft:crafting_shaped or minecraft:crafting_shapeless recipe.
count is recipe operations, not output items; it defaults to 1, at most
4096.
Clears every diggable block in the cuboid from from to to, both
included. At most 32,768 blocks.
Visits unexplored cells around origin.
Harvests mature crops around center and replants the ones that need it.
Casts, waits for a bite, reels in, and repeats.
Moves away from the nearest threat until it is safeDistance away.
Keeps within distance of an entity as it moves. distance defaults to 3.
One of this bot's tasks, by id.
OptionalresultSchema: ResultOptionaloptions: CallOptionsStart durable navigation and return its typed handle after acceptance.
Arrival condition, usually built with goals.
Pathfinding and scheduling configuration.
An Effect that produces a task handle. Use task.result() for arrival.
runGoTo for progress with stream ownership.
Defends position from threats.
This bot's tasks, all pages. Ended tasks only with includeTerminal.
Keeps each requirement's count in range by withdrawing from and depositing
to container.
Defends an entity from threats.
Shoots an entity with a bow or crossbow from between minimumRange and
maximumRange, leading the target and aiming for the arrow's drop.
Submit a task and stream progress with RPC ownership.
Protobuf schema for the task input.
Task configuration.
Scheduling and request options. disconnectPolicy defaults
to CANCEL_WITH_CALL, rather than the server's unspecified policy.
A lazy Stream of task events. Consumption starts the job.
An empty foodItemIds (the default) eats any safe food.
count is bottles to brew; it defaults to 1, at most 4096.
Collect matching blocks and stream progress with cancellation ownership.
Block IDs or tags prefixed with #.
The same selector and pathfinding options as collectBlocks.
A lazy Stream. Interruption cancels unfinished work by default.
recipeId comes from recipes.list, e.g. "display:42", and must be a
minecraft:crafting_shaped or minecraft:crafting_shapeless recipe.
count is recipe operations, not output items; it defaults to 1, at most
4096.
distance defaults to 3.
Navigate to a goal and stream task updates until execution ends.
Arrival condition, usually built with goals.
Pathfinding and scheduling configuration.
A lazy progress Stream. Interruption cancels unfinished work by default.
goTo for a handle with explicit ownership.
count is input items to cook; it defaults to 1, at most 4096.
count is trades to make; it defaults to 1, at most 4096.
Walks to a bed and gets in.
input selects items that fit a known cooking recipe. count is input
items to cook; it defaults to 1, at most 4096.
Submit a protobuf task input and return a handle after acceptance.
Protobuf schema for the task input.
Task configuration, before protobuf serialization.
OptionalresultSchema: Result
Matching protobuf schema used to decode task.result().
Scheduling, lifecycle, deadline, and request configuration.
An Effect that produces a typed task handle.
This operation does not wait for completion or register a cancellation finalizer. Use run for stream ownership or cancel the handle explicitly.
Walks to the container, opens it and puts the items in.
Trades with the merchant menu the bot has open. offerIndex is the
zero-based index from recipes.listVillagerTrades. count defaults to 1,
at most 4096.
Events of this bot's tasks, starting with a snapshot of them unless
includeSnapshot is false.
Optionaloptions: {Walks to the container, opens it and takes the items out.
Start and observe durable server jobs for one bot.
Access this API through SoulFireBot.tasks. Named start methods return SoulFireTask after acceptance. Use
yield* task.result()for successful completion.run*methods instead stream events with cancellation tied to RPC ownership by default.Remarks
A call timeout limits transport work. A task deadline limits server execution. For submission retries, reuse an idempotency key to avoid duplicate work.