> For the complete documentation index, see [llms.txt](https://kings-of-earth.gitbook.io/kings-of-earth-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kings-of-earth.gitbook.io/kings-of-earth-wiki/guides/plugins/death-plugin.md).

# Death Plugin

All information about Meowar1's Death Plugin.

Death Plugin is an open-source custom plugin made for Kings of Earth that is designed to increase the difficulty of survival in Minecraft.\
\
Kings of Earth uses the latest edition of Death Plugin (vigor).

## Overview

{% embed url="<https://www.youtube.com/watch?v=VYk6RuI69-s>" %}
Full plugin showcase
{% endembed %}

## Mechanics

The plugin rewards player activity while increasing the difficulty of the server similar to that of Hardcore mode. Players are given vigor for completing daily logins and voting which is the currency required to be able to respawn. Players who lack enough vigor to respawn are banned for 24 hours (which is referred to as being vigor-banned).

### Vigor

Vigor is the currency that runs the plugin. It is required in order for the player to be able to respawn.

Vigor also has the option to be exchanged into physical items (configurable by server OPs).

### Death Bans

If a player lacks the sufficient amount of vigor to be able to pay the death penalty (configurable through the config file), the player will not be able to respawn and will be vigor-banned from the server for 24 hours.

### Reviving

Players who are vigor-banned can be revived by a player who is still alive for a certain amount of vigor (configurable through the config file).

Only players who have been banned by this plugin (vigor-banned) can be unbanned using the /revive command.

Players who are successfully revived will bypass the 24-hour ban and can rejoin the server instantly.

## Death Plugin Commands

{% code overflow="wrap" %}

```java
/exchange

//Hold vigor shard(s) in your hand while executing this command to transfer vigor from physical form to virtual form.
```

{% endcode %}

{% code overflow="wrap" %}

```java
/exchangelist

// Displays all possible exchanges that can be done with vigor.
```

{% endcode %}

{% code overflow="wrap" %}

```java
/exchange vigor <amount>

// Converts virtual form vigor into physical form vigor.
// [amount] = the number of vigor you want to convert into physical form (minimum value of 1).
```

{% endcode %}

<pre class="language-java" data-overflow="wrap"><code class="lang-java">/exchange totem &#x3C;amount>

// Command used to purchase totems of undying.
<strong>// [amount] = the number of totems you want to buy (minimum value of 1).
</strong><strong>// Payment must be done using virtual form vigor.
</strong></code></pre>

{% code overflow="wrap" %}

```java
/revive <username>

// Revive players who have been vigor-banned for 5 vigor.
// Vigor must be in virtual form to pay.
```

{% endcode %}

{% code overflow="wrap" %}

```java
/vigor

/deathmoney

// Checks your vigor balance.
// Amount displayed only displays how much virtual form vigor you have.
```

{% endcode %}

{% code overflow="wrap" %}

```java
/vigorsend <username> <amount>

/deathmoneysend <username> <amount>

// Send players virtual form vigor with this command.
// [amount] = the amount of vigor you want to send to the user.
```

{% endcode %}

{% code overflow="wrap" %}

```java
/addexchangeitem <name> <value>

/deathplugin:aei <name> <value>

// Admin config command
```

{% endcode %}

## Plugin Links

{% embed url="<https://github.com/Meowar1/DeathPlugin>" %}
Death Plugin GitHub Source
{% endembed %}

## Plugin Creator

{% embed url="<https://github.com/Meowar1>" %}
Plugin creator (neko-chan ^-^)
{% endembed %}

*We want to thank Neko for taking the time to create this plugin for us. She is a very talented and kind person and we would encourage anyone reading this to check out her other projects.*\
\- KoE Staff

### Other Creator Projects

{% embed url="<https://yestrad.de/>" %}
New server project
{% endembed %}

{% embed url="<https://www.lezora-roleplay.de/>" %}
Old server project
{% endembed %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://kings-of-earth.gitbook.io/kings-of-earth-wiki/guides/plugins/death-plugin.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
