Forbidden Blocks Paper

插件

· 作者 Evol-Luci

这个强大的插件允许你通过根据物品的显示名称限制特定物品的放置,来细致地控制建筑环境。例如,防止带有名称或包含描述文本的方块被随意放置——ForbiddenBlocks

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

最新 1.0 · 1.21.4 · Bukkit / Paper

一键开服(送7天)

Title Bar

? ForbiddenBlocks 插件 ?️

描述

通过 ForbiddenBlocks Plugin 增强你的 Minecraft 服务器游戏体验!? 这款强大的插件允许你根据物品的显示名称,细致地控制建筑环境,限制特定物品的放置。想象一下,阻止包含指定名称或lore(物品描述)的方块被随意放置——ForbiddenBlocks 让这一切变得轻而易举!?️

拥有相应权限的服务器管理员和玩家可以禁止或允许物品放置,这为服务器管理提供了多功能工具。限制可以应用于全局,影响所有玩家,也可以专门针对个别玩家,从而对方块放置进行细粒度的控制。无论你是想在生存世界中防止使用某些装饰性方块,还是想限制在特定区域进行建造,ForbiddenBlocks 都能赋予你掌控力!?➡️⛔

安装说明

只需几个简单的步骤即可开始使用 ForbiddenBlocks:

  1. ? 下载 ForbiddenBlocks 插件的 JAR 文件。
  2. ? 将 JAR 文件放入 Minecraft 服务器的 plugins 目录中。
  3. ? 重启服务器以激活插件。

就是这样!ForbiddenBlocks 现已准备好帮助你管理服务器的建筑格局。?

用法

通过这些易于使用的命令,掌控服务器的建筑规则:

命令

  • /forbiditem [player|global] [itemName]: ⛔ 禁止物品放置。

    • 使用此命令防止玩家当前手持的物品或指定的 itemName 被放置。
    • 可以通过名称针对特定玩家,或使用 global 将限制应用于整个服务器。
    • 如果省略 itemName,则禁止手中持有的物品。
    • 物品通过其显示名称进行识别,确保与自定义物品的兼容性。
    /forbiditem global TNT  <- 禁止所有人使用TNT
    /forbiditem Notch Diamond Block <- 禁止玩家 'Notch' 使用钻石块
    /forbiditem global <- 全局禁止你手中持有的物品
    
  • /allowitem [player|global] [itemName]: ✅ 允许物品放置。

    • 逆转 /forbiditem 的效果,允许之前被禁止的物品放置。
    • 工作原理类似于 /forbiditem,允许你针对玩家或全局设置,并可选择指定 itemName。
    • 如果未提供 itemName,则重新允许手中持有的物品。
    /allowitem global TNT  <- 再次允许所有人使用TNT
    /allowitem Notch Diamond Block <- 再次允许玩家 'Notch' 使用钻石块
    /allowitem global <- 再次全局允许你手中持有的物品
    
  • /togglemessages: ? 切换放置限制消息。

    • 玩家可以使用此命令控制他们在尝试放置禁止方块时是否收到消息。
    • 通过允许玩家静音通知来个性化游戏体验。
    /togglemessages <- 切换你的消息通知
    
  • /listforbidden [player]: ? 列出禁止的物品。

    • 显示当前所有被禁止的物品列表。
    • 可选择指定一个 player 名称以查看专门对该玩家禁止的物品。
    • 如果没有玩家名称,则显示全局禁止的物品。
    /listforbidden <- 列出全局禁止的物品
    /listforbidden Notch <- 列出玩家 'Notch' 被禁止的物品
    
  • /reloadconfig: ? 重载插件配置。

    • 应用 config.yml 文件中进行的更改,无需重启服务器。
    • 非常适合快速调整和测试配置更改。
    /reloadconfig <- 重载 config.yml
    

权限

通过这些权限微调对 ForbiddenBlocks 命令的访问:

  • forbiddenblocks.forbid: ⛔ 允许使用 /forbiditem 来限制物品放置。

  • forbiddenblocks.allow: ✅ 允许使用 /allowitem 来重新启用物品放置。

  • forbiddenblocks.togglemessages: ? 允许使用 /togglemessages 来管理通知。

  • forbiddenblocks.list: ? 允许使用 /listforbidden 来查看禁止的物品。

  • forbiddenblocks.reload: ? 允许使用 /reloadconfig 来重载配置。

    # 权限插件(如 LuckPerms)中的示例
    groups:
      admin:
        permissions:
        - forbiddenblocks.* # 给管理员所有 ForbiddenBlocks 权限
      builder:
        permissions:
        - forbiddenblocks.list # 允许建筑者列出禁止的物品
    

配置

通过编辑位于插件文件夹中的 config.yml 文件,自定义 ForbiddenBlocks 以完美适应你的服务器需求。

以下是配置选项的详细说明:

  • Messages: ✉️ 根据你的喜好定制游戏内消息!
    • 自定义插件针对不同操作发送的每条消息(例如,当物品被禁止或玩家收到通知时)。
    • 利用 MiniMessage 格式标签 添加丰富的文本格式,如颜色 <color:red>、样式 <b> 等等!✨
    • 参考 config.yml 中的默认消息示例,释放你的创造力!?
    • 可用的消息路径:
      • messages.cannotPlace: 玩家尝试放置禁止方块时的消息。
      • messages.itemForbidden: 物品成功被禁止时的消息。
      • messages.itemAllowed: 物品成功被允许时的消息。
      • messages.mustHoldNamedItem: 在使用 /forbiditem 或 /allowitem 但未手持命名物品时的消息。
      • messages.noPermission: 通用无权限消息。
    messages:
      cannotPlace: "<red>? 你不被允许在此处放置 <item>!</red>"
      itemForbidden: "<green>✅ <item> 现在已被禁止!</green>"
      itemAllowed: "<green>✅ <item> 现在再次被允许使用!</green>"
      mustHoldNamedItem: "<yellow>⚠️ 你必须手持一个带有显示名称的物品!</yellow>"
      noPermission: "<red>❌ 你没有权限使用此命令。</red>"
    ```

*   **选项 (Options)**:⚙️ 插件的全局设置。
    *   `sendMessages`:一个布尔值选项(true/false),用于全局控制插件是否向玩家发送限制消息。
        *   `true`(默认):当玩家尝试放置被禁止的方块时,会向他们发送消息。
        *   `false`:不发送任何消息,提供静默限制效果。

    ```yaml
    options:
      sendMessages: true
    ```

*   **玩家禁止物品 (playerForbiddenItems)**:?️ 精确管理禁止放置的物品。
    *   此部分定义了哪些物品禁止放置,包括全局范围和针对特定玩家的设置。
    *   插件会将正在放置的物品的**显示名称**与这些配置进行比对检查。
    *   `global`:服务器中**所有玩家**都禁止放置的物品显示名称列表。
        *   在此处添加物品显示名称以实现全服务器的限制。
        *   支持纯文本物品名称、命名空间键(如 `minecraft:bedrock`),甚至支持使用 MiniMessage 格式化的显示名称以进行高级物品自定义。
    ```yaml
    playerForbiddenItems:
      global:
        - "TNT"
        - "Minecraft:Bedrock" # 带命名空间的示例
        - "<gradient:#FF0000:#0000FF>超级爆炸箱</gradient>" # 带 MiniMessage 格式化的示例
    ```
    *   `PlayerName`:为**单个玩家**创建专属部分,需使用其确切的玩家名称。
        *   在每个玩家名称下方,列出**仅对该玩家**禁止放置的物品显示名称。
        *   这允许为每个玩家实现高度定制化的建筑权限!
        ```yaml
    playerForbiddenItems:
      global:
        - "TNT"
      Notch: # 针对 'Notch' 的玩家专属限制
        - "Oak Log"
        - "Oak Plank"
    ```

## 工作原理 ⚙️

ForbiddenBlocks 插件通过以下方式工作:

1.  **监听方块放置事件:** 插件注册了一个事件监听器,监控 Minecraft 服务器中的 `BlockPlaceEvent`。每当玩家尝试放置方块时,都会触发此事件。 ?
2.  **检查物品显示名称:** 当发生方块放置事件时,插件会从玩家手中获取物品并检查其是否具有显示名称。然后使用 MiniMessage 将该显示名称序列化为字符串。 ?️
3.  **与禁止列表进行验证:** 插件随后将此显示名称与两个列表进行核对:
    *   **全局禁止物品:** 定义在 `config.yml` 中 `playerForbiddenItems.global` 下的,禁止所有玩家放置的物品列表。 ?
    *   **玩家专属禁止物品:** 定义在 `config.yml` 中 `playerForbiddenItems.PlayerName` 下的,禁止特定玩家放置的物品列表。 ?
4.  **取消放置并通知玩家:** 如果已放置物品的显示名称在全局或玩家专属禁止列表中,插件将取消 `BlockPlaceEvent`,从而阻止方块被放置。 ?
    *   如果在配置中启用(`options.sendMessages: true`),插件会向玩家发送一条可自定义的消息,告知他们不允许放置该方块。 ?

此过程确保方块放置限制得以平滑且高效地执行,增强了你对服务器建筑环境的控制能力。 ✨

## 贡献代码

? **欢迎贡献!** 如果你有改进建议、新功能想法或漏洞修复,请随时参与贡献!

*    提交包含你更改内容的 **Pull Request**。
*   ? **打开 Issue** 以讨论漏洞或提出增强建议。

让我们一起让 ForbiddenBlocks 变得更好! ?

## 许可证

本项目采用 **MIT 许可证** 授权。你可以按照许可证条款自由地使用、修改和分发它。 ?

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源