Horizons Warps

插件

· 作者 raawn

一款现代传送插件,拥有美观的图形界面、自定义图标、分类以及完整的管理员控制功能。

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

最新 1.0.5 · 26.3 · Bukkit / Paper

一键开服(送7天)

headerimage

HorizonsWarps

HorizonsWarps 是一款现代化的、功能齐全的传送插件,专为 Paper、Purpur 和 Spigot 1.21+ 构建。它提供服务器范围的传送点、精美的分页 GUI、灵活的单个传送权限、分类组织以及深度的经济集成——为您构建直观的传送网络所需的一切。

从小型生存服务器到大型社区,HorizonsWarps 都能轻松扩展,支持可配置的前摇和冷却系统、多种布局模式,并支持 SQLite 和 MySQL 存储。


功能一览

  • 服务器范围传送点:所有玩家均可访问
  • 单个传送权限:实现精细的访问控制
  • 分类系统:用于组织化的传送分组
  • 美观的分页 GUI:包含七种布局模式
  • 自定义显示名称和图标:适用于每个传送点
  • 前摇和冷却系统:支持多种显示模式
  • 经济集成:支持五种货币后端
  • 自定义物品支持:兼容八款外部物品插件
  • 跨世界传送:支持按世界配置
  • 音效和粒子效果:传送时触发
  • 可配置的排序顺序:针对每个传送点
  • SQLite 和 MySQL:通过 HikariCP 支持的数据库后端
  • PlaceholderAPI 集成
  • 多语言:包含英文和德文
  • bStats 指标统计

传送系统

服务器范围传送

传送点是服务器上所有玩家共享的位置(或通过权限限制)。管理员在关键位置创建传送点——出生点、商店、竞技场、农场、生物群系等——玩家可以瞬间传送到这些位置。

单个传送权限

每个传送点可以选择性地要求特定的权限才能使用。当为某个传送点设置了权限时,只有拥有该权限的玩家才能在 GUI 中看到它并传送到那里。

  • 权限格式:horizonswarps.warp.<name>
  • 未设置权限的传送点对所有拥有基础 horizonswarps.warp 权限的玩家开放

这使得创建 VIP 传送点、仅限员工的位置或特定活动目的地变得非常容易。

自定义显示名称

每个传送点都可以拥有与其内部标识符不同的自定义显示名称。显示名称支持完整的 HEX 颜色格式化、渐变色和传统颜色代码,让您可以创建视觉上独特且描述性强的传送标签。

自定义传送图标

每个传送点在 GUI 中都可以显示自定义图标。图标可以是任何原版 Minecraft 物品,也可以是受支持的外部插件中的自定义物品。随时使用 /warpadmin seticon 命令更改图标。

排序顺序

每个传送点都有一个可配置的排序位置,决定其在 GUI 中的放置顺序。这让您完全控制传送点的出现顺序,无论它们是何时创建的。

传送分类

传送点可以组织成分类以进行逻辑分组。分类有助于玩家在拥有众多目的地的服务器上快速找到传送点。分类示例可能包括:商店、竞技场、农场、生物群系或活动。


传送机制

跨世界传送

玩家可以传送到服务器上的任何世界中的位置。跨世界传送是可配置的:

  • 全局启用或禁用跨世界传送
  • 维护一个禁用列表,在这些世界中限制传送

前摇系统

传送可能需要在前摇延迟结束后才会移动玩家。如果玩家移动或受到伤害,前摇会被中断,从而防止滥用。

  • 可配置延迟(秒)
  • 移动取消 -- 玩家移动时取消前摇
  • 受伤取消 -- 玩家受到伤害时取消前摇

前摇显示模式

选择如何向玩家展示前摇倒计时:

模式 描述
ActionBar 在动作栏中显示进度条,支持自定义字符、长度和 HEX 颜色
Title 在屏幕上显示标题和副标题倒计时
Both 同时结合 ActionBar 进度条和 Title 显示

ActionBar 进度条是完全可定制的:

  • 可配置的栏长度
  • 自定义填充和非填充字符
  • 填充和非填充段落的 HEX 颜色支持

冷却系统

传送后,会强制执行一段冷却时间,之后玩家才能再次传送。这可以防止传送滥用并确保公平使用。拥有 bypass 权限的玩家完全跳过冷却时间。

音效

HorizonsWarps 支持在传送期间播放可配置的音效。声音具有可调整的音量和音调,让您完全掌控音频体验。

粒子效果

当玩家传送时,会在目的地显示粒子效果,提供视觉反馈和特效。


经济集成

HorizonsWarps 支持向玩家收取传送费用。成本可以全局配置,也可以针对每个传送点单独配置,允许您使某些传送点免费,而对高级目的地收费。

支持的货币

插件支持五种不同的货币后端:

货币 描述
Vault 通过任何兼容 Vault 的经济插件进行标准经济集成
PlayerPoints 使用 PlayerPoints 作为货币
CoinsEngine 与 CoinsEngine 集成以使用自定义服务器货币(可配置货币名称)
基于经验值 使用玩家的经验等级或点数作为货币(可配置模式)
基于物品 需要玩家库存中的特定物品作为支付(可配置材料)

如果在配置中不需要任何费用,也可以完全禁用经济系统。


GUI 系统

HorizonsWarps 拥有一个精致的分页图形界面,玩家通过 /warps 打开该界面。GUI 是玩家浏览和使用传送点的主要方式。

布局模式

该 GUI 支持七种不同的布局模式,用于控制每个页面上传送点图标的排列方式:

模式 描述
Spaced 传送点均匀分布,彼此之间留有间隙
Wide 传送点横跨整个物品栏的宽度
Centered 传送点每行居中显示
Diamond 传送点呈菱形排列
Rows 传送点以整齐的水平行排列
Compact 每页容纳最多的传送点,间距最小
Custom 在配置文件中完全自定义槽位位置

每种模式都为 GUI 带来不同的视觉风格,让你能够匹配服务器的整体风格。

传送点信息显示

玩家可以直接在 GUI 中查看传送点的详细信息。信息界面显示传送点名称、显示名称、位置、分类、权限要求以及传送费用。

自定义物品支持

GUI 中的传送点图标可以使用以下外部插件的物品:

插件 描述
ItemsAdder ItemsAdder 的自定义物品
Oraxen Oraxen 的自定义物品
HeadDatabase HeadDatabase 的自定义玩家头颅
MMOItems MMOItems 的物品
Slimefun Slimefun 的物品
Nexo Nexo 的自定义物品
ExecutableItems ExecutableItems 的物品
EcoItems EcoItems 的物品

所有集成均自动检测——安装外部插件后,HorizonsWarps 即可自动识别。


命令

玩家命令

命令 描述 权限
/warp [name] 传送到某个传送点。如果未指定名称,则打开传送点 GUI。 horizonswarps.warp
/warps 打开传送点 GUI。 horizonswarps.warps
/setwarp <name> 在当前所在位置创建一个新的传送点。 horizonswarps.setwarp
/delwarp <name> 删除一个已有的传送点。 horizonswarps.delwarp

管理员命令

所有管理员命令均为 /warpadmin 的子命令,且需要 horizonswarps.admin 权限。

命令 描述
/warpadmin reload 重新加载插件配置文件和语言文件。
/warpadmin list 列出服务器上的所有传送点。
/warpadmin info <warp> 查看特定传送点的详细信息。
/warpadmin tp <warp> 直接传送到某个传送点,跳过预热时间和冷却时间。
/warpadmin delete <warp> 删除某个特定的传送点。
/warpadmin seticon <warp> 将手中物品的图标设置为某个传送点的 GUI 图标。
/warpadmin setperm <warp> <permission> 设置或更新使用某个传送点所需的权限。
/warpadmin setcat <warp> <category> 将某个传送点分配到一个分类。
/warpadmin setdisplay <warp> <name> 设置或更改某个传送点的显示名称。
/warpadmin clearcooldown <player> 清除特定玩家的传送点冷却时间。
/warpadmin setslot <warp> <slot> 设置传送点的排序顺序或 GUI 槽位位置。

权限

玩家权限

权限 描述 默认值
horizonswarps.warp 允许传送到传送点 true
horizonswarps.warps 允许打开传送点 GUI true
horizonswarps.setwarp 允许创建新的传送点 op
horizonswarps.delwarp 允许删除传送点 op

按传送点设置的权限

权限 描述
horizonswarps.warp.<name> 授予访问已设置权限要求的特定传送点的权限

绕过权限

权限 描述
horizonswarps.bypass.warmup 跳过传送预热延迟
horizonswarps.bypass.cooldown 跳过传送冷却时间
horizonswarps.bypass.economy 绕过所有经济费用
horizonswarps.bypass.permission 无视按传送点设置的权限要求,访问所有传送点

管理员权限

权限 描述
horizonswarps.admin 访问所有 /warpadmin 命令

入门指南

  1. 下载 HorizonsWarps 并将 .jar 文件放入服务器的 plugins 文件夹中。
  2. 启动或重启你的服务器。插件将生成默认的配置文件。
  3. 创建第一个传送点:站在期望的位置并运行 /setwarp <name>。
  4. 自定义传送点:使用管理员命令设置显示名称、图标、分类以及可选的权限。
  5. 调整配置:在 config.yml 中设置预热延迟、冷却时间、经济费用、GUI 布局和显示偏好。
  6. 自定义消息:通过编辑语言文件来修改提示消息。HorizonsWarps 自带英文和德文翻译。
  7. 玩家可以通过 /warps 浏览所有可用的传送点,并使用 /warp <name> 进行传送。

配置

HorizonsWarps 通过其 config.yml 文件进行配置。主要配置部分包括:

  • 数据库 -- 选择 SQLite(基于文件,零设置)或 MySQL(远程,可扩展)。连接池由 HikariCP 处理。
  • 传送 -- 设置预热延迟、冷却持续时间以及跨世界限制。配置禁用的世界。
  • 预热显示 -- 选择显示模式(ActionBar、Title、Both),并使用 HEX 颜色、自定义字符和调整长度来自定义进度条。
  • 音效 -- 配置传送音效,支持音量和音调控制。
  • 粒子效果 -- 设置传送到达时显示的粒子类型。
  • 经济系统 -- 选择货币后端,并全局或按传送点配置传送费用。
  • GUI 布局 -- 从七种布局模式中选择(Spaced, Wide, Centered, Diamond, Rows, Compact, Custom),并配置分页设置。
  • 分类 -- 定义和管理传送点分类以便组织。

所有配置更改都可以通过 /warpadmin reload 在运行时应用——无需重启服务器。

文本格式化

HorizonsWarps 全面支持现代 Minecraft 文本格式:

  • HEX 颜色 -- 使用 &#RRGGBB 或 <#RRGGBB> 语法设置任意颜色
  • 渐变 -- 在文本上应用平滑的颜色过渡
  • 彩虹文字 -- 自动彩虹着色
  • 旧版代码 -- 标准 & 颜色代码仍受支持

此功能适用于传送点显示名称、GUI 元素以及所有可配置的消息。


兼容性

要求

要求 版本
服务端软件 Paper、Purpur 或 Spigot
Minecraft 版本 1.21 或更高版本
Java 版本 Java 21 或更高版本

软依赖

所有软依赖均为可选。HorizonsWarps 会在启动时自动检测它们。

插件 用途
Vault 经济集成
PlayerPoints 替代货币
CoinsEngine 替代货币
PlaceholderAPI 为其他插件提供占位符支持
ItemsAdder 自定义 GUI 传送点图标
Oraxen 自定义 GUI 传送点图标
HeadDatabase 自定义头颅图标
MMOItems 自定义 GUI 传送点图标
Slimefun 自定义 GUI 传送点图标
Nexo 自定义 GUI 传送点图标
ExecutableItems 自定义 GUI 传送点图标
EcoItems 自定义 GUI 传送点图标

指标统计

HorizonsWarps 使用 bStats 收集匿名使用统计数据。这有助于开发者了解插件的使用情况并优先安排后续开发工作。您可以在 bStats 配置文件中选择不加入统计。


PlaceholderAPI

HorizonsWarps 提供以下占位符(需要 PlaceholderAPI):

通用占位符

占位符 描述
%horizonswarps_count% 服务器上传送点的总数
%horizonswarps_total% count 的别名
%horizonswarps_accessible% 玩家可访问的传送点数量
%horizonswarps_list% 以逗号分隔的可访问传送点名称列表
%horizonswarps_cooldown% 剩余传送冷却时间(毫秒)
%horizonswarps_has_cooldown% 玩家是否处于冷却状态(true/false)

单个传送点占位符

将 <name> 替换为传送点名称:

占位符 描述
%horizonswarps_warp_<name>_world% 指定传送点的世界名称
%horizonswarps_warp_<name>_x% 指定传送点的 X 坐标
%horizonswarps_warp_<name>_y% 指定传送点的 Y 坐标
%horizonswarps_warp_<name>_z% 指定传送点的 Z 坐标
%horizonswarps_warp_<name>_coords% 格式化后的坐标字符串
%horizonswarps_warp_<name>_creator% 创建该传送点的玩家名称
%horizonswarps_warp_<name>_exists% 指定的传送点是否存在(true/false)

数据库

HorizonsWarps 支持两种数据库后端:

后端 适用场景 设置
SQLite 中小型服务器、单实例部署 零配置 -- 开箱即用
MySQL 大型服务器、多实例部署、网络架构 需要在配置文件中填写连接详情

两个后端均使用 HikariCP 进行高效的连接池管理,确保在高负载下也能提供可靠且高性能的数据库访问。


支持

如果您遇到任何问题、有功能建议或需要配置帮助,请通过以下渠道联系我们:

  • 问题追踪器 -- 在项目的问题追踪器上报告错误或请求新功能
  • Discord -- 加入社区 Discord 服务器获取实时支持和讨论
  • Modrinth 评论 -- 在 Modrinth 项目页面上留下评论

我们重视反馈,并致力于保持 HorizonsWarps 的更新与稳定可靠。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源