GlymeraRevive

GlymeraRevive - Downed State & Co-op Revival

When a player would take lethal damage, they don't die. Instead they go into a downed state with a gravestone at their feet and a countdown timer. A teammate breaks the gravestone — or simply interacts with it — to revive them. If nobody comes in time, they die for real.

---

What is GlymeraRevive?

A co-op revival system inspired by the "downed state" mechanic from games like Left 4 Dead or Apex Legends. Instead of dying on the spot when health hits zero, players are knocked down, immobilised, and stay alive long enough for their team to rescue them.

The downed player is teleported into a hidden limbo space (near the world ceiling) the moment they go down. This stops NPCs from being able to attack them while waiting for rescue - no more bears beating on an immobilised player. Their original death position is remembered, so when revived, they're teleported right back to where they fell.

Includes its own asset pack with two custom items (a Revive Gravestone block and a Bandage healing item) and one custom UI page (the give-up screen).

---

Features

Downed State

• Lethal damage from any source (mobs, players, fall, void) triggers a downed state instead of death: HP forced to 1, movement frozen
• Inventory is kept intact while downed (no items lost during the rescue window)
• A gravestone marker block is spawned at the death position - this is what teammates use to revive
• A HUD page shows the countdown timer and a "Give Up & Respawn" button

Revive by Breaking OR Interacting

• A teammate can break the gravestone or simply interact with it (use key) - both revive the downed player
• The interact path makes revives work in worlds that forbid block breaking - most notably Hytale's native dungeon instances, where blocks can't be broken at all
• Each trigger can be disabled separately in the config; disabling the break trigger also makes the gravestone unbreakable

Aggro-Drop via Limbo Teleport

• The downed player is teleported to a hidden zone near the world ceiling with a floor block placed below them
• All NPCs in the original area naturally lose target lock through Hytale's built-in range filter - no NPC state hacking, no behaviour-tree manipulation
• The original death position is saved server-side. On revive, the player is teleported back exactly where they fell
• The limbo floor is cleaned up automatically when the player is revived or dies

Three Ways Out

• Revive: a teammate breaks or interacts with the gravestone → player wakes up at the original death position with a configurable share of their max HP
• Give Up: the downed player presses the Give-Up HUD button (or triggers their own gravestone) → real death, respawn at world spawn
• Timeout: the countdown reaches zero → real death

Post-Revive Protection

• Right after a revive the player is briefly immune to all damage (configurable, default 3 seconds)
• This closes the window where the reviver's follow-through swing would otherwise instantly re-down or kill the teammate they just rescued

Real Death (Give-Up / Timeout)

• Hytale's normal death pipeline fires: drops animation, respawn at the world spawn
• By default, items are lost according to the world's own GameplayConfig death settings (Hytale default: 50% of stackable items, 10% durability loss)
• Both values can be overridden in the plugin config independently of the world settings

Quit-and-Rejoin Anti-Cheat

• Persistent state file tracks every currently-downed player
• If a downed player quits and rejoins, they're killed on reconnect (no escaping death by closing the client)
• Stale entries on plugin restart are detected and cleaned up automatically

PvP Ready

• Weapon kills on PvP-enabled worlds trigger the downed state exactly like mob damage - including hits whose damage is computed from the weapon's item stats

---

Items

Revive Gravestone

• Custom block, plugin-only - no crafting recipe
• Spawned automatically at the death position when a player goes down
• Uses Hytale's native tombstone model and break decals
• A teammate triggers it to revive, the owner triggers it to give up
• Auto-cleaned up on revive, timeout, or death - only the gravestone block itself is ever touched, surrounding blocks are never modified

Bandage

• Custom item, asset is registered with the plugin (crafting recipe not yet wired up)
• Reserved for a future "self-revive" feature

---

Configuration

plugins/GlymeraRevive/config.json (auto-generated on first run, every entry has a comment right next to it):

Field	Default	Description
downedDurationSeconds	60	How long a player can stay downed before they die automatically
reviveByBreak	true	Breaking the gravestone revives (self-break = give up). false = break trigger off, gravestone can't be broken
reviveByInteract	true	Interacting with the gravestone revives (self-interact = give up). Works in no-block-breaking worlds like dungeons
revivedHealthPercent	25	Percent of max HP a revived player wakes up with (1-100)
reviveProtectionSeconds	3	Seconds of full damage immunity right after being revived (0 = off)
deathItemsLossPercent	-1	Percent of stacked items lost on final death (0-100). -1 = use the world's own GameplayConfig death settings
deathDurabilityLossPercent	-1	Percent of durability lost on final death (0-100). -1 = use the world's own GameplayConfig death settings

---

Installation

1. Place the GlymeraRevive jar in your server's mods/ folder
2. Start (or restart) the server
3. Done. Config is auto-generated on first run.

---

Compatibility

⚠️ GlymeraRevive and GlymeraDeadChest both take control of a player's inventory on death and are not compatible with each other — install one or the other, never both.

Works fine alongside protection/claim plugins: the revive triggers listen to their own gravestone only.

---

How It Works

Downed Flow

1. A player takes lethal damage
2. The plugin intercepts the damage event after armor/stats are applied but before Hytale subtracts health - so no real death ever happens (no item loss, no death animation)
3. HP is set to 1, the player is immobilised, and a gravestone marker is placed at their feet
4. The player is teleported to the hidden limbo zone and shown the countdown HUD

Revive Flow

1. A teammate breaks or interacts with the gravestone
2. The plugin identifies the downed player from the marker, teleports them back to the death position, and cleans up the gravestone and limbo floor
3. The revived player gets their configured share of max HP plus a few seconds of damage immunity

Timeout / Give-Up Flow

1. The timer reaches zero, or the player gives up (HUD button or triggering their own gravestone)
2. Item and durability loss is applied (world settings or your config overrides)
3. Hytale's normal death pipeline fires and the player respawns at the world spawn

---

Good to Know

• Dungeons: native dungeon instances forbid block breaking entirely - that's a Hytale gameplay config, not a bug. The interact trigger was added exactly for this, so revives work inside dungeons out of the box
• Anyone can trigger the gravestone: the plugin assumes you trust your party. Self-trigger by the owner is a deliberate give-up path
• Multiple downed players simultaneously: each player has their own marker, limbo position and timer. They don't interfere with each other
• Death drop behaviour: the plugin applies item/durability loss manually on a final death, consistent with what a normal Hytale death would do (programmatic deaths don't fire Hytale's own drop pipeline)

---

Made with care by Glymera for the Hytale community