Saro's Random Spawn

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

Main Features

• Random Initial Spawn: Players get teleported to random locations during their first server login
• Safe Teleportation: Intelligent algorithm ensures players spawn on safe surfaces, not in caves, walls, or dangerous areas
• Picturesque Start: Option to spawn high in the air with slow falling effect for scenic views of new surroundings
• Customizable Settings: Server administrators can configure all teleportation aspects
• Customizable Messages: Ability to customize messages players see when teleported
• Repeat Teleportation: Option to teleport players on every login, not just the first time
• Player Exceptions: Configuration of whitelist/blacklist for players who shouldn't be teleported

Configuration

The mod includes a configuration file with settings:

• Minimum and maximum teleportation distance from spawn point
• Teleportation on every login or only the first time
• Custom messages for players when teleported (disabled by default)
• Enable safe teleportation (players don't spawn in dangerous areas)
• Picturesque start (players spawn high in the air with slow falling effect)
• Settings for different dimensions (Nether and End teleportation options)
• List of players excluded from random teleportation

Example configuration file (randomspawn-common.toml):

[general] # General settings
    # Minimum teleportation distance from spawn point (in blocks)
    minDistance = 500
    # Maximum teleportation distance from spawn point (in blocks)
    maxDistance = 2000
    # Whether to teleport players on every login, not just the first time
    teleportOnEveryJoin = false
    # Allow teleportation in Nether dimension
    allowNetherTeleport = false
    # Allow teleportation in End dimension
    allowEndTeleport = false

[messages] # Messages
    # Whether to show message to players when teleported
    showTeleportMessage = false
    # Message to players when teleported
    teleportMessage = "You have been teleported to a random location!"

[safety] # Safety
    # If true, ensures players teleport to safe locations (not in lava, caves, etc.)
    safeTeleport = true
    # If true, players spawn at Y=100 with slow falling effect and gently descend to ground
    spawnHighWithSlowFalling = false

[debug] # Debug
    # If true, enables detailed logging for issue diagnosis
    debugMode = false

[exceptions] # Exceptions
    # If true, only players in the list get teleported. If false, players in the list DON'T get teleported.
    useWhitelist = false
    # List of player names for teleportation whitelist/blacklist
    playerExceptions = ["ExamplePlayer1", "ExamplePlayer2"]

Commands

• /newspawn - Teleports you to a random location (requires OP permission)
• /newspawn <player> - Teleports 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 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 simultaneously.