LSpawn

A lightweight spawn & respawn management plugin · built for Paper / Folia

LSpawn is a plugin for spawn point management and death respawn control, fully adapted to Folia's region-threading model.

🎯 Target server: Paper / Folia 26.1 (api-version: 26.1)
☕ Requires Java 25+
✍️ Author: Dainsleif
📄 License: GPL-3.0

✨ Features

/spawn — teleport to the spawn point with one command
/setspawn / /delspawn — set / remove the main spawn point
/setfirstspawn / /delfirstspawn — set / remove the first-join spawn point (new players are sent here on their first join)
Death respawn control — respawn at spawn by default; optionally keep bed / respawn anchor respawn points
Optional: teleport players to spawn on every join
/lspawn reload — hot-reload the configuration
Built-in bilingual messages (language: zh_cn | en_us, MiniMessage, freely editable)

🛠 Commands & Permissions

Command	Description	Permission	Default
`/spawn`	Teleport to spawn	`lspawn.spawn`	everyone
`/setspawn`	Set the main spawn (current position)	`lspawn.setspawn`	OP
`/delspawn`	Remove the main spawn	`lspawn.delspawn`	OP
`/setfirstspawn`	Set the first-join spawn	`lspawn.setfirstspawn`	OP
`/delfirstspawn`	Remove the first-join spawn	`lspawn.delfirstspawn`	OP
`/lspawn reload`	Reload configuration	`lspawn.reload`	OP

All nodes are prefixed lspawn. and can be granted / revoked individually via a permissions plugin such as LuckPerms.

⚙️ Configuration

Spawn data is stored in config.yml (also writable via commands). Key options:

language: zh_cn              # message language: zh_cn / en_us
debug: false                 # debug logging (for troubleshooting)

respawn:
  at-spawn: true             # respawn at spawn (default fallback)
  at-bed: false              # keep bed respawn points
  at-anchor: false           # keep respawn-anchor respawn points

join:
  teleport-to-spawn: false   # teleport to spawn on every join

The messages section ships both zh_cn and en_us MiniMessage sets, freely editable (placeholders: {world} {x} {y} {z}).

🧵 Folia Compatibility

plugin.yml declares folia-supported: true
All teleports use teleportAsync, which is thread-safe
Note: Folia disables the vanilla respawn path that fires PlayerRespawnEvent and uses its own respawn flow instead. This plugin therefore implements respawn on Folia by writing a forced respawn location at death plus a post-respawn fallback teleport. respawn.at-bed / respawn.at-anchor preserve real bed / anchor respawn points on Folia via a block check at death (fully functional on Paper)
First-join / join teleports are deferred by 1 tick to avoid teleporting during placeNewPlayer

📄 License

GPL-3.0