与请求被接受后立即传送玩家不同,该插件会在传送目的地启动一个可见的倒计时。会出现一个全息投影,玩家可以查看是谁正在传送、剩余时间多少,并且可以通过击打全息投影来取消传送。
这使得传送过程更具互动性、更直观,并且在生存、PVP、SMP、Towny、氏族和经济类服务器中更加平衡。
主要功能
[]完整支持 EssentialsX 的传送请求
[]兼容 /tpa、/tpahere 和 /tpaccept 命令
[]用自定义倒计时系统替换即时接受的传送
[]在传送目的地创建全息投影
[]显示正在传送的玩家、目标玩家、倒计时时间及关系信息
[]允许玩家通过击打全息投影来取消当前激活的传送
[]支持 DecentHolograms 以实现美观的全息视觉效果
[]如果未安装 DecentHolograms,则包含轻量级备用系统
[]支持 UltimateClans 和 PlaceholderAPI 以检测氏族关系
[]可显示盟友、敌人和中立关系的传送警告
[]包含标题栏、动作条、音效和粒子效果
[]提供独立的英文和土耳其语语言文件
性能友好,专为在线服务器优化
支持的传送命令
代码:
/tpa
/tpahere
/tpaccept
这些命令由 EssentialsX 处理。EpicEssentialsTeleportHologram 挂钩到已接受的传送请求,并应用其自定义倒计时系统。
插件命令
代码:
/etpholo reload
重新加载插件配置文件和语言文件。
权限
代码:
etpholo.admin
允许访问管理员命令,例如 reload。
代码:
etpholo.bypass
如果配置中启用了绕过权限,则允许玩家绕过自定义传送倒计时。
全息倒计时系统
当传送请求被接受时,全息投影会出现在传送目的地,并开始倒计时。
示例全息投影:
代码:
TELEPORT
Steve → Alex
5s left
Hit to cancel
全息投影可以显示:
[]正在传送的玩家
[]目标玩家
[]剩余秒数
[]氏族关系
取消警告
击打取消
玩家可以通过击打全息投影来取消正在进行的传送。
这对于 PVP、生存、氏族和 SMP 服务器特别有用,因为在这些服务器上直接传送到其他玩家应当具有一定的风险和可见性。
示例配置:
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 支持
如果安装了 DecentHolograms,插件可以自动使用它来实现干净专业的全息视觉效果。
推荐配置:
YAML:
hologram:
decentholograms:
enabled: true
require-for-visual: true
vertical-offset: 1.35
spawn-hitbox: true
fallback-armorstand-visual: false
如果未安装 DecentHolograms,插件可以使用其轻量级备用系统。
UltimateClans 和 PlaceholderAPI 支持
EpicEssentialsTeleportHologram 可以与 UltimateClans 和 PlaceholderAPI 集成。
当玩家传送到另一名玩家时,插件可以检测氏族关系并显示警告。
支持的关系示例:
[]ALLY(盟友)
[]ENEMY(敌人)
NEUTRAL(中立)
这有助于玩家在传送完成前了解谁正在传送到他们身边,或者他们将要传送到谁那里。
标题栏、动作条和音效
在传送倒计时期间,玩家可以接收标题消息、动作条警告和音效。
示例消息:
代码:
Teleporting in 5 seconds
You are teleporting to Alex
Steve is teleporting to you
Enemy player detected
Ally player detected
倒计时音效示例:
YAML:
effects:
tick-sound:
enabled: true
sound: "BLOCK_NOTE_BLOCK_PLING"
volume: 0.35
pitch: 1.6
only-last-seconds: 5
粒子动画
在倒计时期间,正在传送的玩家头顶可能会出现一个轻量级的旋转粒子效果。
示例配置:
YAML:
animation:
head:
enabled: true
particle: END_ROD
update-ticks: 5
radius: 0.55
height: 2.25
这使得传送过程更加显眼,而无需使用沉重的视觉效果。
语言文件
消息存储在独立于主配置文件之外的文件中。
文件结构:
代码:
plugins/EpicEssentialsTeleportHologram/
├─ config.yml
└─ messages/
├─ en.yml
└─ tr.yml
默认支持:
[]English(英语)
[]Turkish(土耳其语)
语言选择:
YAML:
language: en
messages-file: messages/en.yml
或:
YAML:
language: tr
messages-file: messages/tr.yml
可用占位符
你可以在消息和全息行中使用以下占位符:
代码:
%teleportee%
%target%
%seconds%
%attacker%
%relation%
%teleportee_clan%
%target_clan%
%prefix%
示例全息行:
YAML:
lines:
[LIST]
[]"&#ff6b00&lTELEPORT"
[]"&f%teleportee% &7→ &e%target%"
[]"&c%seconds%s &7left"
[]"&7Relation: %relation%"
[/LIST]
示例配置
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
示例消息
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"
取消传送: "%prefix%&c已取消传送。&f%attacker% &7击中了全息图。"
取消退出: "%prefix%&c因有玩家离开服务器,已取消传送。"
成功: "%prefix%&a传送已完成。"
安装
[]在服务器上安装 EssentialsX 插件。
[]可选:安装 DecentHolograms。
[]可选:安装 PlaceholderAPI 和 UltimateClans。
[]将 EpicEssentialsTeleportHologram.jar 放入 /plugins 文件夹。
[]重启服务器。
[]编辑 config.yml 和语言文件。
如有需要,重载插件:
代码:
/etpholo reload
依赖项
必需
EssentialsX
可选
[]DecentHolograms
[]PlaceholderAPI
UltimateClans
推荐配置:
代码:
EssentialsX + DecentHolograms + PlaceholderAPI + UltimateClans
性能友好
EpicEssentialsTeleportHologram 设计为轻量且高效。
优化特性:
[]单一全局倒计时任务
[]缓存的配置值
[]有限的活跃传送会话
[]低频粒子动画
[]可选音效
[]无持续的重型实体扫描
[]针对 DecentHolograms 的软钩子系统
[]默认可禁用的备用视觉系统
推荐的生存模式设置:
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
为何使用此插件?
默认的传送系统在请求被接受后通常是瞬间完成且不可见的。这可能会造成不公平或令人困惑的情况,尤其是在 PvP、公会、Towny 和生存服务器上。
EpicEssentialsTeleportHologram 使传送过程更可见、更可控且更平衡。
玩家可以:
[]查看谁正在传送
[]查看玩家传送到哪里
[]追踪剩余倒计时时间
[]通过击中全息图来取消危险的传送
在传送完成前查看公会关系警告
这将基本的命令转变为一种更精致、更具互动性的游戏机制。
EpicEssentialsTeleportHologram 让您的服务器拥有更可见、更安全且更有趣的传送体验。
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧