## ## **ABOUT** RegionTeleport is a plugin for teleporting all players within one or more WorldGuard regions to one or more spawn location. 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. ## ## **SETUP** 1. Download the RegionTeleport.jar. 2. Make sure your server is running Java 17 or higher. 3. Download WorldGuard (Must be version 7.0.0 or higher). 4. Upload all files to your plugins folder. 5. Reload/Restart your server. ## ## **DEPENDENCIES** - **[WorldGuard](https://dev.bukkit.org/projects/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 cmi:` - EssentialsX - Adds the ability to use essentials warps as spawn locations. Enabled through config. Usage: `/regiontp tp ess:` - PlaceholderAPI - Adds a few placeholders (see below) ## ## **COMMANDS & PERMISSIONS** < > = required, ( ) and [ ] = optional, -s = hide message
Any argument with an optional (s), ex: `, `, means you can specify multiple arguments by separating them with a comma, except for `` where you have a space between each type, `ex: /regionclear example1 -animals -tamed` - **Command: /regiontp help** - Shows all commands
**Permission:** regiontp.command.help

- **Command: /regiontp teleport/tp (-s)** - Teleports all players within the region to the specified location. Use comma to separate multiple regions & spawns.
**Permission:** regiontp.command.teleport

- **Command: /regiontp reload** - Reloads the plugin
**Permission:** regiontp.command.reload

- **Command: /regiontp setspawn ``** - Creates a spawn location where you're standing
**Permission:** regiontp.command.setspawn

- **Command: /regiontp delspawn ``** - Deletes the specified spawn location
**Permission:** regiontp.command.delspawn

- **Command: /regiontp spawnlist** - Shows all spawn locations
**Permission:** regiontp.command.spawnlist

- **Command: /regionclear (-s) (-w:[worldname])** - Remove all specified entities from all specified regions
**Permission:** regiontp.command.clear
**Available Types:**
**-all** (Removes all monsters/animals/ambient/items/vehicles that aren't named, tamed or an npc)
**-monsters**
**-animals**
**-ambient** (bat)
**-items(:)** (separate different item types with commas)
**-vehicles** (Doesn't include living vehicles like horses, use -animals for those)
**-specific:** (separate different entity types with commas)
**-displays** (Only 1.19.4+)
**-named(-only:[name])** ([name] is case sensitive)
**-tamed(-only)**
**-npcs(-only)** (Will also remove any entities that have the metadata "NPC". Usually this would be CitizensNPCs)

Using **-only** will remove only those entities. So, "-named-only" would only remove named entities, and "-named-only:Steve" would only remove entities named Steve.
Examples:
**/regionclear `__global__ ` -animals -named-only:dave -w:world1** - Would remove any animals named dave in world1
**/regionclear example1,example2 -items:diamond,dirt -animals -tamed** - Would remove all animals, all tamed animals & any dropped diamonds/dirt items from the regions example1 & example2
**/regionclear example1 -specific:sheep,ender_crystal** - Would remove any sheep & end crystals in the region example1

- **Permission: regiontp.teleport.bypass** - Does so the player doesnt get teleported if he is within the region. - **Permission: regiontp.** - Gives you all permissions except teleport bypass. ## ## **CONSOLE COMMANDS** (Most commands work in the console, however any not listed here work the same as listed above) - **Command: /regiontp teleport/tp `` (-s)** - Teleports all players within the region to the specified location - **Command: /regiontp setspawn ` `** - Creates a spawn location where you're standing ## ## **PLACEHOLDERS** - `%regionteleport_player_count_w:r:%` - Counts amount of players in that region in that world. use `__global__` for entire world. - `%regionteleport_player_count_exclude_bypass_w:_r:% `- Counts amount of players except for players with teleport bypass permission in that region in that world. use `__global__` for entire world.

RegionTeleport

3.1.1

3.1.0