Saro's Random Spawn

A simple Minecraft mod that teleports players to random locations when they first join the server.

• Random First Spawn: Players are teleported to a random location when they first join the server
• Safe Teleportation: Advanced algorithm ensures players spawn safely on the surface, not in caves, walls, or dangerous areas
• Scenic Spawn Option: Players can spawn high in the air with slow falling effect for a scenic view of their new home
• Configurable Settings: Server administrators can customize teleportation settings
• Customizable Messages: Configure messages shown to players when they are teleported
• Optional Repeat Teleportation: Option to teleport players on every join, not just the first time
• Player Exceptions: Configure whitelist/blacklist for players who should not be teleported

The mod includes a configuration file where you can adjust:

• Minimum and maximum teleportation distance from spawn
• Whether to teleport players on every join or just the first time
• Custom messages to display when players are teleported (disabled by default)
• Safe teleportation toggle (ensures players don't spawn in dangerous areas)
• Scenic spawn option (players spawn high in the air with slow falling effect)
• Dimension-specific teleportation settings (Nether and End teleportation options)
• List of players who should be excluded from random teleportation

Here's an example of the configuration file (randomspawn-common.toml):

[general] # Minimum distance from spawn to teleport players (in blocks) minDistance = 500 # Maximum distance from spawn to teleport players (in blocks) maxDistance = 2000 # Whether to teleport players on every join, not just the first time teleportOnEveryJoin = false # Whether to allow teleportation in the Nether dimension allowNetherTeleport = false # Whether to allow teleportation in the End dimension allowEndTeleport = false [messages] # Whether to show a message to players when they are teleported showTeleportMessage = false # Message to show to players when they are teleported teleportMessage = "You have been teleported to a random location!" [safety] # If true, ensures players are teleported to safe locations (not in lava, caves, etc.) safeTeleport = true # If true, players will spawn at Y=100 with slow falling effect and gently float down to the ground spawnHighWithSlowFalling = false [debug] # If true, enables detailed debug logging to help diagnose issues debugMode = false [exceptions] # If true, only players in the list will be teleported. If false, players in the list will NOT be teleported. useWhitelist = false # List of player names to whitelist or blacklist from teleportation playerExceptions = ["ExamplePlayer1", "ExamplePlayer2"]

• /newspawn - Teleports yourself to a random location (requires OP permission)
• /newspawn <player> - Teleports the specified player to a random location (requires OP permission)
• /newspawn @a - Teleports all players to random locations (requires OP permission)
• /newspawn @r - Teleports a random player to a random location (requires OP permission)
• /newspawn @p - Teleports the nearest player to a random location (requires OP permission)

The command supports all player selectors (@a, @p, @r, @e[type=player]) and can teleport multiple players at once.

Project Support & Usage

Hosting: For the best performance, I recommend using BisectHosting linked in the banner.

Modpacks: You are free to include my work in any modpack. Please ensure proper credit is given by providing a link to this project page.