RegionTeleport

RegionTeleport is a plugin for automatic teleportation of players located within one or multiple WorldGuard regions to predefined spawn points. This tool is essential for organizing various in-game events when you need to instantly move all participants from an arena or game zone after an event concludes.

Key Features

• Creation of spawn points for teleporting players from specified regions
• Mass teleportation of all players from selected regions to designated locations
• Ability to exclude specific players from the teleportation process
• Clearing specified regions of specific entity types
• regiontp-on-entry flag - automatic player teleportation upon entering a region
• regiontp-on-exit flag - player teleportation upon exiting a region
• player-loot-drop flag - prevents player loot from dropping upon death
• mob-loot-drop flag - prevents mob loot from dropping upon death

Installation

1. Download the RegionTeleport.jar file
2. Ensure the server is using Java 21 or higher
3. Install WorldGuard
4. Upload all files to the plugins folder
5. Restart the server

Dependencies

• WorldGuard (7.0.0+) - mandatory dependency for plugin operation

Additional Dependencies

• CMI (9.0.0.0+) - adds ability to use CMI warps as spawn points. Usage: /regiontp tp cmi:
• EssentialsX - allows using Essentials warps as spawn points. Usage: /regiontp tp ess:
• PlaceholderAPI - adds additional placeholders

Commands and Permissions

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

• /regiontp help - shows list of all commands (permission: regionteleport.command.help)
• /regiontp reload - reloads the plugin (permission: regionteleport.command.reload)
• /regiontp list (page) - displays all spawn points (permission: regionteleport.command.list)
• /regiontp setspawn (x y z) (yaw pitch) (world) - creates a spawn point (permission: regionteleport.command.setspawn)
• /regiontp delspawn - deletes the specified spawn point (permission: regionteleport.command.delspawn)
• /regiontp tp <"region1 region2 ..."> <"point1 point2 ..."> (-s) - teleports all players in regions to specified locations (permission: regionteleport.command.teleport)

Examples:

• /regiontp tp minecraft:world global "point1 point2" - teleports players in minecraft:world world to point1 or point2

• /regiontp tp "region1 region2" point1 - teleports players in regions 1 and 2 to point1

• /regionclear <"region1 region2 ..."> <"option1 option2 ..."> (-s) - removes specified entities from selected regions (permission: regionteleport.command.clear)

Available Options:

• all - removes all monsters/animals/ambient entities/items/vehicles that aren't named, tamed, or NPCs
• monsters - monsters
• animals - animals
• ambient - ambient entities (bats)
• items(:<item1,item2,...>) - items (separate item types with commas)
• vehicles - vehicles (doesn't include living creatures like horses)
• specific:<entity1,entity2,...> - specific entity types
• displays (only 1.19.4+)
• named(-only:<name1,name2,...>) - named entities
• tamed(-only) - tamed creatures
• npcs(-only) - NPCs (removes entities with NPC metadata)

Examples:

• /regionclear minecraft:world global "animals named-only:dave" - removes animals named dave in minecraft:world world
• /regionclear "region1 region2" "items:diamond,dirt animals tamed" - removes all animals, tamed animals, and dropped diamonds/dirt items from regions 1 and 2
• /regionclear region1 specific:sheep,ender_crystal - removes sheep and end crystals in region1

Additional Permissions:

• regiontp.teleport.bypass - player is not teleported when in a region
• regiontp.* - grants all permissions except teleport bypass

Placeholders

• %regionteleport_player_count_w:_r:% - counts number of players in specified region of world (use global for entire world)
• %regionteleport_player_count_exclude_bypass_w:_r:% - counts number of players excluding those with teleport bypass permission in specified region of world (use global for entire world)