> For the complete documentation index, see [llms.txt](https://titans.gitbook.io/titans/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://titans.gitbook.io/titans/webhooks.md).

# Webhooks

Configuration

Webhook settings are stored in webhook.json

Example Config

```
{
  "enabled": true,
  "webhookUrl": "https://discord.com/api/webhooks/XXXXXX/XXXXXXXX",
  "bossSpawnTitle": "⚔ A Titan has appeared!",
  "bossSpawnDescription": "**{boss_name}** has spawned at `{world}` ({x}, {y}, {z})! Prepare for battle!",
  "bossDefeatTitle": "🏆 Titan Defeated!",
  "bossDefeatDescription": "{boss_name} was slain by {top_damager}!"
}
```

#### Settings Explained

* **`enabled`**\
  Enables or disables webhook sending entirely.
* **`webhookUrl`**\
  The Discord webhook URL where messages will be sent.
* **`bossSpawnTitle`**\
  The title text shown when a boss spawns.
* **`bossSpawnDescription`**\
  The description text shown when a boss spawns (supports placeholders).
* **`bossDefeatTitle`**\
  The title text shown when a boss is defeated.
* **`bossDefeatDescription`**\
  The description text shown when a boss is defeated (supports placeholders).

### Placeholders

Webhooks support placeholders that get replaced dynamically when the event happens:

| Placeholder           | Description                                   |
| --------------------- | --------------------------------------------- |
| `{boss_name}`         | Display name of the boss                      |
| `{species}`           | Pokémon species (e.g., Togedemaru)            |
| `{level}`             | Boss level                                    |
| `{hp}`                | Boss HP at time of spawn                      |
| `{world}`             | World/dimension where the boss spawned        |
| `{x} {y} {z}`         | Coordinates of the boss                       |
| `{recommended_party}` | Suggested number of players to fight the boss |
| `{top_damager}`       | Player with the highest damage dealt          |
| `{killer}`            | Player who landed the last hit                |
| `{time}`              | Time of event (server local)                  |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://titans.gitbook.io/titans/webhooks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.