donutbeds

Title: RespawnPoint — Folia‑safe custom respawn points

Subtitle: Right‑click a bed to set a personal respawn point; if none is set, respawn at a random location inside the world border. Built for Folia (region‑aware, no global state, async storage).

---

BODY:

RespawnPoint

Set custom respawn points by right‑clicking any bed. If you haven't set one, you'll respawn at a random location within the world border instead of the default spawn.

Features

• Right‑click a bed to save your personal respawn point (vanilla sleep is cancelled).
• On death: teleport to your saved bed, or fall back to a random location within the configured world border.
• Safe Y calculation so you don't spawn underground.
• Async storage: YAML by default, optional MySQL.
• Folia‑first: uses entity/region schedulers, async data access, and no global state.
• Admin commands to inspect or clear players' respawn points and hot‑reload config.

How to use

Players: Right‑click a bed. Done. On death you'll go there. If you never set one, you'll go to a random spot in the border.

Admins:
/respawnpoint reload
/respawnpoint info
/respawnpoint clear

Permissions

• respawnpoint.use — set a respawn point by clicking beds (default: true)
• respawnpoint.admin — use admin commands (default: op)

Config notes

• storage-type: yaml (default) or mysql.
• random-world-border: 150000 means ±75,000 blocks.
• teleport-delay: 0 (ticks before post‑death teleport).

Requirements

• Server: Folia (targeted for 26.1.x; also runs on Paper 1.21.x).
• Java: 21.

Supported versions

Game versions: 1.21.x
Platform: Folia (and Paper 1.21.x, since we only use the standard Bukkit/Paper API)