# Yolo – A hardcore plugin<\/p>\n
—<\/p>\n
\n
\n
\n<\/p>\n
—
\n## Content<\/p>\n
1. [What does this plugin do?](#1-what-does-this-plugin-do)
\n2. [Configuration](#2-configuration)
\n 1. [`config.yml`](#21-configyml)
\n 2. [`chat_messages.properties`](#22-chatmessagesproperties)
\n 3. [`discord\/[…].json`](#23-discordjson)
\n 4. [`ban_message.txt`](#24-banmessagetxt)
\n 5. [Text replacements](#25-text-replacements)
\n3. [Permissions](#3-permissions)
\n4. [Commands](#4-commands)
\n5. [Further considerations](#5-further-considerations)
\n6. [Planned features](#6-planned-features)
\n7. [For developers](#7-for-developers)<\/p>\n
—<\/p>\n
## 1. What does this plugin do?<\/p>\n
You only live once… the name says it all.<\/p>\n
This plugin is meant for hardcore survival servers, that implements, but also expands on the vanilla hardcore
\nmechanics for a player’s death on a server.
\nUpon death players usually get banned off of a server, if (and only if) the setting for hardcore was enabled in
\n`server.properties` before world generation.<\/p>\n
That is not the case if this setting was set to true retroactively.<\/p>\n
And here is, where this plugin comes into play, by
\nimplementing this behaviour regardless of when hardcore was enabled.<\/p>\n
Additionally, you can exempt players from this rule
\nand send a customized message to a Discord-server upon the occurrence of a (non-exempt) player-death.<\/p>\n
The plugin can also force a resource-pack of your choice, with the default one replacing the normal health-bar with
\nhardcore-hearts, on any non-exempt player.<\/p>\n
(*You can check out the resource-pack
\nhere.*)<\/p>\n
## 2. Configuration<\/p>\n
### 2.1 `config.yml`<\/p>\n
There are currently four configuration sections.
\nThe first one is for managing the resource-pack sent to non-exempt players:<\/p>\n
“`yaml
\n# You can specify a custom resource pack and turn off forcing the pack onto non-exempt players.
\nresource-pack:
\n force: true
\n custom:
\n use: false
\n url: “”
\n sha1: “”
\n“`<\/p>\n
– The `force` option lets you control, whether the player *has* to accept the pack. (Allowed values: `true`, `false`)
\n– `custom` lets you define a custom resource-pack, other than the default one.
\n – `use`: Set to `true` to use the custom pack, otherwise set it to `false`
\n – `url`: The download-link to the custom pack.
\n – `sha1`: The sha1-checksum of the file. You can use
\n this tool to obtain it.<\/p>\n
The next section is for configuring the Spicord integration:<\/p>\n
“`yaml
\nspicord:
\n send: false
\n message_channel_id: “”
\n“`<\/p>\n
– `send`: Whether to enable the Spicord-Integration. (Allowed values: `true`, `false`)
\n– `message_channel_id`: The id of the channel to send the message to. You can obtain it using
\n this method
\n(you can also obtain the channel-id by itself, by right-clicking the channel on the channel-selection-sidebar).<\/p>\n
In the `announce` section you can individually toggle messages:<\/p>\n
“`yaml
\nannounce:
\n death:
\n discord: false
\n chat: true
\n totem:
\n discord: false
\n chat: true
\n revive:
\n discord: false
\n chat: true
\n“`<\/p>\n
This should be pretty self-explanatory.<\/p>\n
The listed messages are announcements that would be sent on their respective occasions and targets.<\/p>\n
The allowed values are `true` or `false`.<\/p>\n
The option `enable-on-non-hc` lets you enable this plugin’s functionality even on a non-hardcore server, while the last
\noption `easy-disable` lets you disable the death-ban functionality, if it’s `true` (previously dead players can join, if
\nthis is enabled).
\nIt may take a while before banned players can join if this option is true.<\/p>\n
Yet again acceptable values (for both) are `true` and `false`.<\/p>\n
### 2.2 `chat_messages.properties`<\/p>\n
The messages defined in this file are chat messages that can be customized.<\/p>\n
There shouldn’t be a need to add more.
\nYou can also use the MiniMessage format to make them *special*.<\/p>\n
How you can use this format, you can read here.<\/p>\n
### 2.3 `discord\/[…].json`<\/p>\n
In these files, you can customize the embeds, sent by the plugin.<\/p>\n
You can use this tool to visualize them and generate the json file.<\/p>\n
If, for example, you’d like to customize the discord message, that is getting sent upon a player’s death, you’d need to
\nmodify `plugins\/yolo\/discord\/death_message.json` to something like this:<\/p>\n
“`json
\n{
\n “embed”: {
\n “title”: “%player_name% has died!”,
\n “description”: “Press “F” to pay respect.”,
\n “color”: 16521991,
\n “author”: {
\n “name”: “author name”,
\n “url”: “https:\/\/discordapp.com”,
\n “icon_url”: “https:\/\/cdn.modrinth.com\/data\/ExWUwvY3\/a8ab710896279f5c3ed9c377d408a10587f5509d.png”
\n },
\n “image”: {
\n “url”: “https:\/\/media.tenor.com\/bMbIAroA0PkAAAAi\/rip-rest.gif”
\n }
\n }
\n}<\/p>\n
“`<\/p>\n
### 2.4 `ban_message.txt`
\nThis is where you can customize the ban message that players see when they’re dead.<\/p>\n
### 2.5 Text replacements
\nEvery message that gets sent by the Plugin can use the following replacements:
\n– `%player_name%` – The name of the affected player
\n– `%totem_uses%` – The number of totems the subject player of the message has used.
\n– `%death_message%` – The death message, if the player has died. (only available in messages, sent upon a
\nplayer’s death.)
\n– `%version%` – The current version of the plugin.<\/p>\n
## 3. Permissions<\/p>\n
One permission is `yolo.exempt`, which excludes any players having it from the plugin’s effects. There are also two
\nother permissions that relate to commands. These are described in the section about [commands](#4-commands).
\nFor a general guide to permissions on Bukkit and its derivatives, please refer to
\nthis page. *(I’d recommend using a permission manager like
\nLuckPerms though.)*<\/p>\n
## 4. Commands<\/p>\n
There are currently two commands available:<\/p>\n
– `\/yolo-reload`: This command is useful for reloading all configuration dependent features of this plugin, without ## 5. Further considerations<\/p>\n – If hardcore is enabled in `server.properties`, the resource pack is always forced upon players by default. ( “`toml – **This plugin was made for PaperMC-1.19.4.** Other versions and platforms haven’t been tested *yet*, but this is ## 6. Planned features<\/p>\n – Commands to undo a player’s revive ## 7. For developers To avoid inflating your jar-file, you can change the scope to `compileOnly`.<\/p>\n Additionally, you’ll need to declare the dependency in your `plugin.yml`-file like this: You can find the documentation here.<\/p>\n —<\/p>\n *From Version: 0.7.0*<\/p>\n","protected":false},"excerpt":{"rendered":" You only live once… the name says it all.<\/p>\n This plugin is meant for hardcore survival servers, that implements, but also expands a bit on the vanilla hardcore mechanics for a player’s death on a server.<\/p>\n","protected":false},"featured_media":173186,"template":"","meta":{"_minecraft_slug":"yolo","_minecraft_project_id":"ExWUwvY3","_minecraft_author":"eingruenesbeb","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":898,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"yolo.zip","_minecraft_size_bytes":975868,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T08:57:46.157089Z","_minecraft_date_created":"2023-03-14T01:42:48.858692Z","_minecraft_date_modified":"2023-06-16T13:42:03.296784Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/yolo","_minecraft_icon_attachment_id":173186,"_minecraft_imported_at":"2026-06-09T22:36:07+00:00","_minecraft_import_hash":"82e268618bc4585e0f713501517a61b8","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,128,92],"mod_loader":[132,133],"minecraft_version":[54,55,56,57,58,59,36],"class_list":["post-173185","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1"],"yoast_head":"\n
\n having to restart the whole server. It requires the `yolo.reload` permission.
\n– `\/revive [revivable player]
\nplayer who has died, attempting to restore their inventory and teleporting them to their death location (if safe). It
\nrequires the `yolo.revive` permission. You can also disable restoring their inventory and the teleportation, by setting
\nthe arguments to `false`. (If you only want to disable the teleport, you need to explicitly set the inventory restoring
\nto `true`.)
\n– `\/checkout_death_location` This command lets you teleport to a dead player’s death location. This is useful for
\nchecking for traps and duplicate items. It requires the `yolo.revive` permission.<\/p>\n
\n configurable since: 0.4.0)
\n– In order to use Spicord, you have to configure it correctly. In order to register this plugin as an addon for a bot,
\n you have to add it like this:<\/p>\n
\n### \u2191 Irrelevant stuff above \u2191 ###
\n[[bots]]
\nname = “” # Name for the bot here.
\nenabled = true
\ntoken = “” # Your bot’s token here
\ncommand_support = true # Irrelevant for this plugin’s Spicord addon.
\ncommand_prefix = “-”
\naddons = [
\n # Potentially other addons.
\n “yolo”
\n]
\n### \u2193 Other irrelevant stuff below \u2193 ###
\n“`<\/p>\n
\n planned
\n to be completed until the full release. Issues for incompatibility can
\n be submitted, but will not be resolved if
\n this means dropping support for other compatible versions.
\n– Reviving a player with inventory restoring enabled, can lead to item duplication, as players still drop their items.
\nYou may want to check out the teleport location with `\/checkout_death_location` first, in order to check for duplicates.
\n– This is a pre-release version, so bugs or glitches may be encountered more often.<\/p>\n
\n– GUI for the revive-system (planned for 2.0)
\n– Full support for PlaceholderAPI (planned for 2.0)
\n– Death location marker on Dynmap, Bluemap and co. (planned for in 2.0)
\n– Have a suggestion? Submit it here!<\/p>\n
\nTo add this project as a dependency for yours, follow this link and select
\nyour desired version (go to *branches* \u2192 *master-SNAPSHOT* for the most recent version). Then follow the instructions
\nbelow.<\/p>\n
\n“`yml
\n#### \u2191 other stuff \u2191 ###
\ndepend: [ # Or `softdepend`
\n Yolo
\n]
\n#### \u2193 other stuff \u2193 ###
\n“`<\/p>\n