TheSpawn

THESPAWN
A focused and reliable spawn system for modern Paper servers

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Send players back to one precise server spawn without installing a large essentials suite.

TheSpawn provides a persistent global spawn, safe configurable teleport warmups, fully editable messages and optional control over Minecraft's default join and quit notifications.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OVERVIEW
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

TheSpawn is a lightweight utility for survival servers, SMP communities, hubs and private networks. Administrators set the destination once with /setspawn and players return with /spawn.

During the warmup, moving or taking damage cancels the teleport. The final teleport runs asynchronously for smooth operation on modern Paper servers.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
MAIN FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Persistent global spawn — Exact world, coordinates, yaw and pitch.
• Safe teleport warmup — Configurable delay before /spawn completes.
• Movement cancellation — Walking away cancels the pending teleport.
• Damage cancellation — Receiving damage cancels the pending teleport.
• Asynchronous teleportation — Smooth operation on modern Paper servers.
• Easy administration — Set the destination with /setspawn.
• Live configuration reload — Apply changes without restarting.
• Custom messages — Every player-facing response is editable.
• Color support — Legacy color codes and hex colors.
• Join and quit control — Optionally suppress vanilla connection messages.
• Local YAML storage — No database or external service.
• No required dependencies
• Java and Bedrock friendly through Geyser.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/spawn
/setspawn
/thespawn reload

/spawn — Teleports the player to the configured spawn after the warmup.

/setspawn — Stores the administrator's current location as the global spawn.

/thespawn reload — Reloads messages and settings without restarting.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SAFE TELEPORT WARMUP
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The delay is controlled through settings.teleport-delay-seconds. Players must remain close to their starting position until the countdown finishes.

Movement beyond the configured tolerance or any received damage cancels the pending teleport. Disconnecting and plugin reloads also cleanly cancel active tasks.

Set the delay to 0 for immediate teleportation.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CONFIGURABLE MESSAGES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Every player-facing response can be edited in config.yml:

• Prefix
• Teleport countdown
• Successful teleport
• Spawn established
• Spawn not configured
• Movement or damage cancellation
• Permission errors
• Command usage
• Reload confirmation

Legacy colors such as &a and hex colors such as &#55FFFF are supported.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
JOIN AND QUIT CONTROL
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Minecraft's default joined/left the game messages can be hidden to avoid duplicates with a separate welcome or chat plugin.

join-quit-messages:
hide-vanilla: true

Set the option to false and run /thespawn reload to restore vanilla messages.

TheSpawn does not broadcast custom join or quit messages. It only controls whether the vanilla messages are shown.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

thespawn.spawn
thespawn.setspawn
thespawn.reload

• thespawn.spawn — Allows /spawn. Default: everyone.
• thespawn.setspawn — Allows /setspawn. Default: operators.
• thespawn.reload — Allows /thespawn reload. Default: operators.

LuckPerms example:

/lp group default permission set thespawn.spawn true
/lp group admin permission set thespawn.setspawn true
/lp group admin permission set thespawn.reload true

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Server software: Paper and Spigot 1.21.x
• Tested version: Paper 1.21.8
• Java: 21 or newer
• LuckPerms: Optional and compatible
• Geyser/Floodgate: Optional and compatible
• Vault: Not required
• PlaceholderAPI: Not required

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INSTALLATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Download TheSpawn-2.0.2.jar.
2. Place the file inside the server's /plugins folder.
3. Restart the server.
4. Confirm that TheSpawn appears in green in /plugins.
5. Use /setspawn at the desired location.
6. Customize config.yml if needed.
7. Run /thespawn reload after configuration changes.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
STORAGE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The spawn location is saved locally in:

plugins/TheSpawn/spawn.yml

Configuration and messages are stored in:

plugins/TheSpawn/config.yml

No external database or additional service is required.

Created by TheMurft • Version 2.0.2