
HorizonsTPA
一款功能丰富、轻量级的现代 Paper、Purpur 和 Spigot 服务器传送请求插件。 HorizonsTPA 带来精致的 TPA 体验,包含引导时间、冷却时间、经济系统集成以及完全可自定义的消息——且无需任何 GUI。所有交互均通过简洁的可点击聊天组件完成。
功能一览
- 聊天中直接显示的接受 / 拒绝按钮
- 可配置的引导系统,支持 ActionBar 进度条、标题或两者兼有
- TPA 和
/back 拥有独立的冷却时间
- 经济系统支持,提供四种货币提供商
- PlaceholderAPI 集成
- 每次交互都有音效反馈
- 开箱即用多语言支持(英语 & 德语)
- 轻量级、基于聊天的设计——无 GUI,无冗余
传送请求
/tpa 和 /tpahere
向任何在线玩家发送传送请求。/tpa <player> 请求传送到目标玩家处,而 /tpahere <player> 则请求目标玩家传送到你这里。
- 请求会在可配置超时后自动过期(默认:60 秒)。
- 接收方玩家会在聊天中看到可点击的“接受”和“拒绝”按钮。按钮文本和悬停提示均可在语言文件中完全自定义。
- 玩家同时只能有一个出站请求。发送新请求会自动取消前一个请求。
接受、拒绝与取消
| 命令 |
描述 |
/tpaccept |
接受传入的传送请求 |
/tpdeny |
拒绝传入的传送请求 |
/tpcancel |
取消自己的出站请求 |
所有三个命令都会提供即时反馈,并配有可配置的消息和音效。
切换请求
使用 /tptoggle 可以禁用或启用传入的 TPA 请求。当禁用时,其他玩家无法向你发送请求,并会收到通知告知你不再接受请求。
拥有 horizonstpa.bypass.toggle 权限的玩家仍可以向已禁用的玩家发送请求。
/back 命令
返回到你传送前的最后位置或你的死亡位置。/back 命令维护每个玩家的记录历史,让你总能回到原来的地方。
- 普通 /back 使用 (
horizonstpa.back) 和返回死亡位置 (horizonstpa.back.ondeath) 拥有独立的权限。
- 拥有其自身独立的冷却计时器,与 TPA 冷却时间分开配置。
- 可通过经济系统消耗金钱,同样独立于 TPA 费用进行配置。
引导系统
当传送请求被接受时,传送玩家在实际传送发生前会进入引导阶段。这提供了一个短暂的延迟,可以被中断。
取消条件
如果玩家执行以下操作,引导将被取消:
显示模式
选择如何向玩家显示引导倒计时:
| 模式 |
描述 |
| ActionBar |
在物品栏上方的动作栏区域显示进度条 |
| Title |
在屏幕中心显示标题和副标题 |
| Both |
同时显示 ActionBar 进度条和标题/副标题 |
进度条自定义
ActionBar 进度条完全可自定义:
- 长度 -- 进度条中的字符总数
- 填充字符 -- 用于已完成部分的字符
- 空字符 -- 用于剩余部分的字符
- 填充颜色 -- 已完成部分的 HEX 颜色代码
- 空颜色 -- 剩余部分的 HEX 颜色代码
示例:[##########----------],带有绿色到灰色的渐变,可在配置中完全调整。
冷却系统
防止传送滥用,使用独立的冷却计时器:
- TPA 冷却 -- 在发送
/tpa 或 /tpahere 请求后生效
- /back 冷却 -- 在使用
/back 命令后生效
两者的冷却持续时间均可独立配置。拥有 horizonstpa.bypass.cooldown 权限的玩家将跳过所有冷却时间。
音效
HorizonsTPA 为关键交互播放可配置的音效,在聊天消息旁提供音频反馈:
| 事件 |
描述 |
| 传送 |
传送完成时播放 |
| 倒计时 |
在引导倒计时滴答声期间播放 |
| 错误 |
当操作失败时播放(例如:没有待处理的请求) |
| 收到请求 |
当你收到传入的 TPA 请求时播放 |
| 接受 |
当请求被接受时播放 |
| 切换 |
当开启/关闭 TPA 请求时播放 |
| 取消 |
当请求被取消或拒绝时播放 |
每种音效都可以在配置中单独自定义或禁用。
经济集成
对玩家收取传送费用,为你的服务器增添经济维度:
- TPA 费用 -- 对发送
/tpa 或 /tpahere 请求收费
- /back 费用 -- 对使用
/back 命令单独收费
- 拥有
horizonstpa.bypass.cost 权限的玩家免费传送。
支持的货币提供商
| 提供商 |
描述 |
| Vault |
通过任何兼容 Vault 的经济插件进行标准经济集成 |
| PlayerPoints |
使用 PlayerPoints 作为货币 |
| CoinsEngine |
使用任何 CoinsEngine 货币 |
| 基于经验值 |
直接扣除经验等级或点数 |
在主配置文件中配置你首选的提供商和费用。一次只能激活一个提供商。
PlaceholderAPI
HorizonsTPA 提供以下占位符(需要 PlaceholderAPI):
| 占位符 |
描述 |
%horizonstpa_tpa_status% |
玩家是否接受 TPA 请求(On/Off) |
%horizonstpa_tpa_incoming_count% |
收到的 TPA 请求数量 |
%horizonstpa_tpa_outgoing_count% |
发出的 TPA 请求数量 |
%horizonstpa_tpa_cooldown% |
TPA 冷却剩余秒数(无则为 0) |
%horizonstpa_back_cooldown% |
/back 冷却剩余秒数(无则为 0) |
%horizonstpa_has_back_location% |
玩家是否有保存的返回位置(true/false) |
命令
| 命令 |
别名 |
描述 |
权限 |
/tpa <player> |
/tprequest |
请求传送到某玩家处 |
horizonstpa.tpa |
/tpahere <player> |
-- |
请求某玩家传送到你这里 |
horizonstpa.tpahere |
/tpaccept [player] |
/tpyes |
接受传入的请求(可选指定来自特定玩家的请求) |
horizonstpa.accept |
/tpdeny [player] |
/tpno |
拒绝传入的请求(可选指定来自特定玩家的请求) |
horizonstpa.deny |
/tpcancel |
-- |
取消你发出的请求 |
horizonstpa.cancel |
/tptoggle |
-- |
切换接收 TPA 请求的状态 |
horizonstpa.toggle |
/back |
-- |
返回到最后死亡的位置 |
horizonstpa.back |
/tpaadmin reload |
-- |
重载插件配置 |
horizonstpa.admin.reload |
/tpaadmin info |
-- |
显示插件信息 |
horizonstpa.admin.info |
权限
核心权限
| 权限 |
描述 |
默认值 |
horizonstpa.use |
授予以下所有核心 TPA 权限(父权限) |
true |
horizonstpa.tpa |
发送 /tpa 请求 |
true |
horizonstpa.tpahere |
发送 /tpahere 请求 |
true |
horizonstpa.accept |
接受传入的请求 |
true |
horizonstpa.deny |
拒绝传入的请求 |
true |
horizonstpa.cancel |
取消发出的请求 |
true |
horizonstpa.toggle |
切换接收 TPA 请求的状态 |
true |
horizonstpa.back |
使用 /back 命令 |
true |
horizonstpa.back.ondeath |
允许 /back 返回到死亡位置 |
true |
绕过权限
| 权限 |
描述 |
默认值 |
horizonstpa.bypass.toggle |
向已关闭接收请求的玩家发送请求 |
op |
horizonstpa.bypass.cooldown |
绕过所有冷却计时器 |
op |
horizonstpa.bypass.warmup |
绕过预热延迟 |
op |
horizonstpa.bypass.cost |
绕过经济费用 |
op |
管理员权限
| 权限 |
描述 |
默认值 |
horizonstpa.admin |
授予以下所有管理员权限(父权限) |
op |
horizonstpa.admin.reload |
重载插件配置 |
op |
horizonstpa.admin.info |
查看插件信息 |
op |
通配符权限:
horizonstpa.bypass.* -- 授予所有绕过权限
horizonstpa.admin.* -- 授予所有管理员权限
快速上手
- 下载 HorizonsTPA 并将 JAR 文件放入服务器的
plugins 文件夹中。
- 重启 服务器(或使用插件管理器加载该插件)。
- 插件会在首次启动时生成其默认配置文件。
- 分配权限 -- 为玩家提供
horizonstpa.use 以获取基本的 TPA 访问权限,以及 horizonstpa.back 以使用 /back 命令。
- (可选)根据需要配置经济、预热、冷却和声音设置。
- 使用
/tpaadmin reload 在无需重启的情况下应用配置更改。
配置
HorizonsTPA 使用简洁的 YAML 配置文件。主要配置部分包括:
- 请求设置 -- 超时时长、可点击按钮文本及悬停消息
- 预热 -- 时长、显示模式(ActionBar/Title/Both)、取消条件、进度条自定义
- 冷却时间 -- TPA 和 /back 分别设置的时长
- 经济系统 -- 启用/禁用、货币提供者选择、TPA 费用、/back 费用
- 音效 -- 每个事件的独立开关及音效选择
- 消息 -- 完全可翻译,支持带有 HEX 颜色和渐变的 MiniMessage 格式
语言文件单独存储,插件自带 English 和 German 翻译。可以通过创建新的语言文件来添加其他语言。
兼容性
| 要求 |
详情 |
| 服务端软件 |
Paper、Purpur 或 Spigot 1.21 及以上版本(不支持 Folia) |
| Java 版本 |
Java 21 或更高版本 |
可选集成
| 插件 |
用途 |
| Vault + 经济插件 |
传送费用的经济提供者 |
| PlayerPoints |
替代的经济提供者 |
| CoinsEngine |
替代的经济提供者 |
| PlaceholderAPI |
为外部插件提供占位符支持 |
指标统计
HorizonsTPA 通过 bStats 收集匿名使用统计数据以帮助开发。可以在 bStats 配置中禁用此功能。
支持
如果遇到任何问题或有功能建议,请通过 Modrinth 项目页面或链接的支持渠道联系我们。报告错误时,请包含以下内容:
- 你的服务端版本(执行
/version)
- 插件版本(执行
/tpaadmin info)
- 对问题的清晰描述
- 相关的控制台错误日志(如有)

HorizonsTPA
A feature-rich, lightweight teleport request plugin for modern Paper, Purpur, and Spigot servers. HorizonsTPA brings a polished TPA experience with warmups, cooldowns, economy integration, and fully customizable messages -- all without a single GUI. Every interaction happens through clean, clickable chat components.
Features at a Glance
- Clickable accept / deny buttons directly in chat
- Configurable warmup system with ActionBar progress bar, titles, or both
- Separate cooldowns for TPA and /back
- Economy support with four currency providers
- PlaceholderAPI integration
- Sound effects for every interaction
- Multilingual out of the box (English & German)
- Lightweight, chat-based design -- no GUIs, no bloat
Teleport Requests
/tpa and /tpahere
Send a teleport request to any online player. /tpa <player> requests to teleport to the target, while /tpahere <player> requests the target to teleport to you.
- Requests automatically expire after a configurable timeout (default: 60 seconds).
- The receiving player sees clickable Accept and Deny buttons in chat. Both the button text and hover tooltip are fully customizable in the language files.
- Players can have only one outgoing request at a time. Sending a new request automatically cancels the previous one.
Accepting, Denying & Cancelling
| Command |
Description |
/tpaccept |
Accept an incoming teleport request |
/tpdeny |
Deny an incoming teleport request |
/tpcancel |
Cancel your own outgoing request |
All three commands provide immediate feedback with configurable messages and sound effects.
Toggle Requests
Use /tptoggle to disable or enable incoming TPA requests entirely. When toggled off, other players cannot send you requests and will be notified that you are not accepting them.
Players with the horizonstpa.bypass.toggle permission can still send requests to players who have toggled off.
/back Command
Return to your last location before teleporting or your death location. The /back command maintains a per-player history so you can always get back to where you were.
- Separate permission for general /back usage (
horizonstpa.back) and returning to death locations (horizonstpa.back.ondeath).
- Has its own independent cooldown timer, configured separately from TPA cooldowns.
- Can optionally cost money through the economy system, also configured independently from TPA costs.
Warmup System
When a teleport request is accepted, the teleporting player enters a warmup phase before the actual teleportation occurs. This gives a brief delay that can be interrupted.
Cancel Conditions
The warmup is cancelled if the player:
- Moves from their current position
- Takes damage
Display Modes
Choose how the warmup countdown is displayed to the player:
| Mode |
Description |
| ActionBar |
A progress bar displayed in the action bar area above the hotbar |
| Title |
A title and subtitle displayed in the center of the screen |
| Both |
ActionBar progress bar and title/subtitle simultaneously |
Progress Bar Customization
The ActionBar progress bar is fully customizable:
- Length -- total number of characters in the bar
- Filled character -- the character used for the completed portion
- Empty character -- the character used for the remaining portion
- Filled color -- HEX color code for the completed portion
- Empty color -- HEX color code for the remaining portion
Example: [##########----------] with green-to-gray gradient, fully adjustable in the configuration.
Cooldown System
Prevent teleport spam with separate cooldown timers:
- TPA Cooldown -- applies after sending a
/tpa or /tpahere request
- /back Cooldown -- applies after using the
/back command
Both cooldown durations are independently configurable. Players with the horizonstpa.bypass.cooldown permission skip all cooldowns entirely.
Sound Effects
HorizonsTPA plays configurable sound effects for key interactions, providing audio feedback alongside chat messages:
| Event |
Description |
| Teleport |
Played when a teleportation completes |
| Countdown |
Played during warmup countdown ticks |
| Error |
Played when an action fails (e.g., no pending request) |
| Request Received |
Played when you receive an incoming TPA request |
| Accept |
Played when a request is accepted |
| Toggle |
Played when toggling TPA requests on/off |
| Cancel |
Played when a request is cancelled or denied |
Each sound can be customized or disabled individually in the configuration.
Economy Integration
Charge players for teleportation to add an economic dimension to your server:
- TPA Cost -- charge for sending
/tpa or /tpahere requests
- /back Cost -- charge separately for using the
/back command
- Players with the
horizonstpa.bypass.cost permission teleport for free.
Supported Currency Providers
| Provider |
Description |
| Vault |
Standard economy integration via any Vault-compatible economy plugin |
| PlayerPoints |
Use PlayerPoints as the currency |
| CoinsEngine |
Use any CoinsEngine currency |
| XP-based |
Deduct experience levels or points directly |
Configure your preferred provider and costs in the main configuration file. Only one provider is active at a time.
PlaceholderAPI
HorizonsTPA provides the following placeholders (requires PlaceholderAPI):
| Placeholder |
Description |
%horizonstpa_tpa_status% |
Whether the player accepts TPA requests (On/Off) |
%horizonstpa_tpa_incoming_count% |
Number of incoming TPA requests |
%horizonstpa_tpa_outgoing_count% |
Number of outgoing TPA requests |
%horizonstpa_tpa_cooldown% |
Remaining TPA cooldown in seconds (0 if none) |
%horizonstpa_back_cooldown% |
Remaining /back cooldown in seconds (0 if none) |
%horizonstpa_has_back_location% |
Whether the player has a saved back location (true/false) |
Commands
| Command |
Aliases |
Description |
Permission |
/tpa <player> |
/tprequest |
Request to teleport to a player |
horizonstpa.tpa |
/tpahere <player> |
-- |
Request a player to teleport to you |
horizonstpa.tpahere |
/tpaccept [player] |
/tpyes |
Accept an incoming request (optionally from a specific player) |
horizonstpa.accept |
/tpdeny [player] |
/tpno |
Deny an incoming request (optionally from a specific player) |
horizonstpa.deny |
/tpcancel |
-- |
Cancel your outgoing request |
horizonstpa.cancel |
/tptoggle |
-- |
Toggle receiving TPA requests |
horizonstpa.toggle |
/back |
-- |
Return to your last/death location |
horizonstpa.back |
/tpaadmin reload |
-- |
Reload the plugin configuration |
horizonstpa.admin.reload |
/tpaadmin info |
-- |
Display plugin information |
horizonstpa.admin.info |
Permissions
Core Permissions
| Permission |
Description |
Default |
horizonstpa.use |
Grants all core TPA permissions below (parent permission) |
true |
horizonstpa.tpa |
Send /tpa requests |
true |
horizonstpa.tpahere |
Send /tpahere requests |
true |
horizonstpa.accept |
Accept incoming requests |
true |
horizonstpa.deny |
Deny incoming requests |
true |
horizonstpa.cancel |
Cancel outgoing requests |
true |
horizonstpa.toggle |
Toggle receiving TPA requests |
true |
horizonstpa.back |
Access to the /back command |
true |
horizonstpa.back.ondeath |
Allow /back to return to death locations |
true |
Bypass Permissions
| Permission |
Description |
Default |
horizonstpa.bypass.toggle |
Send requests to players who have toggled off |
op |
horizonstpa.bypass.cooldown |
Bypass all cooldown timers |
op |
horizonstpa.bypass.warmup |
Bypass the warmup delay |
op |
horizonstpa.bypass.cost |
Bypass economy costs |
op |
Admin Permissions
| Permission |
Description |
Default |
horizonstpa.admin |
Grants all admin permissions below (parent permission) |
op |
horizonstpa.admin.reload |
Reload the plugin configuration |
op |
horizonstpa.admin.info |
View plugin information |
op |
Wildcard permissions:
horizonstpa.bypass.* -- grants all bypass permissions
horizonstpa.admin.* -- grants all admin permissions
Getting Started
- Download HorizonsTPA and place the JAR file in your server's
plugins folder.
- Restart your server (or load the plugin with a plugin manager).
- The plugin generates its default configuration files on first startup.
- Grant permissions -- give players
horizonstpa.use for basic TPA access and horizonstpa.back for the /back command.
- (Optional) Configure economy, warmup, cooldown, and sound settings to your liking.
- Use
/tpaadmin reload to apply configuration changes without restarting.
Configuration
HorizonsTPA uses a clean YAML configuration file. Key configuration sections include:
- Request Settings -- timeout duration, clickable button text and hover messages
- Warmup -- duration, display mode (ActionBar/Title/Both), cancel conditions, progress bar customization
- Cooldowns -- separate durations for TPA and /back
- Economy -- enable/disable, currency provider selection, TPA cost, /back cost
- Sounds -- individual toggle and sound selection for each event
- Messages -- fully translatable, supports MiniMessage formatting with HEX colors and gradients
Language files are stored separately and the plugin ships with English and German translations. Additional languages can be added by creating new language files.
Compatibility
| Requirement |
Details |
| Server Software |
Paper, Purpur, or Spigot 1.21 or newer (Folia not supported) |
| Java Version |
Java 21 or newer |
Optional Integrations
| Plugin |
Purpose |
| Vault + Economy Plugin |
Economy provider for teleport costs |
| PlayerPoints |
Alternative economy provider |
| CoinsEngine |
Alternative economy provider |
| PlaceholderAPI |
Placeholder support for external plugins |
Metrics
HorizonsTPA collects anonymous usage statistics via bStats to help with development. This can be disabled in the bStats configuration.
Support
If you encounter any issues or have feature suggestions, please reach out through the Modrinth project page or the linked support channels. When reporting a bug, please include:
- Your server version (
/version)
- The plugin version (
/tpaadmin info)
- A clear description of the issue
- Relevant console errors, if any
评论 0
登录后参与评分
还没有评论,来抢沙发吧