# DieOn

This module causes a player to die or vaporize when they use or drop a custom item, based on configurable conditions. It allows specifying a custom death message and whether the player should vaporize.

| Value          | Description                                                                                                                                                                                                          |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DeathMessage` | The message displayed when the player dies. The placeholder `%name%` will be replaced with the custom item's configured name.                                                                                        |
| `Vaporize`     | If `true`, the player will vaporize instead of just dying. If `false`, they will die and display the `DeathMessage`.                                                                                                 |
| `Trigger`      | Specifies when the module's effect should trigger. Possible values are `OnUse` (when the item is used) and `OnDropped` (when the item is dropped). Note that only one trigger can be configured per module instance. |

### Example

```yaml
custom_modules:
  DieOn:
  - DeathMessage: "You were too clumsy with %name%!"
    Vaporize: false
    Trigger: OnDropped
  - DeathMessage: "You vaporized into thin air after using %name%!"
    Vaporize: true
    Trigger: OnUse
```


---

# Agent Instructions: 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:

```
GET https://docs.uci.ucserver.it/uncomplicatedcustomitems/prerelease-content/custommodules/dieon.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.