Horizons Homes

插件

· 作者 raawn

一款轻量级的家插件,允许玩家设置、管理和传送至个人家园位置。

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

最新 1.1.5 · 26.3 · Bukkit / Paper

一键开服(送7天)

headerimage

HorizonsHomes

HorizonsHomes 是一款现代、功能丰富的家传送插件,专为 Paper、Purpur 和 Spigot 1.21+ 构建。它通过精美的图形用户界面(GUI)、灵活的经济系统支持以及高度可配置性,为玩家提供无缝的家管理体验——所有这些都由稳健的 SQLite 或 MySQL 存储提供支持。

无论您是运营小型生存服务器还是大型网络集群,HorizonsHomes 都能通过基于权限的家数量限制、跨世界传送、读条与冷却系统以及完整的语言支持来适应您的需求。


功能一览

  • 每个玩家拥有多个家,并通过权限控制数量上限
  • 精美的 GUI 用于管理家(传送、重命名、更改图标、删除)
  • 安全位置检测 -- 防止在危险地点设置家
  • 读条与冷却系统,支持多种显示模式
  • 经济系统集成,支持五种货币后端
  • 自定义物品支持,兼容八种外部物品插件
  • 跨世界传送,支持按世界单独配置
  • 死亡后重生在家
  • 完整的 HEX 颜色支持,包括渐变和彩虹文本
  • SQLite 和 MySQL 数据库后端,通过 HikariCP 连接
  • PlaceholderAPI 集成
  • 多语言支持 -- 内置英语和德语

家管理

带限制的多个家

每位玩家可以设置多个家。允许的家数量通过权限进行控制:

  • horizonshomes.limit.<n> -- 授予玩家恰好 <n> 个家的权限(例如 horizonshomes.limit.5)
  • horizonshomes.unlimited -- 授予无限数量的家

插件会自动解析玩家拥有的最高限制。也可以为没有任何特定限制权限的玩家配置合理的默认限制。

家命名

家名称会根据可配置的正则表达式模式进行验证,以保持整洁和一致。名称长度上限为 32 个字符。玩家可以随时通过命令或 GUI 重命名现有的家。

安全位置检测

当玩家设置家时,HorizonsHomes 会检查周围环境中是否存在危险。插件会阻止在以下地点设置家:

  • 岩浆 或 火焰
  • 虚空(世界下方)
  • 窒息方块(位于固体材料内部)

这能确保玩家的安全,避免在传送时因意外死亡而感到沮丧。


传送系统

跨世界传送

玩家可以传送到服务器上任何世界的家中。此功能完全可配置:

  • 全局启用或禁用跨世界传送
  • 单独禁用从特定世界或向特定世界的传送

读条系统

传送前可以要求一段读条延迟时间,之后玩家才会被移动。读条完全可配置:

  • 可配置的延迟(秒)
  • 移动取消读条 -- 如果玩家移动,读条将被中断
  • 受伤取消读条 -- 如果玩家受到伤害,读条将被中断

读条显示模式

选择如何向玩家展示读条倒计时:

模式 描述
ActionBar 在动作栏中显示进度条,支持可配置的字符、长度和 HEX 颜色
Title 在屏幕上显示标题和副标题倒计时
Both 同时结合 ActionBar 进度条和 Title 显示
Chat 在聊天栏中发送倒计时消息

进度条 高度可定制:

  • 可配置的进度条长度(字符数)
  • 自定义填充和未填充字符
  • 填充和未填充部分均支持完整的 HEX 颜色

冷却系统

传送后,可以强制执行一段冷却期,在此期间玩家无法再次传送。这可以防止传送滥用,并且可以通过相应的权限绕过。

音效

HorizonsHomes 支持两种可配置的音效事件:

  • 传送音效 -- 当玩家到达其家时播放
  • 倒计时滴答音效 -- 在读条倒计时的每一秒播放

这两种音效都具有可配置的 音量 和 音调 值,让您完全掌控音频体验。

粒子效果

当玩家到达目的地时,会在传送终点显示可配置的粒子效果,为每次传送增添视觉特效。


经济集成

HorizonsHomes 支持对玩家与家相关的操作收费。每个操作都可以有独立的费用:

操作 描述
设置家 玩家在创建新家时收费
传送 玩家每次传送到家时收费
删除家 玩家在移除家时收费
重命名家 玩家在重命名现有家时收费

支持的货币

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

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

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


GUI 系统

HorizonsHomes 包含一个精致的图形界面,用于管理家。玩家通过 /homes 打开 GUI,并可以在视觉上执行所有家管理任务。

GUI 功能

  • 浏览所有家,采用分页且易于导航的布局
  • 单击即可传送 到任意家
  • 更改家的图标 为任何物品或自定义物品
  • 直接从 GUI 重命名 家
  • 确认删除 家

GUI 中的家园图标可以使用以下外部插件的物品:

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

这些集成会自动检测——只需安装插件即可生效。


死亡重生回主页

启用后,设置了默认主页的玩家在死亡时将重生在该处,而不是世界出生点。此功能通过专用权限进行切换,提供便捷的生存体验。


命令

玩家命令

命令 描述 权限
/home [name] 传送至指定主页。如果未提供名称,则传送到默认主页。 horizonshomes.home
/sethome [name] 在当前地点设置一个新主页。如果未提供名称,将使用默认名称。 horizonshomes.sethome
/delhome <name> 删除一个已有的主页。 horizonshomes.delhome
/homes 打开主页管理 GUI。 horizonshomes.homes

管理员命令

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

命令 描述
/homeadmin reload 重新加载插件配置文件和语言文件。
/homeadmin list <player> 列出特定玩家的所有主页。
/homeadmin tp <player> <home> 传送到另一玩家的特定主页。
/homeadmin delete <player> <home> 删除另一玩家的特定主页。
/homeadmin deleteall <player> 删除特定玩家的所有主页。
/homeadmin info <player> <home> 查看特定主页的详细信息。
/homeadmin clearcooldown <player> 清除特定玩家的传送冷却时间。

权限

玩家权限

权限 描述 默认值
horizonshomes.home 允许传送至主页 true
horizonshomes.sethome 允许设置主页 true
horizonshomes.delhome 允许删除主页 true
horizonshomes.homes 允许打开主页 GUI true
horizonshomes.respawn 死亡时重生在默认主页 false

数量限制权限

权限 描述
horizonshomes.limit.<n> 将玩家的主页数量上限设置为 <n>(例如 horizonshomes.limit.3)
horizonshomes.unlimited 授予无限制主页数量

绕过权限

权限 描述
horizonshomes.bypass.warmup 跳过传送预热延迟
horizonshomes.bypass.cooldown 跳过传送冷却时间
horizonshomes.bypass.economy 绕过所有经济费用
horizonshomes.bypass.world 绕过跨世界传送限制

管理员权限

权限 描述
horizonshomes.admin 访问所有 /homeadmin 命令

快速入门

  1. 下载 HorizonsHomes 并将 .jar 文件放入服务器的 plugins 文件夹中。
  2. 启动或重启服务器。插件将生成其默认配置文件。
  3. 配置主页数量上限,通过向权限组分配 horizonshomes.limit.<n> 权限来实现。
  4. 调整配置,在 config.yml 中设置预热延迟、冷却时间、经济费用和显示偏好。
  5. 自定义消息,通过编辑语言文件实现。HorizonsHomes 自带英文和德文翻译。
  6. 玩家可以立即开始使用 /sethome 和 /home 来管理他们的主页。

配置

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

  • 数据库 -- 在 SQLite(基于文件,零配置)和 MySQL(远程,可扩展)之间选择。连接池由 HikariCP 处理以优化性能。
  • 传送 -- 设置预热延迟、冷却持续时间以及跨世界限制。配置要禁用的世界列表。
  • 预热显示 -- 选择显示模式(ActionBar、Title、Both、Chat),并使用 HEX 颜色自定义进度条外观。
  • 音效 -- 配置传送和倒计时声音的音量和音调。
  • 粒子效果 -- 设置传送时显示的粒子类型。
  • 经济系统 -- 选择货币后端并为每个操作设置费用(设置主页、传送、删除主页、重命名)。
  • 主页命名 -- 定义正则表达式验证模式和最大名称长度。
  • 安全位置 -- 切换危险位置的安全检查。
  • GUI -- 自定义主页管理界面的布局和交互行为。
  • 重生 -- 启用或禁用死亡时重生在默认主页。

所有更改均可通过 /homeadmin reload 在运行时应用。


文本格式化

HorizonsHomes 完全支持现代 Minecraft 文本格式化:

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

兼容性

要求

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

软依赖

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

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

指标数据

HorizonsHomes 使用 bStats 收集匿名使用统计数据。这有助于开发者了解插件的使用情况并确定功能优先级。你可以在 bStats 配置文件中选择退出数据统计。


PlaceholderAPI

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

通用占位符

占位符 描述
%horizonshomes_count% 玩家拥有的家园数量
%horizonshomes_max% 允许的最大家园数(无限制时显示 "∞")
%horizonshomes_remaining% 玩家还可以创建的剩余家园数(无限制时显示 "∞")
%horizonshomes_list% 所有家园名称的逗号分隔列表
%horizonshomes_has_home% 玩家是否至少拥有一个家园 (true/false)
%horizonshomes_cooldown% 剩余的传送冷却时间(毫秒)
%horizonshomes_has_cooldown% 玩家是否处于冷却状态 (true/false)

单个家园占位符

将 <name> 替换为具体的家园名称:

占位符 描述
%horizonshomes_home_<name>_world% 指定家园所在的维度名称
%horizonshomes_home_<name>_x% 指定家园的 X 坐标
%horizonshomes_home_<name>_y% 指定家园的 Y 坐标
%horizonshomes_home_<name>_z% 指定家园的 Z 坐标
%horizonshomes_home_<name>_coords% 格式化后的坐标字符串(例如:"100, 64, -200")
%horizonshomes_home_<name>_exists% 指定的家园是否存在 (true/false)

数据库

HorizonsHomes 支持两种数据库后端:

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

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


支持

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

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

我们感谢你的反馈,并致力于保持 HorizonsHomes 的持续更新与稳定可靠。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源