?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
TpoCommand

TpoCommand

A simple moderation teleport command plugin.

3
0
3
0

Compatibility

Minecraft: Java Edition

26.1.x
1.21.x

Platforms

Links

Donate on PayPal

Tags

Creators

Details

Licensed MIT
Published 2 days ago

🌍 TpoCommand

Ever wanted to teleport to any player without typing coordinates? Just type /tpo <user> and done.

Paper Purpur Spigot Bukkit Modrinth

Discord
Please contact me on Discord if you have any suggestions or edits.

🎯 What Does It Do?

TpoCommand adds a powerful /tpo command that instantly teleports you to any player on the server. It supports online and offline teleportation, cooldowns, silent mode, forbidden players, world blacklist and whitelist management, update notifications, and detailed logging. No bloat. No lag. Just teleportation.

⌨️ Commands & Permissions

Command Permission Description
/tpo <user> tpocommand.use Teleport to an online player
/tpo <user> (offline) tpocommand.use.offline Teleport to offline player's last location
/tpo forbidden add <user> tpocommand.forbidden Add a player to forbidden list
/tpo forbidden remove <user> tpocommand.forbidden Remove a player from forbidden list
/tpo world blacklist <world> tpocommand.world.blacklist Toggle a world in blacklist
/tpo world whitelist <world> tpocommand.world.whitelist Toggle a world in whitelist
/tpo reload tpocommand.reload Reload the configuration
/tpo credits tpocommand.credits View plugin credits
/tpo permissions Everyone View all permissions

🎁 Features

  • Instant teleport to online players
  • Offline teleport to player's last known location
  • Cooldown system with bypass permission
  • Silent teleport mode for founders/admins
  • Forbidden player system
  • World blacklist and whitelist system
  • Fully customizable messages, titles, actionbars, and sounds
  • Teleport alerts for staff
  • Update notify on join
  • Logs all teleports into logs.txt

📁 Config

A folder named TpoCommand is created in your plugins folder automatically. Inside you will find a clean config.yml file.

# ==========================================================
#
#         TpoCommand  —  config.yml
#                  by SirSnaryo
#
#   Works on:  Paper · Spigot · Bukkit · Purpur
#   Version:   1.21.x
#
# ==========================================================
#
#
# ┌─────────────────────────────────────────────────────────┐
# │                    COLOR CODES                          │
# ├─────────────────────────────────────────────────────────┤
# │  &f = white        &7 = gray         &0 = black        │
# │  &a = green        &c = red          &e = yellow       │
# │  &b = aqua         &9 = blue         &d = purple       │
# │  &l = bold         &o = italic       &r = reset all    │
# │  &#RRGGBB = any hex color  (e.g. &#FF5500 = orange)    │
# └─────────────────────────────────────────────────────────┘
#
#
# ┌─────────────────────────────────────────────────────────┐
# │                    PLACEHOLDERS                         │
# ├─────────────────────────────────────────────────────────┤
# │  [user]    →  the player who used the command           │
# │  [target]  →  the player being teleported to            │
# │  [time]    →  remaining cooldown seconds                │
# │  [world]   →  world name                                │
# └─────────────────────────────────────────────────────────┘
#
#
# ┌─────────────────────────────────────────────────────────┐
# │                   BROKEN CONFIG                         │
# ├─────────────────────────────────────────────────────────┤
# │  If you break this file the plugin automatically        │
# │  deletes it and regenerates a clean copy on startup.    │
# └─────────────────────────────────────────────────────────┘
#
# ==========================================================


# ──────────────────────────────────────────────────────────
#                   OFFLINE TELEPORT
# ──────────────────────────────────────────────────────────
# Teleports the player to the offline player's last known
# location. Requires permission: tpocommand.use.offline

offline-teleport:
  enabled: true


# ──────────────────────────────────────────────────────────
#                     COOLDOWN
# ──────────────────────────────────────────────────────────
# Time in seconds between /tpo uses.
# Bypass permission: tpocommand.cooldown.bypass

cooldown:
  enabled: true
  time: 5


# ──────────────────────────────────────────────────────────
#                 FORBIDDEN PLAYERS
# ──────────────────────────────────────────────────────────
# Players listed here cannot be teleported to.
# Bypass permission: tpocommand.bypass.forbidden
# Manage with: /tpo forbidden add/remove <user>

forbidden-players:
  - ""


# ──────────────────────────────────────────────────────────
#                  WORLD BLACKLIST
# ──────────────────────────────────────────────────────────
# Worlds where /tpo cannot be used.
# Manage with: /tpo world blacklist <world>
# Permission: tpocommand.world.blacklist

world-blacklist:
  - ""


# ──────────────────────────────────────────────────────────
#                  WORLD WHITELIST
# ──────────────────────────────────────────────────────────
# If any world is listed here, /tpo can ONLY be used
# in these worlds. Leave empty to disable whitelist.
# Manage with: /tpo world whitelist <world>
# Permission: tpocommand.world.whitelist

world-whitelist:
  - ""


# ──────────────────────────────────────────────────────────
#                     LOGGING
# ──────────────────────────────────────────────────────────
# Saves teleport logs to plugins/TpoCommand/logs.txt
# Placeholders: [time], [user], [target]

logging:
  enabled: true
  include-time: true
  format: "[time] [user] has teleported to [target]"


# ──────────────────────────────────────────────────────────
#                  UPDATE NOTIFY
# ──────────────────────────────────────────────────────────
# Shows update message to all players on join if outdated.

update-notify:
  enabled: true
  message: "&#8B4513[TpoCommand] &7A new update is available! &fv[latest] &7at &#8B4513modrinth.com/plugin/tpocommand"


# ──────────────────────────────────────────────────────────
#                    WRONG USAGE
# ──────────────────────────────────────────────────────────

wrong-usage:
  chat:
    enabled: true
    message: "&7Please use /tpo <user>"
  actionbar:
    enabled: true
    message: "&7Please use /tpo <user>"
  title:
    enabled: false
    message: "&cWrong Usage"
    subtitle: "&7Please use /tpo <user>"
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#                  TARGET NOT FOUND
# ──────────────────────────────────────────────────────────

target-not-found:
  chat:
    enabled: true
    message: "&cThis user does not exist."
  actionbar:
    enabled: true
    message: "&cThis user does not exist."
  title:
    enabled: false
    message: "&cNot Found"
    subtitle: "&cThis user does not exist."
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#                  NO PERMISSION
# ──────────────────────────────────────────────────────────

no-permission:
  chat:
    enabled: true
    message: "&cYou do not have permission to use this command."
  actionbar:
    enabled: true
    message: "&cNo permission."
  title:
    enabled: false
    message: "&cNo Permission"
    subtitle: "&7You cannot use this command."
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#                    COOLDOWN
# ──────────────────────────────────────────────────────────

cooldown-message:
  chat:
    enabled: true
    message: "&cPlease wait [time]s"
  actionbar:
    enabled: true
    message: "&cPlease wait [time]s"
  title:
    enabled: false
    message: "&cCooldown"
    subtitle: "&7Please wait [time]s"
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#                  TELEPORT SUCCESS
# ──────────────────────────────────────────────────────────

teleport-success:
  chat:
    enabled: false
    message: "&7Teleported to &c[target]"
  actionbar:
    enabled: false
    message: "&7Teleported to &c[target]"
  title:
    enabled: false
    message: "&aTeleported"
    subtitle: "&7You teleported to &c[target]"
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: false
    sound: "ENTITY_ENDERMAN_TELEPORT"


# ──────────────────────────────────────────────────────────
#                  TELEPORT ALERT
# ──────────────────────────────────────────────────────────
# Sent to all players with tpocommand.alert permission.
# Not sent if the teleporter has tpocommand.use.silent.

teleport-alert:
  chat:
    enabled: true
    message: "&c[user] &7has teleported to &c[target]"
  actionbar:
    enabled: false
    message: "&c[user] &7has teleported to &c[target]"
  title:
    enabled: false
    message: "&eTeleport Alert"
    subtitle: "&c[user] &7teleported to &c[target]"
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: false
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"


# ──────────────────────────────────────────────────────────
#              OFFLINE TELEPORT SUCCESS
# ──────────────────────────────────────────────────────────
# Disabled by default so the command executor gets no
# success message when teleporting to an offline user.

offline-teleport-success:
  chat:
    enabled: false
    message: "&7Teleported to &c[target] &7(offline)"
  actionbar:
    enabled: false
    message: "&7Teleported to &c[target] &7(offline)"
  title:
    enabled: false
    message: "&aTeleported"
    subtitle: "&7You teleported to &c[target] &7(offline)"
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: false
    sound: "ENTITY_ENDERMAN_TELEPORT"


# ──────────────────────────────────────────────────────────
#              OFFLINE TELEPORT ALERT
# ──────────────────────────────────────────────────────────
# Sent to all players with tpocommand.alert permission.
# Not sent if the teleporter has tpocommand.use.silent.

offline-teleport-alert:
  chat:
    enabled: true
    message: "&c[user] &7has teleported to &c[target] &7(offline)"
  actionbar:
    enabled: false
    message: "&c[user] &7has teleported to &c[target] &7(offline)"
  title:
    enabled: false
    message: "&eTeleport Alert"
    subtitle: "&c[user] &7teleported to &c[target] &7(offline)"
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: false
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"


# ──────────────────────────────────────────────────────────
#          OFFLINE TELEPORT NO PERMISSION
# ──────────────────────────────────────────────────────────

offline-no-permission:
  chat:
    enabled: true
    message: "&cYou do not have permission to teleport to offline players."
  actionbar:
    enabled: true
    message: "&cNo offline teleport permission."
  title:
    enabled: false
    message: "&cNo Permission"
    subtitle: "&7You cannot teleport to offline players."
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#          OFFLINE TELEPORT DISABLED
# ──────────────────────────────────────────────────────────

offline-disabled:
  chat:
    enabled: true
    message: "&cOffline teleport is disabled."
  actionbar:
    enabled: true
    message: "&cOffline teleport is disabled."
  title:
    enabled: false
    message: "&cDisabled"
    subtitle: "&7Offline teleport is not enabled."
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#         OFFLINE TELEPORT NO DATA
# ──────────────────────────────────────────────────────────

offline-no-data:
  chat:
    enabled: true
    message: "&cThis user does not exist."
  actionbar:
    enabled: true
    message: "&cThis user does not exist."
  title:
    enabled: false
    message: "&cNo Data"
    subtitle: "&cThis user does not exist."
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#                FORBIDDEN PLAYER
# ──────────────────────────────────────────────────────────

forbidden-message:
  chat:
    enabled: true
    message: "&cYou don't have permission to teleport to [target]"
  actionbar:
    enabled: true
    message: "&cYou don't have permission to teleport to [target]"
  title:
    enabled: false
    message: "&cForbidden"
    subtitle: "&7You cannot teleport to [target]"
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#              FORBIDDEN ADD/REMOVE
# ──────────────────────────────────────────────────────────

forbidden-added:
  chat:
    enabled: true
    message: "&7Added &c[target] &7to forbidden list."
  actionbar:
    enabled: true
    message: "&7Added &c[target] &7to forbidden list."
  title:
    enabled: false
    message: "&aAdded"
    subtitle: "&c[target] &7is now forbidden"
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"

forbidden-removed:
  chat:
    enabled: true
    message: "&7Removed &c[target] &7from forbidden list."
  actionbar:
    enabled: true
    message: "&7Removed &c[target] &7from forbidden list."
  title:
    enabled: false
    message: "&aRemoved"
    subtitle: "&c[target] &7is no longer forbidden"
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"

forbidden-already:
  chat:
    enabled: true
    message: "&c[target] &7is already in the forbidden list."
  actionbar:
    enabled: true
    message: "&c[target] &7is already forbidden."
  title:
    enabled: false
    message: ""
    subtitle: ""
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"

forbidden-not-found:
  chat:
    enabled: true
    message: "&c[target] &7is not in the forbidden list."
  actionbar:
    enabled: true
    message: "&c[target] &7is not forbidden."
  title:
    enabled: false
    message: ""
    subtitle: ""
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#                WORLD BLOCKED
# ──────────────────────────────────────────────────────────

world-blocked:
  chat:
    enabled: true
    message: "&cYou cannot use /tpo in this world."
  actionbar:
    enabled: true
    message: "&cBlocked in this world."
  title:
    enabled: false
    message: "&cBlocked"
    subtitle: "&7/tpo is disabled in this world."
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#            WORLD BLACKLIST/WHITELIST
# ──────────────────────────────────────────────────────────

world-added:
  chat:
    enabled: true
    message: "&7Added &c[world] &7to [list]."
  actionbar:
    enabled: true
    message: "&7Added &c[world] &7to [list]."
  title:
    enabled: false
    message: ""
    subtitle: ""
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"

world-removed:
  chat:
    enabled: true
    message: "&7Removed &c[world] &7from [list]."
  actionbar:
    enabled: true
    message: "&7Removed &c[world] &7from [list]."
  title:
    enabled: false
    message: ""
    subtitle: ""
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"

world-already:
  chat:
    enabled: true
    message: "&c[world] &7is already in [list]."
  actionbar:
    enabled: true
    message: "&c[world] &7is already in [list]."
  title:
    enabled: false
    message: ""
    subtitle: ""
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"

world-not-found:
  chat:
    enabled: true
    message: "&c[world] &7is not in [list]."
  actionbar:
    enabled: true
    message: "&c[world] &7is not in [list]."
  title:
    enabled: false
    message: ""
    subtitle: ""
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"


# ──────────────────────────────────────────────────────────
#                     RELOAD
# ──────────────────────────────────────────────────────────

reload:
  chat:
    enabled: true
    message: "&aReloaded config.yml"
  actionbar:
    enabled: true
    message: "&aReloaded config.yml"
  title:
    enabled: false
    message: "&aReloaded"
    subtitle: "&7config.yml has been reloaded."
    fade-in: 10
    stay: 40
    fade-out: 10
  sound:
    enabled: true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"


# ──────────────────────────────────────────────────────────
#                   CONSOLE ONLY
# ──────────────────────────────────────────────────────────

console-only:
  message: "&cOnly players can use this command."


# ──────────────────────────────────────────────────────────
#                   PERMISSIONS
# ──────────────────────────────────────────────────────────
#
#  tpocommand.use              — Allows use of /tpo <user>
#                                 Default: Operator
#
#  tpocommand.use.offline      — Allows teleporting to offline
#                                 players' last known location
#                                 Default: Operator
#
#  tpocommand.use.silent       — Teleport without sending
#                                 alert to staff
#                                 Default: Operator
#
#  tpocommand.alert            — Receive teleport alerts
#                                 Default: Operator
#
#  tpocommand.reload           — Allows use of /tpo reload
#                                 Default: Operator
#
#  tpocommand.credits          — Allows use of /tpo credits
#                                 Default: Everyone
#
#  tpocommand.cooldown.bypass  — Bypass the teleport cooldown
#                                 Default: Operator
#
#  tpocommand.forbidden        — Allows /tpo forbidden add/remove
#                                 Default: Operator
#
#  tpocommand.bypass.forbidden — Bypass forbidden restriction
#                                 Default: Operator
#
#  tpocommand.world.blacklist  — Allows /tpo world blacklist
#                                 Default: Operator
#
#  tpocommand.world.whitelist  — Allows /tpo world whitelist
#                                 Default: Operator
#
# ──────────────────────────────────────────────────────────

📥 Installation

  1. Download the latest version of TpoCommand.
  2. Drop the .jar file into your server's plugins folder.
  3. Restart your server.
  4. Done! No additional setup required.

✅ Supported Versions

  • 1.21.x

💻 Supported Platforms

  • Paper, Purpur, Spigot, Bukkit

🔒 Permissions

Permission Default Description
tpocommand.use OP Use /tpo <user>
tpocommand.use.offline OP Teleport to offline players
tpocommand.use.silent OP Teleport without sending alerts
tpocommand.alert OP Receive teleport alerts
tpocommand.reload OP Reload config
tpocommand.credits Everyone Use /tpo credits
tpocommand.cooldown.bypass OP Bypass teleport cooldown
tpocommand.forbidden OP Manage forbidden players
tpocommand.bypass.forbidden OP Bypass forbidden players
tpocommand.world.blacklist OP Manage world blacklist
tpocommand.world.whitelist OP Manage world whitelist

Modrinth Gallery

Example

Example

Example

© 2026 SirSnaryo. All rights reserved to MIT.

Donate via PayPal