> For the complete documentation index, see [llms.txt](https://plugins.phbot.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://plugins.phbot.org/phbot-api/alchemy.md).

# Alchemy

## start\_alchemy

Starts alchemy

**Usage**

`start_alchemy()`

**Returns**

`True` or `False` if the function succeeded or not

## stop\_alchemy

Stops alchemy

**Usage**

`stop_alchemy()`

**Returns**

`True` or `False` if the function succeeded or not

## reset\_alchemy

Clears the alchemy queue

**Usage**

`reset_alchemy()`

**Returns**

`True` or `False` if the function succeeded or not

## add\_alchemy(dict)

Adds an item to the alchemy queue

**Usage**

```
add_alchemy({
    'type': 'plus',
    'slot': 13,
    'stop': 5,
    'success': 2000,
    'failure': 5000,
    'powder': 0,
    'astral': -1,
    'steady': -1,
    'immortal': -1,
    'lucky': -1,
    'stop_attempt': 100,
    'stop_destroyed': 1,
    'skip_fail': 0
})
```

**Returns**

`True` or `False` if the function succeeded or not

## alchemy\_update(slot, success, plus)

This event is sent to all plugins after an elixir is used on an item.

**Example**

`def alchemy_update(slot, success, plus):`