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.
