手工板条箱奖励（自定义物品奖励）

Hand Crates (TRUST)

https://github.com/kliti72/HandCrates---Reward-in-You-Hand

 

是否曾想把那些闲置在出生点的旧箱子，变成玩家们会兴奋地想要打开的奖励？Hand Crates 让你能将 Hytale 世界中的任何方块，都变成一个可完全自定义的实体板条箱——设计奖励、设定外观、发放给玩家，全程无需离开游戏或触碰配置文件。

无论你是在构建一个投票奖励系统、地下城战利品箱，还是季节性活动箱，Hand Crates 都能为你提供一个快速、直观的游戏中工作流程，让你在几分钟内完成设置。

//TODOIMAGE

为什么选择 Hand Crates？

设置奖励箱通常意味着要翻查插件配置文件、重启服务器，还得祈祷你输入物品 ID 时没有打错字。Hand Crates 彻底改变了这一切。从选择方块类型到通过拖放填充奖励，所有操作都通过简单的命令和游戏内 GUI 完成。做出更改，点击重载，即可立即生效。

功能特性

• 从游戏中任何方块类型创建板条箱
• 创建带有附加命令的自定义物品
• 游戏内 GUI 编辑器，用于填充板条箱奖励（拖放物品）
• 支持颜色标签的自定义显示名称和描述，适用于板条箱和物品
• 通过命令直接将板条箱或物品发放给玩家
• 随时列出、编辑、删除板条箱和物品
• 物品命令可由控制台执行
• 热重载——无需重启服务器

示例：创建自定义手持奖励箱

下面是一个从零开始设置“地牢”板条箱的示例——包括创建它、自定义其外观以及配置奖励：

# 创建自定义板条箱奖励
/handcrates --create=Dungeon --blocktype=Furniture_Desert_Chest_Small

# 给予自定义板条箱奖励物品
/handcrates --give=Dungeon --player=kliTi2000

# 设置物品显示名称
/handcrates --edit=Dungeon --display="<red> 投票 <bold> 钥匙 </bold> </red>"

# 设置描述示例
/handcrates --edit=Dungeon --lore="<green> 这个板条箱奖励你地牢的奖励 </green>"

# 设置奖励（打开游戏内 GUI 编辑器）
/handcrates --edit=Dungeon

当你运行最后一条命令时，游戏内奖励编辑器就会弹出，让你拖放玩家将赢得的物品：

以下是成品板条箱在服务器上运行的样子：

 

示例：创建带有命令的自定义物品

创建带命令的物品
/handcrates --create=VoteKey --blocktype=Item_Small_Key --command="give {player} example_id"

设置物品显示名称
/handcrates --edit=VoteKey --display="<gold> 投票钥匙 </gold>"
设置物品描述

/handcrates --edit=VoteKey --lore="<gray> 在出生点兑换此物品 </gray>"
使其由控制台执行（绕过玩家权限）

/handcrates --edit=VoteKey --console=true
稍后编辑命令

/handcrates --edit=VoteKey --command="give {player} example_id 1"
将物品给予玩家

/handcrates --give=VoteKey --player=kliTi2000

 

所有命令

命令	描述
/handcrates --create={name} --blocktype={type}	创建一个新板条箱
/handcrates --edit={name}	打开奖励编辑器 GUI
/handcrates --edit={name} --animation="Flower"	设置板条箱打开动画 (Flower, Vortex)
/handcrates --create={itemName} --blocktype={type} --command="give {player} example_id"	创建物品的命令
/handcrates --edit={itemName} --command="give {player} example_id"	编辑物品的命令
/handcrates --edit={itemName} --console=true	从控制台执行此命令
/handcrates --edit={item or crate name} --lore="..."	设置物品或板条箱描述
/handcrates --edit={item or crate name} --display="..."	设置物品或板条箱显示名称
/handcrates --give={item or crate name} --player={player}	将物品或板条箱给予玩家
/handcrates --list=true	列出所有板条箱
/handcrates --delete={item or crate}	删除一个物品或板条箱
/handcrates --reload=true	重载插件

 

可配置消息

想让插件使用你服务器的语言和语气？每条消息都可以直接从 config.json 中编辑：

键 (Key)	默认值 (Default value)	占位符 (Placeholder)
open	You open the chest {crates}	{crates} → 板条箱名称
give	You give crates {crates}	{crates} → 板条箱名称
recive	You recive crates {crates}	{crates} → 板条箱名称
inventory_full	<red> Your inventory not have amount space. </red>	—

安装方法

1. 将 .jar 文件放入服务器的 mods/ 文件夹
2. 重启服务器
3. 运行 /handcrates --list=true 确认所有内容加载正确

仅此而已——你可以开始构建板条箱了。

权限

需要管理员（operator/admin）身份或拥有 handcrates.admin 权限才能管理和编辑板条箱。

---

有功能创意或遇到奇怪的问题？请在项目页面分享你的反馈和建议——Hand Crates 因社区意见而不断改进。