SpecifiedRandomTeleport

Randomly teleport to a set of user-defined locations.
This can be done by use of a command or by interacting with an activation block.

Commands.

• /specrandomteleport
  • Alias: /srt
  • Main command
  • Permission: srt.commands.main (default: true)
  • Without any arguments, subcommand (for which the user has permission) will be displayed
  • Tab-completion for all sub-commands
• Subcommands
  • /srt use
    • Teleport to one of the random locations
      • Not the only way to do this
    • Permission: srt.commands.use (default: everyone)
  • /srt addloc <name>
    • Player only
    • Add a location to the list of random location where you stand
    • Names can later be used to move or remove a specific location
    • Permission: srt.commands.addloc (default: op)
  • /srt removeloc <name>
    • Remove a specific location from the list
    • Permission: srt.commands.removeloc (default: op)
  • /srt moveloc <name>
    • Player only
    • Move a specific location to where the player stands
    • Permission: srt.commands.moveloc (default: op)
  • /srt list [world]
    • List existing random locations
    • Permission: srt.commands.list (default: op)
  • /srt addactivation
    • Player only
    • Prompt the user to left click on a block to set it as an activation block
      • Afterwards, if someone interacts with the activation block, they'll be teleported to one of the random locations
    • Permission: srt.commands.addactivation
  • /srt removeactivation
    • Player only
    • Prompt the user to left click on a block to remove it as an activation block
    • Permission: srt.commands.removeactivation
  • /srt listactivators
    • List available activation blocks
    • Permission: srt.commands.listactivators

Permissions:

Permission                  Children                                            Descrpition                             
srt.commands.main          None                                                Allow using the command                 
srt.commands.addloc        None                                                Allow adding location to the pool       
srt.commands.removeloc      None                                                Allow removing location from the pool   
srt.commands.moveloc        None                                                Allow moving location                   
srt.commands.list          None                                                Allow seeing list of location           
srt.commands.use            None                                                Allow teleporting to one of the random locations 
srt.commands.addactivation    None                                                Allow adding an activation block       
srt.commands.removeactivation    None                                                Allow removing an activation block     
srt.commands.listactivators    None                                                Allow listing activation blocks

Messages are configurable.
Default messages.yml:

unrecognized-subcommand   :   "{sub} is not a recognized subcommand!"   
need-a-player   :   "Only a player can do this!"  

 # /srp addloc messages   
location-exists   :   "Location {name} already exists, use '/srp moveloc <name>' to move it here"   
added-location   :   "Added location {name} in {world} at {x}, {y}, {z} (with {yaw}, {pitch})"  

 # /srp removeloc messages   
location-does-not-exist   :   "Location {name} does not exist"   
removed-location   :   "Removed location {name} from {world} at {x}, {y}, {z} (with {yaw}, {pitch})"  

 # /srp moveloc messages   
moved-location   :   "Moved location {name} to {world} at {x}, {y}, {z} (with {yaw}, {pitch})"  

 # /srp list messages   
list-header   :   "All locations ({amount}):"   
list-item   :   "{name} in {world} at {x}, {y}, {z} (with {yaw}, {pitch})"  

 # /srtp use messages   
teleporting   :   "Teleporting to random location {name} in {world} at {x}, {y}, {z} (with {yaw}, {pitch})"  

 # actviation   
need-to-click-activation   :   "Click on a block to mark it as an activation block"   
unsuitable-block   :   "This block is unsuitable for activation"   
marked-as-activation-block   :   "This block was marked as an activation block!"   
need-to-click-remove-activation   :   "Click on a block to remove it as an activation block"   
not-an-activation-block   :   "This is not an activation block"   
deleted-activation-block   :   "This block was removed as an activation block!"   
activation-list-header   :   "All activations ({amount}):"   
activation-list-item   :   "{world} at {x}, {y}, {z} (with {yaw}, {pitch})"

Default config:

use-metrics   :  true  
use-per-world-locations   :  true

The random locations are stored in locations.yml (if per-world locations are disabled) or locations_<worldname>.yml (if using per world locations) and the activator blocks in activators.yml .