快速炉石

快速炉石

QuickHearth 是一个服务端家园 GUI,允许你的玩家设置家园,并请求传送到其他玩家处,或请求其他玩家传送到自己身边。此插件重做了 /spawn /home /homes /tpa 和 /tpr

交通

QuickHearth

对家园与 tpa 传送的全新诠释!QuickHearth 是一个适用于 Minecraft 26.1.x Fabric 的服务器端家园与传送模组。它允许服务器玩家保存位置(作为家园)、一键返回、与好友分享传送,以及快速回到出生点。专为希望拥有比大型传送指令合集更友好 GUI 的生存服务器而设计,并带有随玩家进度而扩展的、能感知权限组的家园数量上限。兼容 LuckPerms!

GUI 中没有家园 /homes

可在专用服务器和单人世界中运行。连接到专用服务器的原版客户端无需安装任何额外内容。

本模组还使用了 Patbox 的 SGUI。该依赖已预先打包。

它添加了什么

  • 箱子风格的家园选择 GUI。运行 /home 并点击槽位即可传送。按住 Shift 点击槽位可删除该家园。
  • 每个家园的自定义图标。运行 /sethome 时你手持的物品会成为该家园的槽位图标。使用带图案的自定义命名旗帜、玩家头颅、花朵或任何其他物品来为你的家园做视觉标记。 家园 GUI 中的自定义旗帜
  • /spawn 用于立即返回世界出生点。
  • /tpa、/tpahere(别名 /tpr)、/tpaccept、/tpdeny 和 /tpatoggle 用于玩家之间的传送请求。
  • 能感知权限组的家园数量上限。管理员通过 LuckPerms 为不同权限组设置不同的家园数量,并通过一个原版计分板目标来发放额外的个人奖励家园。这两层会叠加。

指令

家园

/sethome 将你当前的位置保存为“home”(默认名称)。

/sethome <name> 使用自定义名称保存,例如“basecamp”或“iron-farm”。名称接受字母、数字、下划线和连字符,最长 24 个字符。

运行 /sethome 时你主手中的物品会成为该家园在选择器中的槽位图标。空手则回退为纯白色旗帜。使用相同名称重新运行 /sethome 会同时覆盖位置和图标。

/home 打开家园选择器,一个 27 槽的箱子 GUI,显示你所有的家园。点击槽位传送。按住 Shift 点击删除。

/home <name> 直接传送到某个家园,支持 Tab 补全。

/home help 在聊天中打印指令列表。

/homes 与 /home 相同(打开选择器)。

/delhome <name> 删除一个家园,支持 Tab 补全。

出生点

/spawn 将你传送到世界出生点。

传送请求

/tpa <player> 询问目标玩家你是否可以传送到他们那里。他们会看到一条聊天提示,可输入 /tpaccept 或 /tpdeny。

/tpahere <player>(别名 /tpr)改为请求目标玩家传送到你这里。

/tpaccept 接受最近一条发往你的待处理请求。

/tpdeny 拒绝该请求。

/tpatoggle 阻止收到的传送请求,直到你重新开启。该设置跨服务器重启保留。

待处理请求在 60 秒后自动过期。

传送行为

所有传送共享以下规则:

  • 3 秒预热。倒计时显示在聊天中。移动会取消传送。
  • 成功传送后有 30 秒冷却,之后才能开始下一次传送。
  • 同一时间只能排队一个传送。

家园数量上限

玩家的最大家园数量按以下公式计算:

max_homes = LuckPerms meta "homes-max" + scoreboard "homes_bonus"

这两层相互独立。权限组变更不会重置奖励发放,奖励发放也完全不依赖 LuckPerms。

设置 LuckPerms 权限组(可选)

在你的 mods/ 文件夹中安装 LuckPerms-Fabric,然后为每个组设置家园数量:

/lp group default meta set homes-max 2
/lp group member meta set homes-max 3
/lp group veteran meta set homes-max 5

或为单个用户设置,以覆盖其所在组:

/lp user Steve meta set homes-max 4

如果未安装 LuckPerms,或未设置 homes-max 值,则权限组基础值回退为 1。

发放奖励家园(无需 LuckPerms)

QuickHearth 会在服务器首次启动时自动创建一个名为 homes_bonus 的虚拟计分板目标。管理员使用原版计分板指令为每位玩家发放额外家园:

/scoreboard players add Steve homes_bonus 2
/scoreboard players set Steve homes_bonus 5
/scoreboard players reset Steve homes_bonus

计分板值会加到权限组基础值上。因此,一位 member(权限组基础值 3)且 homes_bonus = 2 的玩家最多可保存 5 个家园。

计算示例

玩家 权限组 LP homes-max homes_bonus 总计
Alice newcomer 2 0 2
Bob member 3 1(活动奖品) 4
Carol veteran 5 2(赠予) 7
Dave (无 LP) 1(默认) 3(发放) 4

选择器 GUI 标题以 Homes (used/max) 显示使用情况,让玩家一眼就能看出还剩多少槽位。

权限节点

所有指令默认允许。要为某个组限制某条指令,请在 LuckPerms 中将其节点设为 false。

  • quickhearth.command.home
  • quickhearth.command.sethome
  • quickhearth.command.delhome
  • quickhearth.command.homes
  • quickhearth.command.spawn
  • quickhearth.command.tpa
  • quickhearth.command.tpahere(也涵盖 /tpr)
  • quickhearth.command.tpaccept
  • quickhearth.command.tpdeny
  • quickhearth.command.tpatoggle

示例,从 default 组撤销 /tpa:

/lp group default permission set quickhearth.command.tpa false

如果未安装 LuckPerms,权限门控回退为原版 OP 等级检查。