K
GitHub
Placements

Placements

Placements are the physical in-world locations where players interact with crates. Each placement links to a crate config and a block position.

What Are Placements?

A placement is the actual in-world block that players right-click to open a crate. One crate config can have multiple placements — for example, the same legendary crate placed in spawn, warzone, and the hub.

Crates vs placements
The crate config defines the reward pool, key mode, and settings. The placement just links a world position to that config. Changing the crate config affects all placements using it.

Place a Crate via Command

Stand at the exact block location where you want the crate, then run:

/bc setcrate <crate_id>
Example
/bc setcrate legendary

The block you're looking at (or standing on, depending on config) will become the crate placement. It will register in the placements list immediately.

Place via Crate Item

If you prefer a physical item-based placement workflow, give yourself the crate item first:

/bc givecrate <crate_id> <player>

Then place the crate item in the world as you would any block. The item will register as a crate placement at that position automatically.

Example
/bc givecrate legendary Steve

Managing Placements

Use these commands to inspect, remove, and navigate placements:

/bc removecrate

Remove the crate placement at your current location (stand next to the crate block).

/bc listcrates

List all registered crate placements with their IDs, crate type, and world coordinates.

/bc teleportcrate <placement_id>

Teleport to a specific placement by its placement ID.

Placement IDs
Placement IDs are auto-generated on creation and visible in /bc listcrates. Use them for teleport and removal operations.