Features
Weighted loot tables, visual animations, virtual & physical keys, and milestone rewards.
Architecture
Entry Library
Definitions
Core configuration for crates.Crate Definition
The main definition of a loot box.
Global Menu
Browse all available crates.
Actions
Triggering crate logic.Open Crate
Trigger an opening sequence.
Open Menu
Open the crate browsing menu.
Artifacts
Data storage.Crate Artifact
Persistent storage for keys and history.
Quick Start
1. Define
Add definition entries: crate, crate_main_menu. These define the structures, entities, or rules the extension operates on.→ crate → crate_main_menu
2. Create Storage
Add artifact entries to persist data: crate_artifact.→ crate_artifact
3. Trigger Actions
Use action entries to interact with the extension: open_crate, open_crate_menu. Trigger them from commands, NPCs, events, or other entries.→ open_crate → open_crate_menu
Commands
All commands are under the/crate prefix.
| Command | Description | Permission |
|---|---|---|
/crate menu | Open the global crate browsing menu | typewriter.crate.menu |
/crate give <crate_id> [amount] | Grant virtual keys to a player | typewriter.crate.give |
/crate remove <crate_id> [amount] | Revoke virtual keys from a player | typewriter.crate.remove |
Placeholders
All placeholders use the prefix%typewriter_crate_<crate_id>_%.
| Placeholder | Description |
|---|---|
%typewriter_crate_<id>_openings% | Total times opened by the player |
%typewriter_crate_<id>_keys% | Virtual keys held |
%typewriter_crate_<id>_milestone% | Highest reward milestone reached |
Dependencies
| Extension | Required | Usage |
|---|---|---|
| GUI Extension | Required | Menu rendering and layout system. |
| PlaceholderAPI | Optional | For @Placeholder fields. |