RtpPlugin

The RandomTeleport plugin offers Minecraft server administrators a comprehensive and efficient solution for integrating random player teleportation, enhancing exploration, and providing a dynamic gameplay experience while maintaining server stability and player safety.

Key Features Intelligent Safe Location Detection: Player safety is a top priority. The plugin utilizes an advanced algorithm to meticulously identify secure teleportation points, rigorously preventing players from spawning in hazardous environments such as lava, the void, or solid blocks. This intelligent system ensures reliable placement on solid ground with adequate overhead clearance.

Asynchronous Performance for Seamless Gameplay: To guarantee server responsiveness and eliminate potential lag, the computationally intensive process of finding safe teleport locations is handled asynchronously. This ensures a smooth and uninterrupted gameplay experience, even during periods of high player activity.

Fully Customizable Messages: Every message generated by the plugin—from permission warnings to successful teleport confirmations—is fully customizable. This allows server owners to precisely tailor the plugin's communication to align perfectly with their server's unique brand, tone, and linguistic preferences.

Commands The RandomTeleport plugin introduces a versatile command structure to manage player teleportation and administrative functions.

/rtp

Description: Initiates a random teleport for the executing player to a new, safe, and unexplored location within the configured world boundaries.

Usage: /rtp

Permissions: randomteleport.rtp

Behavior:

Checks for the necessary permission before execution.

Applies a configurable cooldown to prevent command spamming. Players on cooldown will be notified of the remaining time.

Asynchronously searches for a safe location based on the defined teleport_range and teleport_min_distance.

Teleports the player upon finding a suitable location and provides a confirmation message. If a safe location cannot be found within the maximum attempts, the player is notified, and their cooldown for that attempt is reset.**

/rtp reload

Description: Reloads the plugin's configuration file (config.yml) from disk. This is essential for applying changes made to the configuration without requiring a full server restart.

Usage: /rtp reload

Permissions: randomteleport.reload

Behavior:

Requires the randomteleport.reload permission.

Reloads all configurable settings, including cooldowns, teleport ranges, and custom messages.

Notifies the administrator of the successful configuration reload.**

Configuration Options All aspects of the RandomTeleport plugin's behavior are easily managed through the config.yml file, providing administrators with precise control.

YAML

# config.yml
This file stores the configurable settings for the RandomTeleport plugin.

Cooldown in seconds for the /rtp command.
Players will have to wait this long before using the command again.
cooldown_seconds: 20

The maximum radius from the world spawn (0,0) that a player can be teleported to.
For example, a value of 10000 means X and Z coordinates will be between -10000 and 10000.
teleport_range: 10000

The minimum distance from the world spawn (0,0) that a player will be teleported to.
This helps prevent players from teleporting too close to the origin.
teleport_min_distance: 1000

Messages configured for the plugin.
messages:
  no_permission: "&cYou do not have permission to use that command."
  player_only: "&cOnly players can use this command."
  on_cooldown: "&cYou are on cooldown! Please wait &e%time_left% &cseconds."
  teleporting: "&aTeleporting you to a random location..."
  teleported_successfully: "&aYou have been randomly teleported!"
  teleport_failed: "&cCould not find a safe location to teleport you. Please try again."
  plugin_reloaded: "&aRandomTeleport plugin configuration reloaded successfully!"

Technical Specifications Plugin Name: RandomTeleport

Version: 1.0

API Version: 1.21 (Compatible with Minecraft 1.21 and potentially newer/older versions depending on PaperMC's API compatibility)

Main Class: com.dark.RandomTeleportPlugin