hLuckyBlock

插件

· 作者 He3HaukaX

基于区域的自动幸运方块,支持加权类型、多次命中耐久度、Base64 纹理、动态 TextDisplay 全息图、可配置奖励和安全清理。

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

最新 v1.7 · 26.3 · Bukkit / Paper

一键开服(送7天)

hLuckyBlock

hLuckyBlock 是一款适用于 Paper 和 Purpur 服务器的自动幸运方块系统。

无需玩家放置特殊物品,该插件会在配置好的事件区域内自动生成幸运方块。区域可以基于 WorldGuard 区域 或简单的 坐标长方体。

每种幸运方块类型都可以拥有独立的:

  • 物理 Minecraft 材质
  • 随机选择概率
  • 所需击打次数
  • 动态 TextDisplay 全息图
  • Base64 头像纹理
  • 奖励动作列表

当玩家完全破坏一个幸运方块时,hLuckyBlock 会执行配置的奖励并移除所有相关的视觉实体。


功能特性

  • 自动生成幸运方块
  • WorldGuard 区域与坐标长方体区域
  • 无限自定义幸运方块类型
  • 加权随机方块选择
  • 可配置的多击耐久度
  • 动态剩余击打次数全息图
  • 原生 Paper TextDisplay 实体
  • 多行 MiniMessage 全息图
  • HEX 颜色与渐变
  • Base64 头像纹理
  • 异步纹理准备
  • 有界纹理缓存
  • 每种方块类型的独立奖励
  • 13 种可配置的动作类型
  • 可选的 Vault 经济奖励
  • PlaceholderAPI 扩展
  • 坚实表面验证
  • 被阻止的支持材质
  • 通配符材质模式
  • 活跃方块之间的最小间距
  • 可配置的活跃方块上限
  • 停止生成或删除全部上限行为
  • 残留幸运方块回收
  • 孤立实体清理
  • 安全关闭清理
  • 手动开始、停止和清理命令
  • 俄语和英语本地化
  • 无需外部全息图插件
  • 无需资源包
  • 无需数据库

机制

hLuckyBlock 在插件启用时会启动一个自动生成任务。

在每个配置的间隔期间,插件会执行以下操作:

  1. 检查选定的世界和区域是否可用
  2. 核对当前跟踪的方块
  3. 检查活跃幸运方块的上限
  4. 使用其配置的概率选择一种方块类型
  5. 寻找有效的空闲位置
  6. 检查支撑表面和最小间距
  7. 放置物理方块
  8. 创建其 TextDisplay 全息图
  9. 添加其 Base64 头像视觉效果
  10. 开始跟踪其耐久度

对于已配置的幸运方块,常规方块破坏会被取消。

每次成功击打都会使内部耐久度减一。如果还有剩余耐久度,全息图会更新。在最后一次击打后,插件会移除方块并执行其奖励动作。


区域

REGION(区域)

使用配置的 WorldGuard 区域的最小和最大边界。

settings:
  luckyZone:
    mode: REGION
    region:
      world: "spawn"
      region: "hotzone"

此模式需要:

  • WorldEdit
  • WorldGuard

CUBOID(长方体)

使用选定世界中的两个坐标位置。

settings:
  luckyZone:
    mode: CUBOID
    cuboid:
      world: "spawn"
      pos1:
        x: -50
        y: 60
        z: -50
      pos2:
        x: 50
        y: 100
        z: 50

两个位置的顺序无关紧要。

CUBOID 模式不需要 WorldEdit 或 WorldGuard。


配置

生成间隔以毫秒为单位进行配置:

settings:
  timeToSpawn: 3000

3000 的默认值意味着每三秒尝试生成一次。

其他规则:

settings:
  spawn:
    onlyOnSolidSurface: true
    minimumDistance: 1
    blockedSupportMaterials:
      - "*_TRAPDOOR"
      - "*_SIGN"
      - "*_CORAL*"
      - "BARREL"
      - "*_SLAB"
      - "COBWEB"
      - "*_STAIRS"
      - "*GLASS*"

表面

要求新幸运方块下方必须有坚实的方块。

距离

定义活跃幸运方块之间的水平间距。

设置为 0 可禁用间距检查。

方块列表

防止幸运方块在选定的材质上方生成。

支持通配符模式:

  • *_SLAB — 所有台阶
  • *_STAIRS — 所有楼梯
  • *GLASS* — 包含 GLASS 的所有材质
  • *_CORAL* — 匹配的珊瑚材质

插件还会验证目标位置是否为空、高度是否有效以及支撑方块不是另一种幸运方块材质。


类型

幸运方块类型在 blocks.yml 中配置。

节键是物理 Minecraft 材质。

blocks:
  GLASS:
    chance: 0.33
    breakCount: 3
    hologramY: 1.1
    hologram:
      - "<gold>Fragile Lucky Block</gold>"
      - "<white>Break it <gold>{breakCount}</gold> more times!</white>"
    texture: "BASE64_TEXTURE"

每种类型都支持:

设置项 描述
chance 从 0.0 到 1.0 的随机选择概率
breakCount 所需的击打次数
hologramY 垂直全息图偏移量
hologram 多行 MiniMessage 全息图
texture Base64 头像纹理

{breakCount} 占位符会动态替换为当前的剩余击打次数。

所有 chance 值的总和通常应等于 1.0。当总和较低时,某些生成尝试可能会未选择任何方块。


内置示例

默认配置包含三个示例:

GLASS(玻璃)

  • 概率:0.33
  • 所需击打次数:3
  • 默认奖励:100 Vault 货币和控制台点命令

White(白色)

  • 概率:0.33
  • 所需击打次数:4
  • 默认奖励:150 Vault 货币和更大的点数奖励

LightGray(浅灰色)

  • 概率:0.34
  • 所需击打次数:5
  • 默认奖励:200 Vault 货币和最大的点数奖励

每个默认类型均可完全编辑。


全息图

hLuckyBlock 使用原生的 Paper TextDisplay 实体。

无需外部全息图插件。

全息图支持:

  • 多行文本
  • MiniMessage 语法
  • HEX 颜色
  • 渐变效果
  • Adventure 格式化
  • 按类型的垂直偏移
  • 动态剩余耐久度显示

{breakCount} 的值会在每次成功击打后更新。

当方块被移除时,其全息图也会自动移除。


Base64

每种类型都可以在其物理方块上方显示自定义的 Base64 头像纹理。

无需使用资源包即可提供自定义视觉效果。

纹理处理包括:

  • 每种类型都有独立的纹理
  • 异步准备
  • 有界缓存
  • Paper PlayerProfile 回退机制
  • 用于清理和恢复的持久化内部标签

blocks.yml 中配置的物理材质仍用于识别类型、耐久度和奖励。


限制

settings:
  limit:
    count: 35
    action: STOP_SPAWN

支持的操作:

STOP_SPAWN

当达到活动上限时,停止生成新的幸运方块。

在现有方块被破坏后,生成将自动继续。

DELETE_ALL

当达到上限时,移除所有活动的幸运方块及其视觉实体。

区域将在后续的生成周期中重新开始填充。


奖励

每种方块类型在 actions.yml 中都有其独立的奖励列表。

actions:
  blocks:
    GLASS:
      - "[VAULT] action:give && count:100"
      - "[CONSOLE] p give {player} 10"

支持的操作类型:

[MESSAGE]
[ACTIONBAR]
[TITLE]
[SOUND]
[PARTICLE]
[BOSSBAR]
[BROADCAST]
[CONSOLE]
[PLAYER]
[VAULT]
[EFFECT]
[FIREWORK]
[CLOSE]

操作可以:

  • 发送消息
  • 显示动作栏(ActionBars)和标题(Titles)
  • 创建临时的 BossBar
  • 播放声音
  • 生成粒子效果和烟花
  • 广播消息
  • 执行控制台命令
  • 执行玩家命令
  • 通过 Vault 更改经济余额
  • 关闭玩家当前的物品栏

内部占位符:

{player}
{prefix}

PlaceholderAPI 的值也会使用破坏方块的玩家进行处理。


Vault

支持的 Vault 操作:

操作 结果
give, add 存入金钱
remove, take, delete 取出金钱
clear 将余额设为零
set 设置确切余额

仅在使用 [VAULT] 操作时才需要 Vault 和兼容的经济插件。


恢复

hLuckyBlock 使用持久化的内部标签来标识其 TextDisplay 和 ArmorStand 实体。

在启动期间,插件可以通过以下方式恢复遗留的幸运方块:

  • 查找带标签的头部视觉实体
  • 将其与物理方块匹配
  • 重建耐久度条目
  • 重建全息图
  • 移除过期的视觉实体
  • 检测未跟踪的配置方块材质

这有助于在异常停止或不兼容的外部修改后恢复系统。

在正常运行期间,受跟踪的方块会与真实世界进行同步。如果其他插件更改了方块,过期的跟踪信息和视觉实体将被移除。

干净地关闭插件会移除活动的幸运方块及其视觉实体。

重新加载插件还会在重新启动带有新配置的生成任务之前清理当前区域。


PlaceholderAPI

扩展标识符:

hluckyblock

可用的占位符:

占位符 描述
%hluckyblock_count% 当前活动的幸运方块数量
%hluckyblock_timetospawn% 下次生成尝试前剩余的毫秒数

当生成任务停止时,这两个占位符均返回 0。


命令

命令 描述
/hluckyblock 显示命令帮助
/hluckyblock reload 重新加载配置,刷新集成,清理活动方块并重新启动生成
/hluckyblock start 开始自动生成
/hluckyblock stop 停止未来的生成尝试,但不删除现有方块
/hluckyblock restore 移除所有活动的幸运方块和视觉实体

包含命令补全功能。


权限

权限 描述
hluckyblock.admin 访问所有管理命令
hluckyblock.break 允许破坏幸运方块并获得奖励的权限

服务器操作员默认拥有这两种权限。

普通玩家必须获得 hluckyblock.break 权限后才能使用幸运方块。


文件

文件 用途
locale.yml 选择俄语或英语
config.yml 区域、生成规则、表面和限制
blocks.yml 方块类型、几率、耐久度、全息图和纹理
actions.yml 方块奖励和管理操作
messages.yml 控制台和回退消息

要求

必需

  • Java 21
  • Paper 或 Purpur 1.21.x
  • PlaceholderAPI

REGION

  • WorldEdit
  • WorldGuard

可选

  • Vault
  • 任何兼容 Vault 的经济插件

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源