RegionTeleport

ABOUT RegionTeleport is a plugin for teleporting all players within one or more WorldGuard regions to one or more spawn locations. This is handy for a bunch of occasions, like hosting custom events and wanting to teleport everyone out at the end or teleporting the victor(s) out of the arena.

FEATURES

• Spawn locations to teleport players from specified region(s) to.
• Teleporting all players from specified region(s) to the specified location(s).
• Stop certain players from being teleported.
• Clear specific entities from specific regions.
• regiontp-on-entry flag - Teleport player to one of the specified locations on region entry.
• regiontp-on-exit flag - Teleport player to one of the specified locations on region exit.
• player-loot-drop flag - Stop player loot from being dropped on death.
• mob-loot-drop flag - Stop mob loot from being dropped on death.

SETUP

1. Download the RegionTeleport.jar.
2. Make sure your server is running Java 21 or higher.
3. Download WorldGuard.
4. Upload all files to your plugins folder.
5. Restart your server.

DEPENDENCIES

• WorldGuard (7.0.0+) - Required for the entire plugin to work.

SOFT DEPENDENCIES

• CMI (9.0.0.0+) - Adds the ability to use cmi warps as spawn locations. Enabled through config. Usage: /regiontp tp <region> cmi:<warp>
• EssentialsX - Adds the ability to use essentials warps as spawn locations. Enabled through config. Usage: /regiontp tp <region> ess:<warp>
• PlaceholderAPI - Adds a few placeholders (see below)

COMMANDS & PERMISSION

<> = required, () = optional, -s = hide message

• Command: /regiontp help
  Description: Shows all commands
  Permission: regionteleport.command.help

• Command: /regiontp reload
  Description: Reloads the plugin
  Permission: regionteleport.command.reload

• Command: /regiontp list (page)
  Description: Lists all spawn locations
  Permission: regionteleport.command.list

• Command: /regiontp setspawn <name> (x y z) (yaw pitch) (world)
  Description: Creates a spawn location
  Permission: regionteleport.command.setspawn

• Command: /regiontp delspawn <name>
  Description: Deletes the specified spawn location
  Permission: regionteleport.command.delspawn

• Command: /regiontp tp <"region1 region2 ..."> <"spawn1 spawn2 ..."> (-s)
  Command: /regiontp tp <world> <"region1 region2 ..."> <"spawn1 spawn2 ..."> (-s)
  Description: Teleports all players within the region(s) to the specified location(s)
  Permission: regionteleport.command.teleport
  Examples:

  1. /regiontp tp minecraft:world __global__ "spawn1 spawn2" (Would teleport players in minecraft:world to either spawn1 & spawn2)
  2. /regiontp tp "region1 region2" spawn1 (Would teleport players in region1 & region2 to spawn1)
     
     

• Command: /regionclear <"region1 region2 ..."> <"option1 option2 ..."> (-s)
  Command: /regionclear <world> <"region1 region2 ..."> <"option1 option2 ..."> (-s)
  Description: Remove all specified entities from all specified regions
  Permission: regionteleport.command.clear
  Available Options:
  all (Removes all monsters/animals/ambient/items/vehicles that aren't named, tamed or an npc)
  monsters
  animals
  ambient (bat)
  items(:<item1,item2,...>) (separate different item types with commas)
  vehicles (Doesn't include living vehicles like horses, use -animals for those)
  specific:<entity1,entity2,...> (separate different entity types with commas)
  displays (Only 1.19.4+)
  named(-only:<name1,name2,...>)
  tamed(-only)
  npcs(-only) (Will remove any entities that have the metadata NPC)
  
  Using -only will remove only those entities. So, named-only would only remove named entities, and named-only:Steve,Dave would only remove entities named Steve & Dave.
  
  Examples:

  1. /regionclear minecraft:world __global__ "animals named-only:dave" (Would remove any animals named dave in minecraft:world)
  2. /regionclear "region1 region2" "items:diamond,dirt animals tamed" (Would remove all animals, all tamed animals & any dropped diamonds/dirt items from region1 & region2)
  3. /regionclear region1 specific:sheep,ender_crystal (Would remove any sheep & end crystals in region1)
     
     

• Permission: regiontp.teleport.bypass
  Description: Does so the player doesnt get teleported if he is within the region.

• Permission: regiontp.*
  Description: Gives you all permissions except teleport bypass.

PLACEHOLDERS

• Placeholder: %regionteleport_player_count_w:<world>_r:<region>%
  Description: Counts amount of players in that region in that world. use __global__ for entire world.

• Placeholder: %regionteleport_player_count_exclude_bypass_w:<world>_r:<region>%
  Description: Counts amount of players except for players with teleport bypass permission in that region in that world. use __global__ for entire world.