NAF Studio - FirstJoinRTP Plugin

Lightweight Bukkit/Paper plugin that safely teleports new players to a random location upon their first join into a designated world and executes configurable commands to register their spawnpoint or home. Designed for compatibility across Spigot, Paper, Purpur, Gale, and LeafMC servers supporting Minecraft 1.20.4–1.20.6, 1.21.x, and 26.x.

---

Compatibility & Supported Platforms

• Minecraft Versions: 1.20.4–1.20.6, 1.21.x (1.21–1.21.11), and 26.x (26.1, 26.2, 26.3)
• Server Software: Spigot, Paper, Purpur, Gale, LeafMC, and downstream Bukkit forks
• Java Runtimes: OpenJDK 17, 21, and 25

---

Features

• Triggers customizable random teleport commands exclusively when a player enters the target world for the first time.
• Supports downstream authentication setups (e.g., Limbo or Lobby servers) by intercepting world-change transitions into the survival world.
• Executes configurable commands at the landing location to assign native spawnpoints or external homes (e.g., vanilla /spawnpoint or CMI /cmi sethome).
• Protects players from fall damage, suffocation, and hostile mob targeting during chunk loading.
• Reverts visibility and restores interaction states gracefully upon completion, safety timeouts, or server reloads.

---

Configuration

A default config.yml is generated automatically upon first startup:

# Target world to check for first join RTP
target-world: "world"

# Whether to enable the custom Random Teleport command execution
rtp-command-enabled: true

# Command to execute for Random Teleport
# Used when the player enters the target world for the first time.
# Placeholders: %player%, %world%
# Default (Vanilla): "spreadplayers 0 0 150 10000 false %player%"
# CMI Recommendation: "cmi rt %player% %world%"
rtp-command: "spreadplayers 0 0 150 10000 false %player%"

# Whether to enable the custom spawnpoint command execution
spawnpoint-command-enabled: true

# Command to set the player's spawnpoint or home after successful RTP.
# Placeholders: %player%, %world%, %x%, %y%, %z%
# Default (Vanilla): "spawnpoint %player% %x% %y% %z%"
# CMI Recommendation: "cmi sethome firstspawn %player% -p -l:%world%;%x%;%y%;%z% -overwrite"
spawnpoint-command: "spawnpoint %player% %x% %y% %z%"

# Delay in ticks before restoring player visibility after teleportation
# 20 ticks = 1 second
delay-after-teleport-ticks: 20

---

Commands & Permissions

Command	Permission	Description
/firstjoinrtp reload	firstjoinrtp.admin	Reloads configuration from disk (aliases: [/fjrtp]).

---

Installation

1. Download the latest FirstJoinRTP.jar from Modrinth or GitHub Releases.
2. Place the .jar file into your server's plugins/ directory.
3. Restart the server to generate plugins/FirstJoinRTP/config.yml.
4. Configure teleport commands according to your server setup.
5. Use /firstjoinrtp reload or restart the server to apply configuration changes.