K
GitHub
Keys

Key Types

BloodlineCrates supports two key modes. Each crate uses exactly one key mode at a time — physical items or virtual data keys.

Overview

Keys are what players consume to open a crate. The key mode is defined per-crate and can be changed at any time via the in-game editor without losing crate data.

One mode per crate
Each crate can only use one key mode at a time. Switching modes from PHYSICAL to VIRTUAL (or vice versa) takes effect immediately on the next /bc reloadcrates.

Physical Keys

Physical keys are real inventory items. Players must have the key item in their inventory to open the crate. The key is consumed on use.

Give physical keys

/bc givekey <crate_id> <player> [amount]

Examples

# Give 1 key to a player
/bc givekey legendary Steve 1

# Give 10 keys
/bc givekey legendary Steve 10

Display item

The physical key's display item, name, and lore are configured per-crate inside the editor under the "Key Display" section.

Best practice
Use distinctive, visually recognizable items for physical keys. Players need to identify them quickly in their inventory.

Virtual Keys

Virtual keys are stored directly in player data — no inventory slot required. They work identically to physical keys from the player's perspective but don't appear in the inventory.

Give virtual keys

/bc givevirtualkey <crate_id> <player> [amount]

Examples

# Give 3 virtual keys
/bc givevirtualkey vote Steve 3

# Give 1 virtual key from a reward command
/bc givevirtualkey seasonal {player} 1
Virtual keys and rewards
Virtual keys are ideal for automated systems — vote rewards, purchase hooks, and crate-type rewards that give keys to other crates. No inventory management needed.

Switching Key Modes

You can switch a crate's key mode at any time from within the in-game editor.

  1. 1Open the editor with /bc editor
  2. 2Navigate to the crate you want to modify
  3. 3Go to the Key Mode section
  4. 4Toggle between PHYSICAL and VIRTUAL
  5. 5Save and run /bc reloadcrates
Key balance not migrated
Switching key modes does not migrate existing key balances. Players with physical keys will lose them when you switch to virtual mode. Plan mode switches before distributing keys.
← Create CratesNext: Placements →