<\/p>\n
# BSpawn<\/p>\n
## \ud83d\udd39 Overview
\nBSpawn is a compact and reliable spawn manager for your server. It saves a persistent spawn location (world + coordinates + yaw\/pitch) and provides a smooth teleport experience with a configurable countdown shown in the action bar, optional sounds and particles, and cancellation when the player moves.<\/p>\n
Designed for Paper\/Spigot servers (tested on Paper 1.20.5). Requires Java 17+.<\/p>\n
## \u2728 Key Features
\n– Persistent spawn storage: world, X\/Y\/Z, yaw and pitch
\n– `\/setspawn` – save your current location as spawn
\n– `\/spawn` – teleport to spawn with a configurable countdown
\n– Action-bar countdown display (default colors: `&7` and `&b`)
\n– Movement cancels teleport (configurable threshold)
\n– Configurable sounds for tick\/complete\/cancel events
\n– Particles at both origin and destination upon teleport.
\n– Built-in update checker (cannot be disabled via config); frequency capped at 360 minutes
\n– Auto-merge of default config keys: missing keys are restored from the bundled defaults
\n– `\/bspawn reload` and `\/bspawn help` (help shows only commands available to the sender)
\n– Options for teleport-on-join and teleport-on-death<\/p>\n
## \u2699\ufe0f Commands
\n| Command | Aliases | Description | Permission |
\n|—|—|—|—|
\n| `\/setspawn` | – | Set the server spawn to your current location | `bspawn.setspawn` (default: op) |
\n| `\/spawn` | – | Teleport to the configured spawn (applies countdown) | `bspawn.spawn` (default: everyone) |
\n| `\/bspawn help` | `?`, `h` | Show the help menu (displays only commands you can run) | – |
\n| `\/bspawn reload` | `\/bspawn r` | Reload the plugin configuration | `bspawn.reload` (default: op) |<\/p>\n
## \ud83d\udd10 Permissions
\n– `bspawn.setspawn` – allows setting the spawn (default: op)
\n– `bspawn.spawn` – allows using `\/spawn` (default: everyone)
\n– `bspawn.reload` – allows reloading the config (default: op)<\/p>\n
## \ud83e\udde9 `config.yml`<\/p>\n
“`yaml
\n# Persistent spawn location
\nspawn:
\n world: “world”
\n x: 0.0
\n y: 64.0
\n z: 0.0
\n yaw: 0.0
\n pitch: 0.0<\/p>\n
# Teleportation settings
\ncountdown: 5
\nmovement-threshold: 0.1<\/p>\n
teleport:
\n on-join: false
\n on-death: false<\/p>\n
sounds:
\n tick:
\n name: “block.note_block.pling”
\n volume: 0.7
\n pitch: 1.0
\n complete:
\n name: “entity.player.levelup”
\n volume: 1.0
\n pitch: 1.0
\n cancel:
\n name: “block.anvil.land”
\n volume: 0.8
\n pitch: 1.0<\/p>\n
particles:
\n enabled: true
\n origin:
\n type: “cloud”
\n count: 8
\n offset:
\n x: 0.5
\n y: 0.5
\n z: 0.5
\n destination:
\n type: “soul_fire_flame”
\n count: 12
\n offset:
\n x: 0.5
\n y: 1.0
\n z: 0.5<\/p>\n
update-check:
\n enabled: true
\n frequency-minutes: 360 # values >360 will be clamped to 360
\n“`<\/p>\n
## Support<\/p>\n
For issues, feature requests, or questions, please contact me.<\/p>\n
## License<\/p>\n
Copyright \u00a9 2026 blackowlzz. All rights reserved.<\/p>\n
—<\/p>\n
**Made with \u2764\ufe0f for the Minecraft community**<\/p>\n