Saro's Random Spawn

!Header

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

!description

• 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

!Configuration

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"]

!Commands

- `/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.