SpawnManager

Lightweight, modern spawn management for Minecraft servers.

SpawnManager adds a configurable shared spawn without trying to become an Essentials replacement. It requires no database, no API key, and no additional server-side companion plugin.

✨ Features

• /spawn, /setspawn, /delspawn
• /spawn help, /spawn reload, /spawn set, and /spawn delete
• Configurable teleport countdown
• Countdown display via chat, action bar, title, or completely disabled
• Optional movement cancellation during countdown
• Optional damage cancellation during countdown
• Configurable teleport cooldown
• Permission-based cooldown and delay bypasses
• Optional first-join or every-join teleport
• Optional respawn teleport
• Optional void rescue
• Optional safe-location search
• Configurable teleport sounds and particles
• MiniMessage-formatted messages
• Spawn rotation is saved
• Spawn data is stored in spawn-data.yml
• No database required
• No external dependencies required

Folia is not supported. The countdown uses the standard Bukkit scheduler, and SpawnManager does not claim Folia compatibility.

📦 Installation

1. Download the SpawnManager JAR matching your Minecraft version.
2. Put the .jar file into your server's plugins folder.
3. Start or restart your server.
4. Stand at the location where you want the spawn.
5. Run /setspawn.

That's it.

SpawnManager automatically creates its configuration files when the server starts.

No database, API key, or additional plugin is required. MiniMessage support is already included in the plugin.

🎮 Commands

If spawn deletion confirmation is enabled, use:

/spawn delete confirm

or

/delspawn confirm

The confirmation expires after 15 seconds.

🔐 Permissions

⚙️ Configuration

After the first server start, SpawnManager creates:

plugins/SpawnManager/config.yml

and:

plugins/SpawnManager/spawn-data.yml

Teleport

teleport:
  delay: 3
  cooldown: 10
  cancel-on-move: true
  movement-threshold: 0.2
  cancel-on-damage: true
  safe: false
  safe-search-radius: 3

• delay — Teleport countdown in seconds
• cooldown — Time before the player can use /spawn again
• cancel-on-move — Cancels the countdown when the player moves
• movement-threshold — How much movement is allowed before cancellation
• cancel-on-damage — Cancels the countdown when the player takes damage
• safe — Attempts to find a safe teleport location near the spawn
• safe-search-radius — Search radius for a safe location

Countdown

countdown:
  type: actionbar

Available options:

• chat
• actionbar
• title
• none

Join Teleport

join:
  mode: disabled

Available options:

• disabled — No automatic join teleport
• first-join — Teleport players to spawn on their first join
• every-join — Teleport players to spawn every time they join

Respawn

respawn:
  teleport: false
  override-bed: false

• teleport — Teleport players to the configured spawn after death
• override-bed — Whether the configured spawn should override a player's bed/respawn location

Void Rescue

void:
  enabled: false
  y-level: 0

When enabled, players falling below the configured Y level can be teleported back to the configured spawn.

Messages

All player-facing messages can be configured in config.yml and support MiniMessage formatting.

This allows you to customize colors, gradients, styling, and other supported MiniMessage formatting.

📍 Spawn Data

The configured spawn is saved in:

plugins/SpawnManager/spawn-data.yml

The file stores:

• World
• X coordinate
• Y coordinate
• Z coordinate
• Yaw
• Pitch

The exact spawn location is only changed when /setspawn is used.

If safe teleport is enabled, SpawnManager searches for a safe location around the saved spawn without changing the actual saved spawn coordinates.

🧩 Compatibility

SpawnManager provides separate builds for different Minecraft versions.

Important

Download the build that matches your Minecraft server version.

Do not use a 26.x build on a 1.21.x server, and do not use the 1.21.x build on a 26.x server.

The 1.21.x build uses Java 21.

The 26.x builds use Java 25.

Spigot and Purpur may work because SpawnManager uses Bukkit-facing APIs, but they have not been fully integration-tested.

Folia is not supported.

🛠️ Troubleshooting

Spawn is missing

Stand at your desired spawn location and run:

/setspawn

The spawn world no longer exists

SpawnManager will warn you in the server console.

Load/restore the missing world or set a new spawn with:

/setspawn

/spawn does not work

Check:

• The player has spawnmanager.spawn
• A spawn has been configured
• The player is not currently on cooldown
• Another teleport countdown is not already active

The countdown does not appear correctly

Check the following setting in config.yml:

countdown:
  type: actionbar

Valid values are:

chat
actionbar
title
none

Configuration changes are not applied

Use:

/spawn reload

or:

/spawnmanager reload

You can also restart the server.

SpawnManager's reload command does not run Bukkit's global /reload.

Teleport gets cancelled

If movement cancellation is enabled:

cancel-on-move: true

moving during the countdown will cancel the teleport.

If damage cancellation is enabled:

cancel-on-damage: true

taking damage will also cancel the teleport.

❓ Need Help?

If you encounter an issue, please include:

• Minecraft version
• Server software and version
• SpawnManager version
• Relevant console errors
• Your config.yml if the issue is configuration-related

Please make sure you are using the correct SpawnManager build for your Minecraft version before reporting an issue.

SpawnManager — simple spawn management without the bloat.