Custom Item Command & Reward

By
kliTi2000

Turn any block into a customizable physical crate for your Hytale server — create, fill, and hand out reward crates entirely in-game.

Hand Crates (TRUST)

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

Ever wanted to turn that old chest sitting in your spawn area into something players actually get excited about opening? Hand Crates lets you transform any block in your Hytale world into a fully customizable physical crate — design the rewards, set the look, and hand them out, all without ever leaving the game or touching a config file.

Whether you're building a vote rewards system, a dungeon loot chest, or a seasonal event crate, Hand Crates gives you a fast, intuitive in-game workflow to make it happen in minutes.

//TODOIMAGE

Why Hand Crates?

Setting up reward crates usually means digging through plugin configs, restarting your server, and hoping you didn't typo an item ID. Hand Crates throws that out the window. Everything — from picking the block type to filling rewards via drag & drop — happens through simple commands and an in-game GUI. Make a change, hit reload, and it's live instantly.

Features

Create a crate from any in-game block type
Create custom items with attached commands
In-game GUI editor to fill crate rewards (drag & drop items)
Custom display name and lore with color tag support, for crates AND items
Give crates or items directly to players via command
List, edit, delete crates and items anytime
Console-executed commands option for items
Hot reload — no server restart needed

Example: Creating a Custom Hand Reward Crate

Here's an example of setting up a "Dungeon" crate from scratch — creating it, customizing how it looks, and configuring the rewards:

# Create Custom Crates Reward
/handcrates --create=Dungeon --blocktype=Furniture_Desert_Chest_Small

# Give Custom Crates Reward Item
/handcrates --give=Dungeon --player=kliTi2000

# Set Item Name Display
/handcrates --edit=Dungeon --display="<red> Vote <bold> Key </bold> </red>"

# Set Lore Example
/handcrates --edit=Dungeon --lore="<green> This Crates give you reward of doungeon </green>"

# Set Reward (opens in-game GUI editor)
/handcrates --edit=Dungeon

Once you run that last command, the in-game reward editor pops up, letting you drag and drop exactly what you want players to win:

And here's a look at a finished crate in action on a live server:

Example: Creating a Custom Item with Command

Create item with attached command
/handcrates --create=VoteKey --blocktype=Item_Small_Key --command="give {player} example_id"

Set item display name
/handcrates --edit=VoteKey --display="<gold> Vote Key </gold>"
Set item lore

/handcrates --edit=VoteKey --lore="<gray> Redeem this at spawn </gray>"
Make it console-executed (bypasses player permissions)

/handcrates --edit=VoteKey --console=true
Edit command later

/handcrates --edit=VoteKey --command="give {player} example_id 1"
Give the item to a player

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

All Commands

Command	Description
`/handcrates --create={name} --blocktype={type}`	Create a new crate
`/handcrates --edit={name}`	Open the reward editor GUI
`/handcrates --edit={name} --animation="Flower"`	Set open animation for crates (Flower, Vortex)
`/handcrates --create={itemName} --blocktype={type} --command="give {player} example_id"`	Create the command of an item
`/handcrates --edit={itemName} --command="give {player} example_id"`	Edit the command of an item
`/handcrates --edit={itemName} --console=true`	Execute this command from console
`/handcrates --edit={item or crate name} --lore="..."`	Set item or crate lore
`/handcrates --edit={item or crate name} --display="..."`	Set item or crate display name
`/handcrates --give={item or crate name} --player={player}`	Give an item or crate to a player
`/handcrates --list=true`	List all crates
`/handcrates --delete={item or crate}`	Delete an item or crate
`/handcrates --reload=true`	Reload the plugin

Configurable Messages

Want the plugin to speak your server's language and tone? Every message is editable straight from config.json:

Key	Default value	Placeholder
`open`	`You open the chest {crates}`	`{crates}` → crate name
`give`	`You give crates {crates}`	`{crates}` → crate name
`recive`	`You recive crates {crates}`	`{crates}` → crate name
`inventory_full`	`<red> Your inventory not have amount space. </red>`	—

Installation

Drop the .jar file into your server's mods/ folder
Restart the server
Run /handcrates --list=true to confirm everything loaded correctly

That's it — you're ready to start building crates.

Permissions

Requires operator/admin status or the handcrates.admin permission to manage and edit crates.

Got an idea for a feature or ran into something weird? Drop your feedback and suggestions on the project page — Hand Crates keeps getting better with community input.

The Custom Item Command & Reward Team

3
Projects
144
Downloads