GenBucket - 一键筑墙桶

GenBucket 是一款允许玩家使用特殊“生成桶”快速创建指定方块墙的插件。它尤其适合领地类服务器，能极大地方便玩家建造防御工事或大型结构。

💡核心功能

• 使用一个桶即可快速生成一堵方块墙。
• 高度可配置，可自定义生成桶的类型、外观和属性。
• 支持通过告示牌创建商店，买卖生成桶。
• 与主流领地保护插件（如 WorldGuard, Factions）集成，防止滥用。
• 可设置生成间隔、是否消耗桶、是否对玩家收费等细节。

🎮指令列表

主要指令：

• /genbucket give <玩家名> <lava/water> <方块材质> <使用次数> <数量> - 给予指定玩家一个生成桶。
• /genbucket giveBucket <玩家名> <物品ID> <数量> - 给予配置文件中定义的特定生成桶。
• /genbucket reload - 重载所有配置文件。

指令中的 <物品ID> 字段需在 config.yml 文件的 Items: 部分进行定义。

🎮权限节点

• genbucket.place - 允许放置生成桶。
• genbucket.command.reload - 允许使用重载指令。
• genbucket.command.help - 允许使用帮助指令。
• genbucket.command.give - 允许使用 /genbucket give 指令。
• genbucket.command.givebucket - 允许使用 /genbucket giveBucket 指令。

🔧配置说明

主要配置 (config.yml)

基础设置：

• interval(seconds)：生成方块的间隔时间（秒）。
• stay-liquid：放置后桶内液体是否保留。
• allowing-sponge：是否允许海绵吸收生成的水（建议保持 false 以避免卡顿）。
• remove-empty-bucket：使用后是否移除空桶。
• glowingBucket：生成桶是否发光。
• charge-player：放置生成桶时是否向玩家收费。
• charge-amount：收费金额。
• disabled-regions：禁止放置生成桶的区域列表（需配合 WorldGuard）。

商店与物品设置：

• sign-prefix：告示牌商店的首行前缀。
• currency-sign：货币符号。
• useable-amount-line：物品 lore 中显示剩余使用次数的行文本（使用 %use% 占位符）。

创建自定义生成桶 (Items:)：

• 必须包含 displayname, lore, block, liquid, glow, useable-amount 选项。
• displayname 中必须保留 %block% 以检测生成的方块类型。
• lore 中必须包含 %use% 占位符以显示剩余使用次数。
• 可参考预设的 stonebucket 示例进行配置。

消息配置 (Messages.yml)

此文件用于自定义插件发送给玩家的各类提示信息，例如权限不足、操作成功、金钱扣除等。你可以根据需要修改或清空（留空 '' 则不发送）任何消息。

✨依赖与兼容

必需插件：

• Vault (用于经济系统)

支持的领地/保护插件：

• WorldGuard
• Factions (MassiveCraft)
• FactionsUUID
• LegacyFactions
• GriefPrevention

❓告示牌商店使用指南

要创建一个生成桶商店，请在告示牌上按顺序写入以下内容：

第一行： [GenBucket] (或你在配置中定义的 sign-prefix)

第二行： Buy 或 Sell

第三行： 生成桶的物品ID（即在 config.yml 的 Items: 下定义的键名，如 stonebucket）

第四行： 价格（例如 $100）

放置后，告示牌将自动转换为功能商店。

⭐注意事项与支持

• 请严格按照示例格式在 config.yml 中创建自定义生成桶物品，否则可能导致错误。
• 发现任何漏洞（Bug），请在 Spigot 站内私信作者，或通过 Discord (cityforus.net/discord) 在 #genbucket 频道寻求支持。
• 请在提交插件评价前报告你发现的漏洞，感谢合作。