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.

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.