GateWayMC-Core

Fixed welcome back message included we improved module code on disable/enable!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 Overview
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The Spawn Module provides a lightweight spawn system for your server. Set a spawn location, and players can teleport to it with a configurable delay (movement cancels). New players are teleported instantly on first join. Welcome messages (first join and regular) can be fully customised, support placeholders, and include a join count. All messages support hex colours and PlaceholderAPI placeholders.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Features
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Set spawn – /setspawn to set the server spawn location
• Teleport to spawn – /spawn with configurable delay and movement/damage cancellation
• Instant first‑join teleport – new players are automatically teleported to spawn (can be disabled)
• Welcome messages – separate lists for first join and regular join, with placeholders {player} and {count} (total join count)
• PlaceholderAPI support – use any PAPI placeholders in welcome messages and teleport messages
• Hex colour support – use RRGGBB everywhere
• Permissions – each command has its own permission node (configurable)
• Update checker – notifies console when a new version is available
• No hardcoded config – all settings are read from YAML files; defaults are copied from resources

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 Installation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Make sure GateWayMC‑Core is installed and running on a Paper 1.18.2+ server.
2. (Optional) Install PlaceholderAPI for dynamic placeholders in messages.
3. Drop the SpawnModule.jar into the modules folder:
   plugins/GateWayMC-Core/modules/
4. Reload the core (or restart the server):
   • In‑game: /gatewaycore reload
   • Console: gatewaycore reload
5. Configuration file spawn-config.yml is generated automatically in plugins/GateWayMC-Core/modules/Spawn/
6. Edit settings, welcome messages, and permissions – no restart needed

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💬 Commands
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Command	Description	Permission (configurable)
/spawn	Teleport to spawn (with optional delay)	spawnmodule.spawn
/setspawn	Set the server spawn location at your position	spawnmodule.setspawn
/delspawn	Delete the current spawn location	spawnmodule.delspawn

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔑 Permissions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

All permissions are configurable in spawn-config.yml. You can set them to any node, or leave empty to allow everyone.

Default Node	Command	Default
spawnmodule.spawn	/spawn	none (all players)
spawnmodule.setspawn	/setspawn	op
spawnmodule.delspawn	/delspawn	op

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙ Configuration (spawn-config.yml)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

# Spawn module configuration
teleport-delay: 3
teleport-on-first-join: true   # Teleport new players to spawn on first join
update-check-enabled: true

# PlaceholderAPI support (auto-enabled if detected)
placeholderapi-enabled: false

# Permissions (set to empty to disable permission check)
permissions:
  spawn: "spawnmodule.spawn"
  setspawn: "spawnmodule.setspawn"
  delspawn: "spawnmodule.delspawn"

# Welcome Messages
welcome:
  enabled: true
  first-join:
    - "&8&m---------------------------------------"
    - "  &6&lWELCOME &e{player} &6&lTO THE SERVER!"
    - "  &7You are player &e#{count} &7to join us."
    - "&8&m---------------------------------------"
  regular-join:
    - "&8[&a+&8] &7Welcome back, &e{player}!"

# Messages
messages:
  no-permission: "&cYou don't have permission to use this command."
  no-spawn: "&cSpawn is not set."
  spawn-set: "&aSpawn location set."
  spawn-deleted: "&cSpawn location deleted."
  teleporting: "&aTeleporting to spawn..."
  teleport-delay: "&aTeleporting in &e{seconds} &aseconds. Don't move!"
  teleport-cancelled-move: "&cTeleport cancelled because you moved."
  teleport-cancelled-damage: "&cTeleport cancelled because you took damage."
  player-only: "&cThis command can only be used by players."

Settings explained

• teleport-delay – seconds the player must stand still before teleporting (0 = instant)
• teleport-on-first-join – if true, new players are teleported to spawn immediately after joining (no delay, no message)
• update-check-enabled – toggles the startup update checker
• placeholderapi-enabled – set to true to enable placeholders in messages (auto‑enabled if PlaceholderAPI is detected)
• permissions – permission nodes for each command (leave empty to allow all)
• welcome – lists of lines sent on first join and regular join; supports {player} and {count} placeholders
• messages – all other texts; supports {seconds}, {cost} etc. (cost not used in this module)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔌 PlaceholderAPI Support
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

If you have PlaceholderAPI installed, the module automatically enables placeholder support. You can use any PAPI placeholder in welcome messages and teleport messages. Built‑in placeholders:

• {player} – the player's name (not a PAPI placeholder, but replaced manually)
• {count} – total number of players who have ever joined the server

Example using PAPI:
&aWelcome, %player_name%! You are the {count}th player!


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎨 Colour Support
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

All texts support both legacy & colour codes and hex colours with RRGGBB. Examples:

• &6&lWELCOME – gold bold text
• AAFF&lSPAWN – blue gradient heading

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 Data Storage
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The spawn location is stored directly in spawn-config.yml under the spawn key.
First‑join tracking and the join count are stored in data.yml inside the module folder.
No data is stored in memory permanently – all changes are saved to files immediately.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙ Dependencies
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Required: GateWayMC‑Core
• Optional: PlaceholderAPI – for dynamic placeholders in messages