Random and Set First Spawn automatically teleports each player to a random location on their very first connection to the server.
Goal: avoid crowded spawns, create a more organic survival experience, and naturally spread players across the world from the start.
Random teleport only on first join
Player’s personal spawn position is saved after teleportation
Safe location selection (valid ground, no water/lava depending on config)
Configurable distance parameters (min/max) and many more options
Compatible with modded servers 1.21.1
Server player spawn points list stored in/world/data/randomjoinspawn_spawns.json
File: randomjoinspawnspacingplayer-server.toml
# Absolute maximum radius (hard cap) to prevent infinite world generation
# Default: 200000
# Range: 1000 ~ 2000000
hard_max_radius = 20000
# Attempts per tick per player (performance)
# Default: 1
# Range: 1 ~ 10
attempts_per_tick = 1
# Minimum distance from world spawn (blocks)
# Default: 1000
# Range: 0 ~ 2000000
min_radius = 1000
# Maximum search distance from world spawn before expanding up to hard_max_radius (blocks)
# Default: 20000
# Range: 0 ~ 2000000
max_radius = 5000
# Radius increment if no spawn is found before max_radius (blocks)
# Default: 5000
# Range: 0 ~ 2000000
radius_step = 100
# Minimum 2D distance (X/Z) between player spawns (blocks)
# Default: 5000
# Range: 0 ~ 2000000
min_spacing_2d = 3500
# Ceiling Y level for arrival teleport (allows player to view spawn area from above)
# Default: 320
# Range: -64 ~ 1024
ceiling_y = 320
# Number of spawn attempts per radius step
# Default: 10
# Range: 1 ~ 10000
attempts_per_radius = 150
# Slow Falling duration on arrival (seconds) to prevent fall damage
# Default: 60
# Range: 5 ~ 600
slow_fall_seconds = 60
Minecraft: 1.21.1
Loader: NeoForge
Server-side: Yes
Client-side: Not required
Place the .jar file into the /mods folder
Start the server once (generates config files)
Adjust the configuration
Restart the server
No installation required
First connection may take longer if attempts_per_radius is high and the server is heavily modded.
Using a chunk pre-generator (such as Chunky) significantly improves spawn speed and reduces potential lag.
Chunk pre-generation also reduces the risk of teleporting players into ungenerated chunks.
Q: Is the player teleported every time they reconnect?
A: No. Teleportation only occurs if the player has never joined the server before (internal flag/record).
Q: Does it work across multiple dimensions?
A: No. The player spawns at the location linked to their Nether portal.
Q: Can a reroll be forced?
A: Yes. Remove the player’s entry from/world/data/randomjoinspawn_spawns.json.
If respawn anchor is broken, respawn at player’s personal spawn or bed
Respawn at player-defined spawn if bed is broken (not at world spawn)
Ocean biome blacklist
v1.0.0 – Initial release (first-join teleport + min/max configuration)
Logs: Please include latest.log and the configuration file
Server: Specify mod list and loader version
All Rights Reserved
Development: Smockeur_San
