EssentialsX Teleport Addon

Instead of teleporting players instantly after a request is accepted, the plugin starts a visible countdown at the teleport destination. A hologram appears, players can see who is teleporting, how much time is left, and the teleport can be cancelled by hitting the hologram.

This makes teleporting more interactive, more visible, and much more balanced for survival, PvP, SMP, Towny, clan, and economy servers.

Main Features

[]Full EssentialsX teleport request support
[]Works with /tpa, /tpahere, and /tpaccept
[]Replaces instant accepted teleports with a custom countdown system
[]Creates a hologram at the teleport destination
[]Shows the teleporting player, target player, countdown time, and relation info
[]Allows players to cancel active teleports by hitting the hologram
[]Supports DecentHolograms for clean hologram visuals
[]Includes a lightweight fallback system if DecentHolograms is not installed
[]Supports UltimateClans and PlaceholderAPI for clan relation detection
[]Can display ally, enemy, and neutral teleport warnings
[]Includes title, actionbar, sound, and particle effects
[]Separate English and Turkish language files
Performance-friendly and optimized for live servers

Supported Teleport Commands

Code:
/tpa
/tpahere
/tpaccept

These commands are handled by EssentialsX. EpicEssentialsTeleportHologram hooks into accepted teleport requests and applies its custom countdown system.

Plugin Command

Code:
/etpholo reload

Reloads the plugin configuration and language files.

Permissions

Code:
etpholo.admin
Allows access to admin commands such as reload.

Code:
etpholo.bypass
Allows players to bypass the custom teleport countdown if bypass permission is enabled in the configuration.

Hologram Countdown System

When a teleport request is accepted, a hologram appears at the teleport destination and the countdown starts.

Example hologram:

Code:
TELEPORT
Steve → Alex
5s left
Hit to cancel

The hologram can display:

[]Teleporting player
[]Target player
[]Remaining seconds
[]Clan relation
Cancel warning

Hit to Cancel

Players can cancel an active teleport by hitting the hologram.

This is especially useful for PvP, survival, clan, and SMP servers where teleporting directly to another player should have some risk and visibility.

Example configuration:

YAML:
settings:
cancel-on-hologram-hit: true
cancel-on-hologram-interact: true
cancel-on-teleportee-move: false
cancel-on-damage: false
cancel-on-quit: true

DecentHolograms Support

If DecentHolograms is installed, the plugin can automatically use it for clean and professional hologram visuals.

Recommended configuration:

YAML:
hologram:
decentholograms:
enabled: true
require-for-visual: true
vertical-offset: 1.35
spawn-hitbox: true
fallback-armorstand-visual: false

If DecentHolograms is not installed, the plugin can use its lightweight fallback system.

UltimateClans and PlaceholderAPI Support

EpicEssentialsTeleportHologram can integrate with UltimateClans and PlaceholderAPI.

When a player teleports to another player, the plugin can detect clan relations and display warnings.

Supported relation examples:

[]ALLY
[]ENEMY
NEUTRAL

This helps players understand who is teleporting to them or who they are teleporting to before the teleport is completed.

Titles, Actionbar, and Sounds

During the teleport countdown, players can receive title messages, actionbar warnings, and sound effects.

Example messages:

Code:
Teleporting in 5 seconds
You are teleporting to Alex
Steve is teleporting to you
Enemy player detected
Ally player detected

Countdown sound example:

YAML:
effects:
tick-sound:
enabled: true
sound: "BLOCK_NOTE_BLOCK_PLING"
volume: 0.35
pitch: 1.6
only-last-seconds: 5

Particle Animation

A lightweight rotating particle effect can appear above the teleporting player during the countdown.

Example configuration:

YAML:
animation:
head:
enabled: true
particle: END_ROD
update-ticks: 5
radius: 0.55
height: 2.25

This makes the teleport process more noticeable without using heavy visual effects.

Language Files

Messages are stored separately from the main configuration file.

File structure:

Code:
plugins/EpicEssentialsTeleportHologram/
├─ config.yml
└─ messages/
├─ en.yml
└─ tr.yml

Supported by default:

[]English
[]Turkish

Language selection:

YAML:
language: en
messages-file: messages/en.yml

or:

YAML:
language: tr
messages-file: messages/tr.yml

Available Placeholders

You can use the following placeholders in messages and hologram lines:

Code:
%teleportee%
%target%
%seconds%
%attacker%
%relation%
%teleportee_clan%
%target_clan%
%prefix%

Example hologram lines:

YAML:
lines:

[LIST]
[]"&#ff6b00&lTELEPORT"
[]"&f%teleportee% &7→ &e%target%"
[]"&c%seconds%s &7left"
[]"&7Relation: %relation%"
[/LIST]

Example Configuration

YAML:
settings:
enabled: true
countdown-seconds: 10
hologram-location-mode: DESTINATION
cancel-on-hologram-hit: true
cancel-on-hologram-interact: true
cancel-on-teleportee-move: false
cancel-on-damage: false
cancel-on-quit: true
allow-bypass-permission: true
max-active-teleports: 25
start-cooldown-seconds: 2

hologram:
decentholograms:
enabled: true
require-for-visual: true
vertical-offset: 1.35
spawn-hitbox: true
fallback-armorstand-visual: false

ultimateclans:
enabled: true
relation-title: true

animation:
head:
enabled: true
particle: END_ROD
update-ticks: 5
radius: 0.55
height: 2.25

effects:
start-sound:
enabled: true
sound: "BLOCK_BEACON_ACTIVATE"
volume: 0.45
pitch: 1.0

tick-sound:
enabled: true
sound: "BLOCK_NOTE_BLOCK_PLING"
volume: 0.35
pitch: 1.6
only-last-seconds: 5

success-sound:
enabled: true
sound: "ENTITY_ENDERMAN_TELEPORT"
volume: 0.6
pitch: 1.0

Example Messages

YAML:
messages:
prefix: "&#ff6b00&lTeleport &8» "

started-teleportee: "%prefix%&7You are teleporting to &e%target%&7. &f%seconds%s"
started-target: "%prefix%&e%teleportee% &7is teleporting to you. Hit the hologram to cancel."

countdown-actionbar: "&#ff6b00&lTP &8| &7Teleporting in &f%seconds%s"

cancelled-hit: "%prefix%&cTeleport cancelled. &f%attacker% &7hit the hologram."
cancelled-quit: "%prefix%&cTeleport cancelled because a player left the server."
success: "%prefix%&aTeleport completed."

Installation

[]Install EssentialsX on your server.
[]Optional: Install DecentHolograms.
[]Optional: Install PlaceholderAPI and UltimateClans.
[]Place EpicEssentialsTeleportHologram.jar into your /plugins folder.
[]Restart your server.
[]Edit config.yml and language files.
Reload the plugin if needed:

Code:
/etpholo reload

Dependencies

Required

EssentialsX

Optional

[]DecentHolograms
[]PlaceholderAPI
UltimateClans

Recommended setup:

Code:
EssentialsX + DecentHolograms + PlaceholderAPI + UltimateClans

Performance Friendly

EpicEssentialsTeleportHologram is designed to be lightweight and efficient.

Optimization features:

[]Single global countdown task
[]Cached configuration values
[]Limited active teleport sessions
[]Low-frequency particle animation
[]Optional sound effects
[]No constant heavy entity scanning
[]Soft hook system for DecentHolograms
[]Fallback visual system can be disabled by default

Recommended survival settings:

YAML:
settings:
max-active-teleports: 25
cancel-on-teleportee-move: false
cancel-on-damage: false

effects:
tick-sound:
enabled: true
only-last-seconds: 5

animation:
head:
update-ticks: 5

Why Use This Plugin?

Default teleport systems are usually instant and invisible once a request is accepted. This can create unfair or confusing situations, especially on PvP, clan, Towny, and survival servers.

EpicEssentialsTeleportHologram makes teleporting more visible, more controlled, and more balanced.

Players can:

[]See who is teleporting
[]See who the player is teleporting to
[]Track the remaining countdown time
[]Cancel risky teleports by hitting the hologram
View clan relation warnings before the teleport finishes

This turns teleporting from a basic command into a more polished and interactive gameplay mechanic.

EpicEssentialsTeleportHologram makes teleporting more visible, safer, and more enjoyable for your server.