WIKI
TeleportPack Plugin
Introduction
TeleportPack is a powerful multi-world teleportation plugin that provides a complete teleportation solution for Minecraft servers. It supports random teleportation, precise coordinate teleportation, return to previous location, respawn point teleportation, and integrates with economic systems and permission management.
Key Features
- Multi-world Teleportation Support - Free teleportation between different worlds
- Random Teleport (RTP) - Find safe locations within specified ranges for teleportation
- Precise Coordinate Teleportation - Teleport to exact coordinates in specified worlds
- Return Functionality - Return to previous location with cross-world support
- Respawn System - Custom respawn point locations for each world
- Economic System Integration - Full Vault economic system support
- Smart Fallback - Intelligent return mechanism with automatic random teleport fallback
- Particle Effects - Visual effects during teleportation
- Title Messages - Title prompts during teleportation process
- Cooldown System - Prevent command abuse
- Permission Management - Fine-grained permission control
- Install Plugin - Place the plugin in the plugins folder and restart the server
- Configure Worlds - Edit config.yml to set teleportation parameters for each world
- Set Permissions - Assign appropriate permissions to player groups
- Start Using - Players can use /rtp, /tp, /back commands
⚙️ Configuration Tutorial
Configuration File Structure
TeleportPack uses config.yml as the main configuration file, containing the following main sections:
- teleport - General teleportation settings
- random-teleport - Random teleportation configuration
- costs - Economic system configuration
- back - Return functionality configuration
- respawn - Respawn point configuration
- messages - Message configuration
Basic Settings
Code (Text):
teleport:
delay: 3 # Teleport delay (seconds)
allow-movement: false # Allow movement during teleportation
cooldown: 10 # Command cooldown (seconds)
delay: 3 # Teleport delay (seconds)
allow-movement: false # Allow movement during teleportation
cooldown: 10 # Command cooldown (seconds)
Code (Text):
title:
enabled: true # Enable title messages
main: "&aTeleporting!" # Main title
sub: "&7Please wait {countdown} seconds..." # Subtitle
fadeIn: 10 # Fade in time (ticks)
stay: 40 # Stay time (ticks)
fadeOut: 10 # Fade out time (ticks)
enabled: true # Enable title messages
main: "&aTeleporting!" # Main title
sub: "&7Please wait {countdown} seconds..." # Subtitle
fadeIn: 10 # Fade in time (ticks)
stay: 40 # Stay time (ticks)
fadeOut: 10 # Fade out time (ticks)
Code (Text):
particles:
enabled: true # Enable particle effects
type: PORTAL # Particle type
count: 50 # Particle count
enabled: true # Enable particle effects
type: PORTAL # Particle type
count: 50 # Particle count
Code (Text):
sounds:
enabled: true # Enable sounds
start: BLOCK_PORTAL_TRIGGER # Start sound
complete: ENTITY_ENDERMAN_TELEPORT # Complete sound
enabled: true # Enable sounds
start: BLOCK_PORTAL_TRIGGER # Start sound
complete: ENTITY_ENDERMAN_TELEPORT # Complete sound
Target World
Code (Text):
random-teleport:
target-world: world # Default teleport world
target-world: world # Default teleport world
Code (Text):
worlds:
world:
enabled: true # Enable random teleport for this world
min-range: 100 # Minimum range
max-range: 5000 # Maximum range
# Fixed height settings
fixed-height:
enabled: false # Use fixed height
min-y: 60 # Minimum Y value
max-y: 100 # Maximum Y value
# Terrain checking
terrain:
allow-water: false # Allow water
allow-lava: false # Allow lava
allowed-blocks: # Allowed blocks
- GRASS_BLOCK
- DIRT
- STONE
- SAND
forbidden-blocks: # Forbidden blocks
- CACTUS
- MAGMA_BLOCK
# Excluded biomes
excluded-biomes:
- OCEAN
- DEEP_OCEAN
world:
enabled: true # Enable random teleport for this world
min-range: 100 # Minimum range
max-range: 5000 # Maximum range
# Fixed height settings
fixed-height:
enabled: false # Use fixed height
min-y: 60 # Minimum Y value
max-y: 100 # Maximum Y value
# Terrain checking
terrain:
allow-water: false # Allow water
allow-lava: false # Allow lava
allowed-blocks: # Allowed blocks
- GRASS_BLOCK
- DIRT
- STONE
- SAND
forbidden-blocks: # Forbidden blocks
- CACTUS
- MAGMA_BLOCK
# Excluded biomes
excluded-biomes:
- OCEAN
- DEEP_OCEAN
Code (Text):
max-attempts: 20 # Maximum attempts
safe-check: true # Ena
safe-check: true # Ena
Economic System Configuration (costs)
Enable Economy
Code (Text):
costs:
enabled: true # Enable economic system
enabled: true # Enable economic system
Code (Text):
tp:
money: 100 # Precise teleport cost
conditions: # Usage conditions
- "%player_level% >= 10"
condition-messages: # Condition not met messages
- "&cYou need at least level 10 to use this command!"
rtp:
money: 50 # Random teleport cost
conditions: []
condition-messages: []
back:
money: 200 # Return cost
conditions: []
condition-messages: []
respawn:
money: 0 # Respawn point teleport cost
conditions: []
condition-messages: []
money: 100 # Precise teleport cost
conditions: # Usage conditions
- "%player_level% >= 10"
condition-messages: # Condition not met messages
- "&cYou need at least level 10 to use this command!"
rtp:
money: 50 # Random teleport cost
conditions: []
condition-messages: []
back:
money: 200 # Return cost
conditions: []
condition-messages: []
respawn:
money: 0 # Respawn point teleport cost
conditions: []
condition-messages: []
Code (Text):
back:
enabled: true # Enable return functionality
allow-in-same-world: true # Allow same-world return
allow-cross-world: true # Allow cross-world return
expire-time: 600 # Location expiration time (seconds)
clear-on-death: true # Clear location on death
cross-world-extra-cost: 100 # Cross-world extra cost
enabled: true # Enable return functionality
allow-in-same-world: true # Allow same-world return
allow-cross-world: true # Allow cross-world return
expire-time: 600 # Location expiration time (seconds)
clear-on-death: true # Clear location on death
cross-world-extra-cost: 100 # Cross-world extra cost
World Respawn Point Settings
Code (Text):
respawn:
enabled: true # Enable respawn point system
worlds:
world:
x: 0 # X coordinate
y: 80 # Y coordinate
z: 0 # Z coordinate
yaw: 0 # Yaw angle
pitch: 0 # Pitch angle
world_nether:
x: 0
y: 70
z: 0
yaw: 90
pitch: 0
enabled: true # Enable respawn point system
worlds:
world:
x: 0 # X coordinate
y: 80 # Y coordinate
z: 0 # Z coordinate
yaw: 0 # Yaw angle
pitch: 0 # Pitch angle
world_nether:
x: 0
y: 70
z: 0
yaw: 90
pitch: 0
Code (Text):
fork-command:
enabled: true
command-name: "smartback" # Command name
permission: "teleportpack.smartback" # Permission
primary-cmd: "backworld world" # Primary command
fallback-cmd: "rtp" # Fallback command
messages:
executing-primary: "&aReturning to your previous location in world!"
executing-fallback: "&cNo previous location found, teleporting randomly!"
enabled: true
command-name: "smartback" # Command name
permission: "teleportpack.smartback" # Permission
primary-cmd: "backworld world" # Primary command
fallback-cmd: "rtp" # Fallback command
messages:
executing-primary: "&aReturning to your previous location in world!"
executing-fallback: "&cNo previous location found, teleporting randomly!"
Message Prefix
Code (Text):
messages:
prefix: "&6[TeleportPack] &r" # Message prefix
prefix: "&6[TeleportPack] &r" # Message prefix
Code (Text):
teleporting: "&aTeleporting in &e{countdown} &aseconds..."
teleport-success: "&aTeleport successful!"
teleport-cancelled: "&cTeleport cancelled!"
no-permission: "&cYou do not have permission!"
invalid-world: "&cInvalid world name!"
world-disabled: "&cRandom teleport is disabled in this world!"
invalid-coordinates: "&cInvalid coordinates!"
no-back-location: "&cNo previous location to return to!"
back-location-expired: "&cYour previous location has expired!"
cooldown-message: "&cPlease wait &e{time} &cseconds before using this command again!"
random-teleport-fail: "&cCould not find a safe location to teleport!"
not-enough-money: "&cYou do not have enough money! Required: &e${cost}"
money-deducted: "&aDeducted &e${cost}"
condition-not-met: "&cTeleport condition not met:"
teleport-countdown: "&e{time} &aseconds left to teleport..."
respawn-set: "&aRespawn point set for world: &e{world}"
respawn-teleport: "&aYou have been respawned at the configured location!"
reload-success: "&aTeleportPack config reloaded!"
no-respawn-point: "&cNo respawn point set for this world!"
respawn-cost: "&aTeleporting to respawn point - cost: &e${cost}"
teleport-success: "&aTeleport successful!"
teleport-cancelled: "&cTeleport cancelled!"
no-permission: "&cYou do not have permission!"
invalid-world: "&cInvalid world name!"
world-disabled: "&cRandom teleport is disabled in this world!"
invalid-coordinates: "&cInvalid coordinates!"
no-back-location: "&cNo previous location to return to!"
back-location-expired: "&cYour previous location has expired!"
cooldown-message: "&cPlease wait &e{time} &cseconds before using this command again!"
random-teleport-fail: "&cCould not find a safe location to teleport!"
not-enough-money: "&cYou do not have enough money! Required: &e${cost}"
money-deducted: "&aDeducted &e${cost}"
condition-not-met: "&cTeleport condition not met:"
teleport-countdown: "&e{time} &aseconds left to teleport..."
respawn-set: "&aRespawn point set for world: &e{world}"
respawn-teleport: "&aYou have been respawned at the configured location!"
reload-success: "&aTeleportPack config reloaded!"
no-respawn-point: "&cNo respawn point set for this world!"
respawn-cost: "&aTeleporting to respawn point - cost: &e${cost}"
Multi-world Configuration
Code (Text):
random-teleport:
worlds:
world:
enabled: true
min-range: 100
max-range: 5000
world_nether:
enabled: true
min-range: 50
max-range: 1000
terrain:
allow-lava: true
allowed-blocks:
- NETHERRACK
- SOUL_SAND
- NETHER_BRICKS
forbidden-blocks:
- LAVA
world_the_end:
enabled: true
min-range: 100
max-range: 2000
excluded-biomes:
- THE_END_VOID
VIP Permission Configuration
costs:
tp:
money: 0 # VIP free teleportation
conditions: []
worlds:
world:
enabled: true
min-range: 100
max-range: 5000
world_nether:
enabled: true
min-range: 50
max-range: 1000
terrain:
allow-lava: true
allowed-blocks:
- NETHERRACK
- SOUL_SAND
- NETHER_BRICKS
forbidden-blocks:
- LAVA
world_the_end:
enabled: true
min-range: 100
max-range: 2000
excluded-biomes:
- THE_END_VOID
VIP Permission Configuration
costs:
tp:
money: 0 # VIP free teleportation
conditions: []
After configuration is complete, use the command to validate:
/tpreload
Check the console for any error messages to ensure all configurations are loaded correctly.
❓ Frequently Asked Questions
Installation Issues
Q1: Plugin Fails to Load
Issue Description: Plugin fails to load during server startup
Possible Causes:
- Java version incompatibility
- Server version not supported
- Missing dependency plugins
Q2: Commands Invalid or Non-existent
Issue Description: Inputting commands shows "unknown command"
Solutions:
# Check if plugin is enabled
/plugins list | grep TeleportPack
# Check console errors
Look for error messages in console
# Reload plugin
/tpreload
Teleportation Issues
Q3: Random Teleport Fails
Issue Description: /rtp command shows "Could not find safe location"
Possible Causes:
- World configuration error
- Teleportation range settings unreasonable
- Safety checks too strict
# Check world configuration
random-teleport:
worlds:
world:
enabled: true
min-range: 100 # Not too small
max-range: 5000 # Not too large
max-attempts: 20 # Increase attempts
safe-check: true # Can temporarily disable for testing
Resource Information
Author:
----------
Total Downloads:
94
First Release:
Aug 7, 2025
Last Update:
Aug 13, 2025
Category:
---------------
All-Time Rating:
0 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings