ButtomHome

插件

· 作者 MySie

这是用于按钮主页的一个插件

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

最新 2.0.0 · 26.1.2 · Purpur / Spigot

一键开服(送7天)

ButtonHome ? ✨

ButtonHome 是一款面向现代 Paper 服务器 (1.21.x – 1.22.x) 专属设计的下一代高级家园管理插件。它摒弃了传统过时的基于箱子库存的 GUI 和聊天消息刷屏,利用现代 Paper 原生对话框 UI、丰富的 Kyori MiniMessage 格式、内置的 3D 音频提示音以及交互式的 可搜索分页图标选择器,在不依赖任何客户端模组、材质包或资源包覆盖的情况下,提供无与伦比的高度沉浸式玩家体验。


? 核心功能

  • ?️ 原生 Paper 对话框 UI:直接在玩家视口中显示优雅的客户端对话卡片。Emoji 和视觉指示器直接渲染在第一页的槽位上,实现轻松的高对比度导航。
  • ? 可搜索图标选择器:将数百种有效的 Minecraft 材料列为可选图标,支持实时文本查询过滤和按字母顺序排序的分页。
  • ⏳ 动作栏预热 HUD:在玩家的动作栏中清晰显示传送倒计时,完全避免聊天窗口刷屏。
  • ? 合成音效:为交互式的 UI 操作融入令人愉悦的声音方案(如末影人传送、升级提示音等)。
  • ?️ 移动与伤害检测:如果玩家受到伤害或离开原始坐标方块,立即中止待处理的预热过程。
  • ❌ 无缝导航:所有对话屏幕均提供对退出键和专用退出按钮的处理,以便自然关闭。
  • ? 管理员检查面板:管理员可以使用管理命令查看任何玩家的槽位网格并执行直接传送。

?️ 命令参考

ButtonHome 具备专为高性能标签补全设计的简洁命令架构:

命令 语法 描述 默认权限
/home /home [name] 打开原生对话框网格或直接传送到某个家园。 buttonhome.use
/sethome /sethome [name] 触发创建输入对话框或保存当前坐标。 buttonhome.use
/delhome /delhome <name> 永久移除选定的家园并释放槽位。 buttonhome.use
/homes /homes [page] 打开分页的家园槽位网格索引或显示纯文本列表。 buttonhome.use
/homecancel /homecancel 中止待处理的传送预热序列。 buttonhome.use
/adminhome /adminhome <player> 检查和管理工作目标玩家的活跃家园网格。 buttonhome.admin
/buttonhome /buttonhome <reload> 重新加载配置文件和数据库结构。 buttonhome.admin

? 权限与 LuckPerms 限制节点

该插件支持现代权限管理器,并软依赖 LuckPerms 来处理动态家园槽位限制计算:

  • buttonhome.use (默认: true) — 允许访问基本家园命令和界面交互。
  • buttonhome.admin (默认: op) — 授予访问目标网格检查和管理员命令的权限。
  • buttonhome.bypass.warmup (默认: false) — 绕过传送预热以实现即时旅行。
  • buttonhome.bypass.cooldown (默认: false) — 绕过活跃的传送冷却计时器。

? 动态限制 (1 到 50)

平滑配置自定义玩家等级限制。ButtonHome 解析并授予最高的数值限制:

  • buttonhome.limit.1 — 将玩家或组限制为 1 个家园槽位。
  • buttonhome.limit.5 — 将玩家或组限制为 5 个家园槽位。
  • buttonhome.limit.10 — 将玩家或组限制为 10 个家园槽位。
  • buttonhome.limit.25 — 将玩家或组限制为 25 个家园槽位。
  • buttonhome.limit.50 — 授予对所有 50 个可用家园槽位的完全访问权限。

⚙️ 配置 (config.yml)

主配置文件支持丰富的 MiniMessage 样式、RGB 十六进制颜色标签和自定义设置:

# 没有特定权限节点的玩家的家园上限
default-max-homes: 2

# 站立不动后开始传送前的预热时间(秒)
warmup-seconds: 5

# 如果玩家移动或受到伤害则取消传送
cancel-on-move: true
cancel-on-damage: true
teleport-cooldown-seconds: 0

# 面向玩家的消息(使用 MiniMessage 格式化)
messages:
  no-permission: "<#ef4444>你没有权限使用此命令!</#ef4444>"
  invalid-name: "<#ef4444>名称无效!仅使用字母、数字、连字符和下划线。</#ef4444>"
  home-set: "<#10b981>家园 <#f9fafb>%home%</#f9fafb> 已设置在你当前位置!</#10b981>"
  home-deleted: "<#ef4444>家园 <#f9fafb>%home%</#f9fafb> 已被删除。</#ef4444>"
  warmup-start: "<#f59e0b>⏳ 正在传送到 %home%,剩余 %seconds% 秒。请勿移动!</#f59e0b>"
  teleport-success: "<#10b981>✔ 已传送到 %home%。</#10b981>"

gui:
  settings:
    homes-per-page: 7

  stage1:
    title: "家园网格"
  stage2:
    title: "管理 %home%"
  stage3:
    title: "设置家园 %home%?"

  # 交互式 GUI 物品配置
  items:
    occupied:
      name: "<#f9fafb>%icon% %home%</#f9fafb>"
      lore:
        - "<#9ca3af>世界: <#f9fafb>%world%</#f9fafb></#9ca3af>"
        - ""
        - "<#fbbf24>⚡ 点击管理此家园!</#fbbf24>"
    new:
      name: "<#9ca3af>✚ 槽位 %index% (空闲)</#9ca3af>"
    locked:
      name: "<#ef4444>? 锁定槽位 %index%</#ef4444>"

? 存储架构 (homes.yml)

在平面文件数据库中,按照唯一的玩家 UUID 配置干净地保存玩家坐标:

8f20349a-cf2a-4dbd-8151-54a8e0339a04:
  spawn:
    world: world
    x: 104.5
    y: 64.0
    z: -320.12
    yaw: 90.0
    pitch: 0.0
    icon: LIME_BED
    slot: 1
  base:
    world: world_nether
    x: -12.33
    y: 120.0
    z: 555.9
    yaw: -180.0
    pitch: 15.4
    icon: REDSTONE
    slot: 2

OAK_DOOR / IRON_DOOR:** ? / ?

  • GRASS_BLOCK / CRAFTING_TABLE / FURNACE: ? / ?️ / ?
  • DIAMOND / EMERALD / NETHER_STAR: ? / ? / ⭐
  • GOLD_INGOT / IRON_INGOT / COAL / REDSTONE: ? / ⚪ / ⚫ / ?
  • LAPIS_LAZULI / AMETHYST_SHARD / ENDER_PEARL: ? / ? / ?
  • EYE_OF_ENDER / ELYTRA / WATER_BUCKET / LAVA_BUCKET: ?️ / ? / ? / ?

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源