# Kits Bookshelf's kit system allows you to save a player's entire state — inventory, health, hunger, XP, potion effects, and optionally their location — and restore it later. Kits can be shared between servers via export codes. --- ## Opening the Kit GUI ``` /kit ``` Opens a menu showing all available kits. From the GUI you can view kit contents and apply them. --- ## Saving a Kit ``` /kit save [player] <id> [-l] ``` Saves the target player's current state as a kit with the given ID. If no player is specified, saves your own state. **What gets saved:** - Full inventory contents (including armor and offhand) - Health and max health - Food level and saturation - Experience level and points - Absorption hearts - Fire ticks - All active potion effects (type, amplifier, duration) - Location (only if `-l` flag is used) Each kit is stored as a YAML file in the `kits/` folder with a timestamp. --- ## Loading a Kit ``` /kit give [targets] <kit> ``` Applies a kit to yourself or specified targets. This restores all saved state: inventory, health, stats, and potion effects. If the kit has a saved location and the world exists, the player is teleported there. ### Weighted Random Selection You can specify multiple kits with weights for random selection: ``` /kit give <targets> 50%warrior,30%archer,20%mage ``` Each kit is given a probability weight. In this example: - 50% chance of receiving the **warrior** kit - 30% chance of receiving the **archer** kit - 20% chance of receiving the **mage** kit This is useful for random class assignment in minigames or events. --- ## Exporting and Importing Kits ### Export ``` /kit export <id> ``` Generates a shareable code for the kit using GZIP compression and Base64 encoding. If the code is short (under 200 characters), it's displayed directly. Otherwise, it's uploaded to [mclo.gs](https://mclo.gs) and a clickable URL is returned. ### Import ``` /kit import <id> <code> ``` Imports a kit from a code or mclo.gs URL and saves it with the given ID. --- ## Deleting a Kit ``` /kit delete <id> ``` Removes the kit file permanently. --- ## Permissions | Permission | Description | |---|---| | `lodestone.bookshelf.commands.utility.kit` | Base kit command and GUI access | --- ## Related Pages - [[Bookshelf/Server Owners/Commands]] - Quick command reference - [[Bookshelf/Server Owners/Features/Utilities]] - Other utility commands