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: ?️ / ? / ? / ?
ButtonHome ðŸ ✨
ButtonHome is a next-generation, premium home management plugin designed exclusively for modern Paper servers (1.21.x – 1.22.x). By abandoning traditional, outdated chest-inventory-based GUIs and chat message spam, ButtonHome leverages modern Paper Native Dialog UIs, rich Kyori MiniMessage formatting, integrated 3D audio cue chimes, and an interactive, Searchable Paginated Icon Picker to provide an unmatched, highly immersive player experience without requiring any client-side mods, textures, or resource pack overlays.
🌟 Core Features
- ðŸ–¥ï¸ Native Paper Dialogs UI: Displays elegant, client-side dialogue cards directly in the player's viewport. Emojis and visual indicators are rendered directly on the first-page slots for effortless, high-contrast navigation.
- 🔠Searchable Icon Picker: Lists hundreds of valid Minecraft materials as selectable icons with real-time text query filtering and alpha-sorted pagination.
- â³ Action Bar Warmup HUD: Renders active teleport countdown timers cleanly on the player's action bar, completely avoiding chat window spam.
- 🔊 Synthesized Sound Effects: Incorporates delightful sound schemes (such as Enderman teleports, level-up chimes, and chimes) for interactive UI actions.
- ðŸ›¡ï¸ Movement & Damage Checks: Aborts pending warmups instantly if the player takes damage or moves away from their original coordinate block.
- ⌠Seamless Navigation: Handlers for escape keys and dedicated exit buttons are accessible on all dialogue screens for natural closure.
- 👑 Operator Inspection Panel: Administrators can view any player's slot grid using administrative commands and execute direct teleports.
ðŸ› ï¸ Command Reference
ButtonHome features a clean command architecture designed for high-performance tab-completion:
| Command |
Syntax |
Description |
Default Permission |
/home |
/home [name] |
Opens the native Dialog grid or teleports directly to a home. |
buttonhome.use |
/sethome |
/sethome [name] |
Triggers the creation input Dialog or saves current coordinates. |
buttonhome.use |
/delhome |
/delhome <name> |
Permanently removes the selected home and vacates the slot. |
buttonhome.use |
/homes |
/homes [page] |
Opens the paginated home slot grid index or shows a plain list. |
buttonhome.use |
/homecancel |
/homecancel |
Aborts a pending teleportation warmup sequence. |
buttonhome.use |
/adminhome |
/adminhome <player> |
Inspect and manage the active homes grid of a target player. |
buttonhome.admin |
/buttonhome |
/buttonhome <reload> |
Reloads the configuration file and database structures. |
buttonhome.admin |
🔑 Permissions & LuckPerms Limit Nodes
The plugin supports modern permission managers, with a soft dependency on LuckPerms for handling dynamic home slot limit calculations:
buttonhome.use (Default: true) — Allows access to basic home commands and interface interactions.
buttonhome.admin (Default: op) — Grants access to target grid inspection and admin commands.
buttonhome.bypass.warmup (Default: false) — Bypasses teleport warmups for instant travel.
buttonhome.bypass.cooldown (Default: false) — Bypasses active teleportation cooldown timers.
📊 Dynamic Limits (1 to 50)
Configure custom player rank limits smoothly. ButtonHome parses and awards the highest numerical limit:
buttonhome.limit.1 — Restricts the player or group to 1 home slot.
buttonhome.limit.5 — Restricts the player or group to 5 home slots.
buttonhome.limit.10 — Restricts the player or group to 10 home slots.
buttonhome.limit.25 — Restricts the player or group to 25 home slots.
buttonhome.limit.50 — Grants full access to all 50 available home slots.
âš™ï¸ Configuration (config.yml)
The primary configuration file supports rich MiniMessage styling, RGB hex color tags, and custom settings:
# Home limit for players without a specific permission node
default-max-homes: 2
# Warmup time (seconds) standing still before teleporting
warmup-seconds: 5
# Cancel teleport if the player moves or takes damage
cancel-on-move: true
cancel-on-damage: true
teleport-cooldown-seconds: 0
# Player-facing messages (formatted with MiniMessage)
messages:
no-permission: "<#ef4444>You do not have permission to use this command!</#ef4444>"
invalid-name: "<#ef4444>Invalid name! Use only letters, numbers, hyphens, and underscores.</#ef4444>"
home-set: "<#10b981>Home <#f9fafb>%home%</#f9fafb> has been set at your current location!</#10b981>"
home-deleted: "<#ef4444>Home <#f9fafb>%home%</#f9fafb> has been deleted.</#ef4444>"
warmup-start: "<#f59e0b>â³ Teleporting to %home% in %seconds% seconds. Do not move!</#f59e0b>"
teleport-success: "<#10b981>✔ Teleported to %home%.</#10b981>"
gui:
settings:
homes-per-page: 7
stage1:
title: "Homes Grid"
stage2:
title: "Manage %home%"
stage3:
title: "Set home %home%?"
# Interactive GUI Items configuration
items:
occupied:
name: "<#f9fafb>%icon% %home%</#f9fafb>"
lore:
- "<#9ca3af>World: <#f9fafb>%world%</#f9fafb></#9ca3af>"
- ""
- "<#fbbf24>âš¡ Click to manage this home!</#fbbf24>"
new:
name: "<#9ca3af>✚ Slot %index% (Vacant)</#9ca3af>"
locked:
name: "<#ef4444>🔒 Locked Slot %index%</#ef4444>"
💾 Storage Architecture (homes.yml)
Saves player coordinates cleanly under unique player UUID configurations in the flat-file database:
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
登录后参与评分
还没有评论,来抢沙发吧