SuperLuckyBlock Lite - 轻量版幸运方块

SuperLuckyBlock 是一款功能全面的幸运方块插件，赋予你对所有功能的完全控制权。你可以创建自定义惊喜、设计独特的幸运方块、制作专属魔杖，并修改插件的几乎每一个细节。你可以随心所欲地使用它，打造独一无二的游戏体验。

💡重要须知

• 仅付费版（Premium）用户可获得官方支持。
• 我建立了一个 Discord 服务器，供免费版用户交流插件使用、分享配置、Lua脚本、互相帮助或提出新想法。你可以在此加入：https://discord.com/invite/D2VfXUYsSg
• 请注意：此 Discord 服务器不提供免费插件的技术支持。
• 付费版购买地址：https://www.spigotmc.org/resources/48837/

🎮核心特性

以下标记为 (Premium Only) 的功能仅在付费版中可用。

自定义惊喜 (Premium Only)

这是 SuperLuckyBlock 的独家功能。你可以创建并完全自定义惊喜内容，例如生成生物、掉落物品、建造建筑、执行命令，或者同时进行以上所有操作！

Lua 脚本惊喜

SuperLuckyBlock 允许你使用 Lua 脚本语言创建惊喜，这为你提供了无限的创作自由。你可以完全与 Spigot API 交互，实现任何你能想到的惊喜效果。

脚本分为两种模式

• 非信任脚本：默认模式，在沙箱中运行，安全性高。
• 信任脚本 (Premium Only)：不在沙箱中运行，功能更强大但也更危险。它可以访问所有 Java 和 Spigot 类、进行文件读写、使用 IO 和 OS 库、加载其他脚本以及创建协程。

Lua 脚本可用变量示例：

• player - 打破幸运方块的玩家。
• loc - 幸运方块被打破的位置。
• world - 幸运方块所在的世界。
• scheduler - Bukkit 调度器，可用于延迟任务。
• MATERIAL_XXX, EFFECT_XXX, SOUND_XXX, ENCHANTMENT_XXX - 对应的 Material、效果、声音和附魔枚举值。
• utils - 工具类，提供创建物品、着色文本、创建附魔等方法。

无限幸运方块 (Premium Only)

你可以创建无限数量的自定义幸运方块。可以设置头颅皮肤、设置使用权限、关联自定义惊喜等。免费版仅限创建一个幸运方块。

魔杖系统 (Premium Only)

魔杖是能施展特殊效果的武器。

内置魔杖包括：

• 史莱姆魔杖 - 发射可配置大小的史莱姆。
• TNT魔杖 - 发射已点燃的TNT。
• 烈焰人魔杖 - 发射烈焰人实体。
• 火球魔杖 - 以0.5秒延迟发射可配置数量的火球。
• 闪电魔杖 - 在玩家瞄准的方块处召唤闪电。
• 治疗魔杖 - 为玩家回复指定生命值。

自定义魔杖 (Premium Only)

如果不喜欢内置魔杖或觉得功能不足，你可以创建自己的魔杖，使其能够：

• 投掷方块
• 生成实体
• 执行命令

自定义头颅皮肤 (Premium Only)

你可以使用来自如 https://minecraft-heads.com/ 等网站的皮肤纹理URL，或者直接使用某个玩家的皮肤。

基于概率的惊喜

惊喜并非完全随机选择，而是采用概率系统。你可以自由设定每个惊喜的稀有度，让强力物品的出现概率更低。

幸运行动 (Premium Only)

仅通过合成获得幸运方块可能有些单调。幸运行动系统允许玩家在进行特定游戏行为时，有概率获得幸运方块。

• 当前支持的行为：挖掘。
• 未来将添加更多行动。

自定义消息

你可以为每个惊喜（包括自定义惊喜）添加触发时显示的提示消息。

合成配方

除了幸运挖掘，你还可以启用并自定义合成配方，让玩家能够合成幸运方块。

商店系统 (Premium Only)

通过 GUI 界面，玩家可以购买或出售幸运方块，价格完全由你设定。

PlaceholderAPI 支持

可用于显示 SuperLuckyBlock 的相关信息和玩家数据统计。

• 当前占位符：%superluckyblock_luckyblocksbroken% - 显示玩家打破的幸运方块数量。

全面控制

你可以禁用特定世界的幸运方块、设置权限、更改头颅皮肤、自定义打破时的声音和粒子效果等，拥有极高的管理自由度。

🔧应用场景

生存模式

幸运方块能让生存模式更加有趣。玩家乐于测试运气，获得独特或刺激的体验。

幸运空岛战争

为空岛战争游戏加入幸运方块，增添独特的变数。建议添加一些自定义的建筑类惊喜来增加乐趣。

监狱服

结合“海绵模式”，你可以在监狱矿场中使用海绵（幸运方块），让挖矿过程变得更有趣、更值得期待。

其他小游戏

任何允许破坏方块且会保存或回滚地图的小游戏，都可以与 SuperLuckyBlock 搭配使用。

战利品箱

将幸运方块作为玩家奖励，让他们可以在任何地方打开，获得一份（好或坏的）惊喜，这比普通的战利品箱更具新意。

纯娱乐

你可以与朋友一起，用幸运方块建造地图或楼梯，进行幸运方块竞速赛，或者单纯比比谁的运气更好。一切皆有可能！

✨要求与依赖

必需条件

• Minecraft 服务器版本：1.13 或更高。
• Java 版本：8 或更高。

可选依赖插件

• PlaceholderAPI：用于支持占位符功能。
• Vault 及一个经济插件（如 Essentials）：用于支持 /slb shop 商店的买卖经济系统。
• WorldEdit：当使用自定义建筑惊喜时，用于生成建筑。

⭐命令与权限

命令格式说明：<> 表示必填参数，[] 表示可选参数。

可用命令：

• /slb give <luckyblock name> <player> [amount] - 给予指定玩家指定数量的幸运方块。
• /slb giveall <luckyblock name> [amount] - 给予所有在线玩家指定数量的幸运方块。
• /slb help - 显示帮助页面。
• /slb reload - 重载插件配置（某些选项可能需重启服务器才能完全重载）。

对应权限：

• superluckyblock.help - 允许使用 /slb help
• superluckyblock.give - 允许使用 /slb give
• superluckyblock.giveall - 允许使用 /slb giveall
• superluckyblock.reload - 允许使用 /slb reload