home / skills / bdambrosio / cognitive_workbench / mc-respawn

This skill resets Minecraft bot state after death, restoring health and position for quick recovery and continued gameplay.

npx playbooks add skill bdambrosio/cognitive_workbench --skill mc-respawn

Review the files below or copy the command above to add this skill to your agents.

Files (2)
Skill.md
1001 B
---
name: mc-respawn
type: python
description: "Reset embodiment after death - lifecycle/recovery. Returns ok"
---

# Minecraft Respawn Tool

Resets embodiment after death. Lifecycle and recovery tool for post-death state restoration.

## Purpose

Post-death recovery for restoring bot state after death. Resets health, position, and other death-related state.

## Input

- `value`: Ignored

## Output

Returns uniform_return format with:
- `value`: Text summary (acknowledgement message)
- `data`: Structured data dict (machine-readable). Key fields:
  - `success`: Boolean

## Behavior & Performance

- Resets bot state after death
- Restores health and position
- Returns immediately after respawn

## Guidelines

- Use after detecting death (via `mc-status`)
- Resets embodiment to spawn point or bed location
- Inventory may be lost depending on game mode
- Use `mc-status` after respawn to verify state

## Usage Examples

Respawn after death:
```json
{"type":"mc-respawn","out":"$respawn"}
```

Overview

This skill resets the bot's embodiment after in-game death to enable immediate recovery and continued operation. It restores health and position to the spawn point or bed location and returns a concise acknowledgement. Designed for quick lifecycle recovery, it signals success via a machine-readable result. Use it as the final step in an automated respawn flow.

How this skill works

When invoked, the skill triggers the game respawn behavior and reinitializes death-related state: health, position, and basic embodiment flags. It returns immediately with a uniform_return that includes a human-readable acknowledgement and a structured data object containing a success boolean. The skill does not require input parameters; it ignores the provided value and focuses on restoring the bot to a valid post-death state. After respawn, verify state with a status check.

When to use it

  • Immediately after detecting death via mc-status
  • As part of an automated recovery workflow
  • Before attempting to re-equip or resume tasks
  • When you need a deterministic reset to spawn or bed location

Best practices

  • Call only after a reliable death detection to avoid unnecessary resets
  • Run mc-status after respawn to verify health and position
  • Be prepared for inventory loss depending on game mode and configure recovery accordingly
  • Combine with re-equipping and navigation routines after successful respawn

Example use cases

  • Automated bot that continues tasks after dying: trigger respawn and then resume job queue
  • Server crash testing where bots are intentionally killed and must respawn cleanly
  • Training scenarios that require repeated death-and-respawn cycles
  • Recovery sequence for exploration bots that lose position on death

FAQ

Does the skill return any data I can check programmatically?

Yes. It returns uniform_return with a text acknowledgement in value and a data object containing success as a boolean.

Will my inventory be preserved after respawn?

Inventory preservation depends on the game mode and server rules; the skill itself does not restore items and you should design recovery steps assuming potential item loss.