New Amazing Lucky Blocks - 新版幸运方块插件

NewAmazingLuckyBlocks 是一款基于 RewKun 的 AmazingLuckyBlocks 插件开发的幸运方块插件。它提供了丰富的随机事件、魔法物品和自定义功能，为你的服务器增添无限乐趣。以下是详细的使用指南。

💡如何使用

本插件即装即用。放置一些海绵方块并破坏它们即可开始。以下是几个快速入门要点：

• 要获取所有可用的幸运方块类型，请使用命令 /alb give luckyblocks。
• 要查看某种幸运方块的合成配方，请使用 /alb menu 并选择“LuckyBlock types”选项。更多信息请访问：LuckyBlocks 菜单指南。
• 如果你想将默认的奖励结果数量增加到 900 种以上，请查看扩展包。

资源包

如果你没有幸运方块资源包，可以使用以下链接

适用于 Minecraft 1.8 至 1.13：

• https://bit.ly/3BJHYLO
• https://bit.ly/3P3vCBc (推荐)

适用于 Minecraft 1.14 至 1.19：

• https://bit.ly/3BJHYLO
• https://bit.ly/3zDgGEa (推荐)

不过，更推荐使用带纹理的玩家头颅方块来代替资源包。详情请查阅 Wiki。

🎮命令列表

• /alb – 显示插件信息。
• /alb help <页码> – 显示插件帮助。
• /alb reload – 重载配置和语言文件。
• /alb give wands [玩家名] – 给予你所有魔法棒。
• /alb give objects [数量] [玩家名] – 给予你所有物品。
• /alb give luckyblock [数量] [玩家名] – 给予幸运方块。
• /alb randomblock <半径X> <半径Y> <半径Z> <方块数量> <是否悬浮> [玩家名] – 在你或指定玩家周围放置随机幸运方块。
• /alb randomblock stop – 停止放置随机幸运方块。
• /alb menu – 打开自定义奖励菜单。
• /alb return – 返回上一级菜单。
• /alb worlds – 打开世界菜单。
• /alb worlds list – 显示世界列表。
• /alb worlds set <世界名> <类型> – 将指定世界设置为特定类型。
• /alb loadSchematic <名称> – 将 schematic 文件加载到你的剪贴板。
• /alb saveSchematic <名称> – 将你的剪贴板保存为 schematic 文件。
• /alb removeSchematic <名称> – 删除一个 schematic 文件。

🔧权限节点

以下是默认的权限节点，你可以在配置中进行自定义

• amazinglb.* – 拥有 NewAmazingLuckyBlocks 的所有权限。
• amazinglb.lucky_block.break – 破坏幸运方块。
• amazinglb.lucky_block.place – 放置幸运方块。
• amazinglb.reload – 重载权限。
• amazinglb.update – 接收更新消息的权限。
• amazinglb.givemenu – 使用 GiveMenu 的权限。
• amazinglb.give.wands – 使用 /alb give wands 命令的权限。
• amazinglb.give.objects – 使用 /alb give objects 命令的权限。
• amazinglb.give.luckyblock – 使用 /alb give luckyblock 命令的权限。
• amazinglb.give.luckytool – 使用 /alb give luckytool 命令的权限。
• amazinglb.randomblock – 使用 /alb randomblock 命令的权限。
• amazinglb.menu – 使用 /alb menu 和 /alb return 命令的权限。
• amazinglb.tabcompleter – 使用 TAB 键补全命令的权限。
• amazinglb.worlds – 使用 /alb worlds 命令的权限。
• amazinglb.schematic – 使用 schematic 相关命令的权限。
• amazinglb.wands.WAND – 使用特定魔法棒（WAND）的权限。可单独启用或禁用，默认禁用。
• amazingly.objects.OBJECT – 使用特定物品（OBJECT）的权限。可单独启用或禁用，默认禁用。
• amazingly.lucky_tool – 使用 LuckyTool 的权限。可单独启用或禁用，默认禁用。

更多信息请查阅 Wiki。

✨安装步骤

• 前往下载页面。
• 下载 NewAmazingLuckyBlocks.jar 文件。
• 将下载的文件复制到服务器的 plugins 文件夹，然后启动服务器。
• (可选) 下载扩展包。
• 享受 NewAmazingLuckyBlocks 带来的乐趣！如果喜欢，请留下好评。
• (可选) 欢迎通过提出建议或捐赠来支持本插件。

❓更多信息与链接

未来计划为插件添加更多功能，如果你有任何想法或建议，请随时提出。

重要链接

• 默认奖励列表：查看所有默认的幸运方块奖励结果。链接：Default outcomes
• 扩展包：获取更多奖励内容。链接：Expansion packs
• 魔法棒与物品示例：插件包含的部分物品，如恢复魔杖、TNT魔杖、火焰魔杖、冰霜路径魔杖、黑洞、爆炸弓、追踪弓、钩爪弓等。查看全部请访问：Wands and objects
• 配置文件：查看默认的 config.yml。链接：config.yml
• 世界管理：了解如何启用或禁用世界。链接：Worlds management
• 自定义内容：学习如何创建自定义奖励和幸运方块类型。链接：Custom outcomes and LuckyBlock types

反馈与支持

请注意，评论区域不用于报告漏洞。

• 如果你发现任何漏洞或有任何建议，请在 GitHub 上提交新问题：Issues。
• 你也可以通过私信、在插件讨论区留言，或加入 Discord 服务器进行反馈。

NewAmazingLuckyBlocks 插件文档

NewAmuckyBlocks 是一个功能丰富的幸运方块插件，为你的服务器带来充满惊喜和挑战的冒险体验。它提供了多种类型的幸运方块、自定义奖励与惩罚、强大的配置选项以及流畅的玩家交互。

💡主要特性

• 多种幸运方块类型：包含普通、史诗、传奇、节日、自定义等多种类型的幸运方块，每种都有独特的掉落池。
• 高度可定制：几乎所有内容都可以通过配置文件进行修改，包括消息、物品、奖励和概率。
• 玩家进度系统：内置 /lb stats 命令，玩家可以查看自己开启各类幸运方块的数量。
• 管理员工具：提供 /lb give 和 /lb reload 等命令，方便服务器管理。
• 多语言支持：插件内置多语言系统，默认支持英语和简体中文。
• PlaceholderAPI 支持：可以与其他插件联动，显示相关数据。
• 粒子效果与音效：开启幸运方块时伴有华丽的视觉和听觉效果。

🎮命令与权限

玩家命令

• /lb 或 /luckyblock

- 显示插件帮助信息。

- 权限：`newamazingluckyblocks.command.help` (默认所有玩家拥有)

• /lb stats [玩家名]

- 查看自己或指定玩家的幸运方块开启统计。

- 权限：`newamazingluckyblocks.command.stats` (默认所有玩家拥有)

• /lb list

- 查看所有可用的幸运方块类型列表。

- 权限：`newamazingluckyblocks.command.list` (默认仅 OP 拥有)

管理员命令

• /lb give <玩家名> <类型> [数量]

- 给予指定玩家特定类型的幸运方块。

- 权限：`newamazingluckyblocks.command.give` (默认仅 OP 拥有)

• /lb reload

- 重载插件的配置、语言和掉落池文件。

- 权限：`newamazingluckyblocks.command.reload` (默认仅 OP 拥有)

权限节点总览

• newamazingluckyblocks.command.help
• newamazingluckyblocks.command.stats
• newamazingluckyblocks.command.list
• newamazingluckyblocks.command.give
• newamazingluckyblocks.command.reload
• newamazingluckyblocks.break.* - 允许开启所有类型的幸运方块。
• newamazingluckyblocks.break.<类型> - 允许开启特定类型的幸运方块（例如 newamazingluckyblocks.break.epic）。

🔧安装与配置

安装步骤

• 确保服务器运行 Spigot、Paper 或其衍生服务端（版本 1.16.x - 1.20.x）。
• 将下载的 NewAmazingLuckyBlocks.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 首次运行后，插件会在 plugins/NewAmazingLuckyBlocks/ 目录下生成配置文件。
• 根据需求编辑 config.yml、pools.yml 和 lang/ 目录下的语言文件。

配置文件说明

• config.yml：主配置文件，包含插件开关、基础设置、方块类型定义、音效和粒子效果等。
• pools.yml：定义所有幸运方块类型的掉落池，包括奖励、惩罚、概率和命令。
• lang/ 目录：存放语言文件，如 zh_CN.yml（简体中文）和 en_US.yml（英文）。

重载配置

修改配置文件后，无需重启服务器，只需在游戏内或控制台执行 /lb reload 命令即可应用更改。

✨创建自定义幸运方块

定义新方块类型

• 打开 config.yml，在 luckyblocks: 部分下添加新的方块类型。
• 示例：

  custom:
    name: "&d自定义方块"
    item: "DIAMOND_BLOCK"
    glowing: true

• name：方块在物品栏中显示的名称（支持颜色代码）。
• item：使用的 Minecraft 材料类型。
• glowing：物品是否带有附魔光泽效果。

配置掉落池

• 打开 pools.yml，为你创建的方块类型（如 custom）添加新的配置节。
• 在该节下配置 rewards（奖励）和 punishments（惩罚）。
• 每个奖励/惩罚都需要设置 chance（概率，0-100之间的数字）和 type（类型，如 COMMAND, ITEM, EFFECT 等）。
• 根据不同的 type 配置相应的参数（如命令、物品、药水效果等）。

❓常见问题 (FAQ)

• 问：支持哪些 Minecraft 版本？

- 答：插件支持 1.16.x 至 1.20.x 的 Spigot/Paper 服务端。

• 问：如何更改开启幸运方块的权限？

- 答：使用权限管理插件（如 LuckPerms），为玩家添加 `newamazingluckyblocks.break.<类型>` 权限节点。

• 问：掉落池的概率如何计算？

- 答：每个奖励或惩罚的 `chance` 值是独立计算的百分比概率。插件会遍历列表，为每个符合条件的项目进行概率判定。

• 问：如何添加一个执行控制台命令的奖励？

- 答：在 `pools.yml` 的奖励列表中，添加一个类型为 `COMMAND` 的条目，并将 `console` 设置为 `true`，然后在 `command` 中填写命令。

• 问：插件与 WorldGuard 等保护插件冲突吗？

- 答：通常情况下不冲突。但如果你在受保护区域不希望幸运方块被放置或开启，可能需要配置相应插件的标志（flag）。

⭐提示与技巧

• 在配置掉落池时，可以先设置较低的概率进行测试，确保平衡性后再调整。
• 充分利用多语言文件，可以为你的服务器玩家提供更友好的本地化信息。
• 自定义幸运方块时，可以参考已有的 common（普通）、epic（史诗）等类型的配置作为模板。
• 定期备份你的配置文件，尤其是在进行重大修改之前。
• 结合 PlaceholderAPI，你可以在其他插件（如计分板或聊天插件）中显示玩家开启幸运方块的统计次数。

如需更多帮助或报告问题，请访问插件的 GitHub 仓库。