LootCrate - 服务器宝箱插件

请提供您需要翻译的 Minecraft 插件文档原文，我将为您生成一份结构清晰、语言流畅的中文版本。

💡快速入门

开始使用 LootCrate 插件前，你需要先构思好宝箱的设定。需要考虑的几个重要方面包括：

• 宝箱名称
• 宝箱奖励
• 宝箱钥匙类型

你的宝箱名称应该能描述其用途。例如，如果你想奖励投票的玩家，可以将其命名为 VoteCrate。

> 重要提示：所有宝箱名称不能包含空格。

确定名称后，接下来需要构思给予玩家的奖励。奖励可以是特殊道具、游戏币、物品等等。

最后，你需要设计一把用于开启宝箱的钥匙。大多数人会选择默认的绊线钩，因为它看起来最像现实中的钥匙。

🎮宝箱设置

构思完成后，现在开始创建你的 LootCrate！

创建宝箱

首先，执行命令 /lootcrate create <宝箱名称>。例如：/lootcrate create VoteCrate。这将创建一个 LootCrate 对象，以便你开始编辑。

执行命令后，你会在聊天栏收到一条消息，其中包含宝箱的自动生成 ID。请务必记住这个 ID，因为之后所有操作都需要用它来引用你的宝箱。

放置宝箱

现在宝箱已创建，但玩家还无法使用。你需要将其放置到世界中。让你的玩家视角直接对准你想变成 LootCrate 的方块。

> 提示：该方块不一定是箱子，但大多数玩家会选择使用箱子。

执行命令 /lootcrate set <宝箱ID>。例如：/lootcrate set 219，即可将 LootCrate 绑定到这个方块。如果启用了 HolographicDisplays 插件，你会看到全息文字出现（后续可以编辑）。

现在，宝箱已经成功绑定到一个方块上了。

> 提示：你可以将同一个宝箱绑定到多个方块上。

如果你不满意宝箱的位置，可以看着它并执行命令 /lootcrate set none 来移除该位置的宝箱。

设置钥匙

最后，我们需要为宝箱添加一把钥匙。手持你想要设置为钥匙的物品（可以使用 /meta 命令编辑物品属性），然后执行命令：

/lootcrate key <宝箱ID> <true/false>

例如：/lootcrate key 219 true。

> 提示：大多数玩家使用绊线钩作为钥匙。

✨添加奖励

宝箱的位置和钥匙都已设置完毕，现在开始添加奖励。

添加奖励物品

手持你想要作为奖励的物品，执行命令

/lootcrate add <宝箱ID> <最小数量> <最大数量> <获得几率> <true/false>

例如：/lootcrate add 219 1 64 50 false。

与创建命令类似，系统会返回一个该奖励的 Reference #（物品ID），请保存好它以备后用。

参数详解：

• <宝箱ID>：你想要添加奖励的宝箱的 Reference #。
• <最小数量> & <最大数量>：玩家可以获得该物品的最小和最大数量。系统会在此区间内随机选择一个数字作为最终奖励数量。

> 提示：将最小和最大值设为相同数字，玩家将总是获得固定数量。例如，都设为 16，则玩家每次都会获得 16 个该物品。

• <获得几率>：玩家获得此物品的百分比概率。

> 提示：如果你有两个奖励，几率都设为 50，那么玩家获得其中任一物品的概率都是 50%。

• <true/false>：决定是同时给予物品并执行命令，还是仅执行命令。
• 若希望玩家既获得物品，又执行相关命令，请设为 false。
• 若希望只执行命令（例如给予游戏币）而不给予手持的物品，请设为 true。

为奖励附加命令

以游戏币奖励为例。我们希望玩家获得该奖励时能收到钱，这就需要为奖励附加命令。

执行命令

/lootcrate command <宝箱ID> <物品ID> <命令>

例如：/lootcrate command 219 11220 pay {player} 50

> 提示：你可以使用 {player} 作为玩家名的占位符。

你可以为同一个奖励添加无限条命令。请注意，所有命令都将由控制台执行。

现在，当玩家获得游戏币奖励时，他们会收到 50 游戏币，但没有任何提示。我们可以再添加一条命令来告知玩家：

/lootcrate command 219 11220 message {player} &eYou received &a$50!