Horizons TPA

插件

· 作者 raawn

一款轻量级的 TPA 插件,支持点击接受/拒绝按钮、后退命令、切换系统以及平滑的等待效果。

0 本站下载 0 关注 更新于 3 周前

最新 1.0.5 · 26.3 · Bukkit / Paper

一键开服(送7天)

headerimage

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.* -- 授予所有管理员权限

快速上手

  1. 下载 HorizonsTPA 并将 JAR 文件放入服务器的 plugins 文件夹中。
  2. 重启 服务器(或使用插件管理器加载该插件)。
  3. 插件会在首次启动时生成其默认配置文件。
  4. 分配权限 -- 为玩家提供 horizonstpa.use 以获取基本的 TPA 访问权限,以及 horizonstpa.back 以使用 /back 命令。
  5. (可选)根据需要配置经济、预热、冷却和声音设置。
  6. 使用 /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)
  • 对问题的清晰描述
  • 相关的控制台错误日志(如有)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源