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.

Saro's Random Spawn