HLobbySpawn

A lightweight, fully configurable lobby spawn plugin. Set your spawn once with /setspawn and every player is sent there, facing the exact direction you saved, when they join, join for the first time, respawn, or use /spawn.

✨ Features

• Spawn teleports: first join, join, respawn and /spawn, each with its own toggle and optional message
• Welcome messages: chat, actionbar, title + subtitle, bossbar and sound, each one toggleable
• Separate first-join welcome: greet new players differently from returning ones
• Custom join/quit messages: optional, or hide them completely
• Teleport sound and a configurable /spawn cooldown
• Respect beds: optionally let players with a bed or respawn anchor respawn there
• In-game settings menu: toggle options from a GUI with /hls menu, saved instantly to the config
• Safe config updates: new options are added on update without touching your existing settings (a backup is made first)

🎨 Text formatting

Use any format you like, mixed in the same line:

• MiniMessage: <red>, <#ff0000>, <gradient:#00c6ff:#0072ff>, <bold>, <click:...>, <hover:...>
• Legacy codes: &7, &l, &#ff0000
• PlaceholderAPI placeholders (optional)

Built-in placeholders: {player}, {displayname}, {world}, {online}, {max_players}

🖥️ Compatibility

• Minecraft 1.8.8 → 26.3, one jar for every version
• Paper, Purpur, Leaf and other Paper forks
• Folia and CanvasMC: region-aware schedulers and async teleports
• Spigot: fully supported with a built-in text renderer
• Features a version doesn't have are skipped safely (bossbar needs 1.9+, hex colors 1.16+)
• Menus use modern material names and are translated automatically on 1.8 – 1.12

🧩 Integrations (all optional)

• Nexo: use Nexo custom items in menus with material: nexo-<id>
• PlaceholderAPI: placeholders in every message

📋 Menus

Menus use the familiar DeluxeMenus format: menu_title, size, items, slot/slots, display_name, lore, model_data, glow, item_flags and click actions:

[player] [console] [message] [broadcast] [actionbar] [sound] [close] [refresh] [openguimenu] [toggle]

You can create your own menus in the menus/ folder.

⚡ Performance

Built for large servers:

• No main-thread file saving
• Async teleports where supported
• Settings read without locking
• Every per-player entry is removed when the player leaves (no memory leaks)

📜 Commands & Permissions

Command	Permission	Default
/setspawn	hlobbyspawn.setspawn	OP
/delspawn	hlobbyspawn.delspawn	OP
/spawn	hlobbyspawn.spawn	Everyone
/spawn <player>	hlobbyspawn.spawn.others	OP
/hls menu [name]	hlobbyspawn.menu	OP
/hls reload	hlobbyspawn.reload	OP

• hlobbyspawn.spawn.bypasscooldown: skip the /spawn cooldown
• hlobbyspawn.admin: grants every permission

Aliases: /hls, /lobbyspawn

📁 Files

• config.yml: teleports, welcome messages, join/quit messages
• messages.yml: all command messages
• menus/: GUI menus
• spawn.yml: your saved spawn