FortuneBlocks - 自定义幸运方块

幸运方块 (Fortune Blocks)

本插件允许玩家将镐子上的“时运”附魔效果应用到默认范围之外的方块上。它完全可自定义，可通过简单命令实时重载配置与语言文件，轻松管理要追踪的方块材料。此外，插件还能追踪玩家放置的方块，以防止无限复制。

💡配置说明

配置文件结构如下

version: 2.0
blocks:
- diamond_block
- emerald_block
- gold_block
- coal_block
pickup: true
full:
  drop: true
  message:
    use: true
    cooldown: 5
require_survival: true
tracking:
  enabled: false
  save_rate: 6000

配置项详解

• version：请勿修改！如果此版本号与插件代码中的不匹配，您的更改将被重置。
• blocks：此列表中的材料将受到时运效果影响。
• pickup：设为 true 时，物品将直接进入玩家背包。也可通过下文权限为个别玩家启用此功能。
• full：当玩家背包已满且应拾取物品时的处理方式。
• full.drop：设为 true 时，物品会掉落在地上而非消失。
• full.message：背包已满时的提示消息设置。

- **full.message.use**：设为 `true` 时，将向玩家发送提示消息。

- **full.message.cooldown**：发送背包已满消息的冷却时间（秒）。

• require_survival：是否要求玩家处于生存模式才能触发幸运方块效果。通常应设为 true。
• tracking：追踪方块放置的设置。
• tracking.enabled：设为 true 时，将保存已放置的方块并写入文件，防止玩家复制方块。建议仅用于非监狱服务器，多数情况下请保持 FALSE。
• tracking.save_rate：文件保存的时间间隔（游戏刻）。

🎮命令

使用 /fortuneblocks 命令进行管理：

• /fortuneblocks add [material] - 添加新的待追踪材料。
• /fortuneblocks remove [material] - 移除已追踪的材料。
• /fortuneblocks list - 列出所有已追踪的材料。
• /fortuneblocks reload - 重载配置和语言文件。

🔧权限

• fortuneblocks.silent - 允许玩家放置方块而不被追踪。
• fortuneblocks.pickup - 当全局 pickup 选项关闭时，允许特定玩家的物品直接进入背包。
• fortuneblocks.admin - 允许使用命令系统。
• fortuneblocks.admin.add - 允许管理员添加材料。
• fortuneblocks.admin.remove - 允许管理员移除材料。
• fortuneblocks.admin.list - 允许管理员列出材料。
• fortuneblocks.admin.reload - 允许管理员重载配置和语言文件。

❓常见问题

• 要使用命令系统，您必须同时拥有 fortuneblocks.admin 权限以及对应的 fortuneblocks.admin.[command] 权限（例如 fortuneblocks.admin.add）。

⭐已知问题

• 当启用追踪 (tracking.enabled) 时，玩家可以通过活塞移动方块来绕过追踪。
• 如果您运行的并非最新的 1.12 版本，本插件必须取消 BlockBreakEvent（这是其他插件“监听”方块被破坏的方式）。除非您有记录方块破坏历史的插件，否则这通常不是问题。除了更新到最新的 1.12 版本，或由我为冲突插件编写特定的钩子外，暂无其他解决方法。如果您确实需要解决此问题以使用本插件，请告知与之冲突的插件名称，我将尝试寻找变通方案。

✨致谢

• Essentials 团队 - 使用了 Essentials 的 items.csv 文件以简化工作。