Random and Set First Spawn

📌 Overview

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.

✅ Features

• 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

⚙️ Config

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

🧩 Compatibility

• Minecraft: 1.21.1

• Loader: NeoForge

• Server-side: Yes

• Client-side: Not required

📥 Install

Server

1. Place the .jar file into the /mods folder

2. Start the server once (generates config files)

3. Adjust the configuration

4. Restart the server

Client

• No installation required

🧪 Best Practices / Known Limitations

• 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.

❓ FAQ

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.

🗺️ Roadmap

• 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

🧾 Changelog

• v1.0.0 – Initial release (first-join teleport + min/max configuration)

🆘 Support

• Logs: Please include latest.log and the configuration file

• Server: Specify mod list and loader version

• Download the file matching your Minecraft version .

📜 License

All Rights Reserved

🙏 Credits

Development: Smockeur_San