← Plugins · HyPrison Core

Crates

Crate types with weighted rewards (items, tokens, money, keys). Players open crates with keys; admins configure crates and give keys. Crates can be linked to in-world entities so interacting with the entity opens that crate.

Commands

• /crate list — List configured crates and display names.
• /crate open <crateId> — Open the crate UI (consumes one key per open).
• /crate editor — Open the Crate Editor (admin). Create and edit crate types, rewards, and entity links.
• /crate givekey <player> <crateId> [amount] — Give keys to a player (admin).

Alias /crates works for all. Permissions: hyprisoncore.admin for editor and givekey.

Crate Editor

In-game editor: crate list, id, display name, and rewards. Reward types: item, tokens, money, keys. Each reward has a weight (relative chance). Create New Crate, Add Reward, Duplicate (new crate with same rewards), Save, Delete. Use the Item Picker (right panel) to set item rewards: click PICK on a reward row, then USE on an item in the list.

Entity linking

You can link a crate to an in-world entity. When a player interacts (Use key) with that entity, the crate UI opens for that crate — no need to run /crate open.

1. Place an entity with Hytale’s entity tool where you want the “crate” (e.g. a chest, prop, or NPC-looking entity).
2. Open /crate editor, select the crate, and click Link to entity.
3. Stand within 10 blocks of the entity; the editor shows nearby entities. Click Link on the one you want.
4. That entity is now linked. Players can Use it to open the crate (if they have keys). Use Unlink entity in the editor to clear the link.

Only one crate per entity. Links persist in Config/crates.json (LinkedEntityUuid per crate) and are re-applied on server restart.

Block linking and hologram

You can also link a crate to a block (e.g. a chest in the world): use Link to block in the Crate Editor and target the block. Optionally set a Hologram ID (same ID as a hologram in the Hologram Editor). When both block link and hologram ID are set, that hologram is placed above the crate block; saving the crate updates the hologram position. Crate-linked holograms persist after server restart — their positions are synced from crate definitions on startup.

Config

Crates: Config/crates.json — each crate has Id, DisplayName, Rewards (array of type, item/quantity/amount/key/weight), optional LinkedEntityUuid, optional LinkedBlockWorld/LinkedBlockX/Y/Z, and optional LinkedHologramId. Keys: per-player key counts are stored in Config/crate_keys.json (created when first keys are given).