-
Notifications
You must be signed in to change notification settings - Fork 0
First join for NeoForge Wiki Home
FirstJoinSpawn is a server-side NeoForge mod for Minecraft 1.21.1 that lets server owners control first-join spawning, /spawn, named warps, welcome messages, and random teleporting into a configured world.
The mod is designed for servers where the spawn world is separate from the main overworld, such as setups using a world switcher mod.
- Minecraft:
1.21.1 - Loader:
NeoForge - NeoForge version:
21.1.218+ - Environment:
Server-side only
Players do not need to install this mod on their client.
- Set a custom first-join spawn location.
- Send new players to a specific world and location the first time they join.
- Show a welcome message on first join.
- Allow players to use
/spawn. - Allow players to use named warps such as
/warp medical. - Optional shortcut command for
/medical. - Allow players to use
/rtpinto a configured RTP world. - Block
/rtpfrom specific worlds, such as the spawn world. - Four-second teleport countdown.
- Teleport cancels if the player moves.
- Safe-location checks before teleporting.
- Particle effects and coloured confirmation messages.
- OP-only debug and reset commands for testing first-join behaviour.
Teleports the player to the configured server spawn location.
The teleport uses a countdown:
You will be teleported in 4...
Then counts down:
3... 2... 1...
If the player moves during the countdown, the teleport is cancelled.
Teleports the player to a named warp.
Examples:
/warp spawn
/warp medical
Warps must be created by an OP/admin before players can use them.
Shortcut command that teleports the player to the medical warp.
This only works if an admin has created a warp called medical.
Example setup:
/warp set medical
Then players can use:
/medical
Randomly teleports the player into the configured RTP world.
The player cannot choose the RTP world. The world is controlled by the server config/admin commands.
This is useful if players start in a protected spawn world but should RTP into the main overworld.
The mod checks for a safe destination before teleporting.
Admin commands require OP permission.
Creates or updates a named warp at your current location.
Examples:
/warp set spawn
/warp set medical
If the warp already exists, it will be updated to your current position.
Deletes a named warp.
Example:
/warp delete medical
Lists all configured warps.
Example:
/warp list
Sets the first-join spawn location to your current position.
This is where brand-new players will be sent the first time they join.
Example:
/fjs setfirstjoin here
Manually sets the first-join spawn location.
Example:
/fjs setfirstjoin minecraft:overworld 100 65 100 0 0
Sets the normal /spawn location to your current position.
This is separate from the first-join spawn.
Example:
/fjs setspawn here
Sets the world that /rtp sends players into.
Example:
/fjs setrtpworld minecraft:overworld
Players will always RTP into this configured world, unless RTP is blocked by config rules.
Shows the current RTP settings.
Use this to check which world RTP is using and what the current RTP configuration is.
Example:
/fjs rtpinfo
Checks first-join information for a player.
This is useful when testing whether the mod thinks a player has already joined before.
Example:
/fjs debug Steve
Resets a player’s first-join status.
The next time that player joins, they will be treated as a first-time player again.
Example:
/fjs reset Steve
Marks a player as already handled for first join.
Use this if you do not want a player to receive the first-join teleport again.
Example:
/fjs markdone Steve
Tests the first-join teleport flow.
If no player is provided, it tests it on yourself.
Examples:
/fjs testfirstjoin
/fjs testfirstjoin Steve
Reloads the config and first-join data from disk.
Example:
/fjs reload
Saves the current config and first-join data to disk.
Example:
/fjs save
The /rtp command is designed for servers with multiple worlds.
For example:
- Players start in a protected spawn world.
-
/rtpsends them to the configured survival overworld. - RTP can be blocked from certain origin worlds to prevent problems.
- Players can still use
/rtpwhile already inside the configured RTP world.
Example setup:
/fjs setrtpworld minecraft:overworld
Player teleports use a four-second countdown.
This applies to:
/spawn/warp <name>/medical/rtp
If the player moves before the countdown finishes, the teleport is cancelled.
This helps stop players from accidentally teleporting after starting a command.
The mod checks that teleport destinations are safe before moving the player.
For RTP, it searches for a safe random location in the configured world.
If no safe location is found, the teleport is cancelled and the player is told that no safe destination was found.
If this happens often, increase the RTP attempts in the config file.
Recommended value:
rtp_attempts = 256
The mod creates config files on the server after it runs.
Use the config file to check and edit:
- First-join spawn location
- Normal
/spawnlocation - Welcome message
- Named warps
- RTP world
- RTP blocked origin worlds
- RTP radius
- RTP attempts
- Countdown settings
After editing the config file, either restart the server or run:
/fjs reload
A common setup is:
- Stand at your first-join spawn location.
- Run
/fjs setfirstjoin here. - Stand at your normal spawn location.
- Run
/fjs setspawn here. - Create useful warps with
/warp set spawnand/warp set medical. - Set the RTP destination world with
/fjs setrtpworld minecraft:overworld. - Test first join with
/fjs testfirstjoin. - Save the config with
/fjs save.
FirstJoinSpawn is licensed under the MIT License.