AEROTP

Overview

AEROTP is a lightweight random-teleport plugin for your server. It sends a chosen player to a safe, faraway spot in any world you pick — perfect for exploration events, wilderness spawns, adventure servers, or just shaking things up.

Features

• Random teleport to any world on the server with a single command.
• Smart safety checks: solid ground, two blocks of breathing room, and optional avoidance of lava and water.
• Configurable minimum and maximum distance from spawn so players always land far enough from the main base.
• Async search so the server doesn't lag, even on huge worlds.
• Clean, minimal teleport message — no spam, just the coordinates.
• Built-in tutorial, Discord link, and community link commands.
• Reloadable configuration without restarting the server.
• Optional world blacklist to protect maps you don't want randomized.
• Per-command permissions so you can decide exactly who gets what.

How to Use

Main command: /aerotp

• /aerotp tp <player> <world> — Teleports the named player to a random safe location in the chosen world.
• /aerotp help — Shows the in-game tutorial.
• /aerotp server — Shows the Discord invite.
• /aerotp link — Shows the community website.
• /aerotp reload — Reloads the configuration file.

After a successful teleport, the target player simply sees:

Você foi teleportado para:
X: <x>
Y: <y>
Z: <z>
Mundo: <world>

Configuration Highlights

• min-distance-from-spawn — how far from spawn the random point must be (default 3000 blocks).
• max-distance — the outer limit of the random search (default 15000).
• avoid-water / avoid-lava — reject landings in liquids.
• max-tries — how many attempts the plugin makes before giving up.
• world-blacklist — worlds that cannot be randomized.
• messages — every player-facing line is fully customizable, with color codes supported.

Tips & Tricks

• Increase max-tries on highly irregular worlds (lots of water or mountains) to improve the chance of finding a safe spot.
• Use the world blacklist to prevent randomization in mini-game or lobby worlds.
• Combine with your permissions plugin (for example LuckPerms) to give moderators the teleport command while letting everyone see the help, Discord, and community links.
• The plugin automatically detects Vault, PlaceholderAPI, WorldGuard, and Multiverse-Core when they are installed, making it easy to fit into any server setup.

Known Limitations

• Very small worlds may not contain enough space between the minimum and maximum distance — increase max-distance or lower min-distance-from-spawn to fit your map.
• If no safe location is found within the configured number of tries, the command reports that it couldn't find a spot. Running it again usually succeeds, since each attempt picks fresh coordinates.