Home

Home

QuickKit Wiki

Welcome to the official QuickKit documentation.

QuickKit is a Fabric mod for Minecraft 1.21.11 that allows players to save, load, manage, and bind complete inventory kits. Designed for PvP practice, testing loadouts, and rapid inventory switching, QuickKit makes it easy to restore any saved setup instantly.

Features Save complete inventories as named kits Instantly load saved kits Rename and delete kits Manage kits through an in-game GUI Create reusable Kit Binders Preserve armor, offhand items, enchantments, custom names, lore, and components Per-player persistent storage Server-authoritative architecture Documentation Installation Commands GUI Guide Kit Binders Technical Details FAQ Troubleshooting Installation Requirements Minecraft 1.21.11 Fabric Loader 0.18.4 or newer Fabric API 0.141.3 or newer Java 21 Installing QuickKit Install Fabric Loader. Download and install Fabric API. Place the QuickKit .jar file inside your Minecraft mods folder. Launch Minecraft.

QuickKit is now ready to use.

Commands

All commands require Operator Level 2.

Save a Kit

/kit save

Saves your current inventory as a named kit.

Example:

/kit save crystal

Load a Kit

/kit load

Loads a previously saved kit.

Example:

/kit load crystal

Delete a Kit

/kit delete

Permanently deletes a kit.

Rename a Kit

/kit rename

Renames an existing kit.

Example:

/kit rename crystal crystal_v2

List Kits

/kit list

Displays all saved kits.

Create a Kit Binder

/kit bind

Creates a special item that loads the kit when used.

GUI Guide

Press K to open the QuickKit management screen.

The keybind can be changed through:

Controls → PVP Practice Mod

Kit List

The GUI displays all saved kits in a scrollable list.

Left Click

Loads the selected kit instantly and closes the GUI.

Right Click

Selects the kit and highlights it in blue.

Buttons

Load Kit

Loads the selected kit.

Save Inventory

Prompts for a kit name and saves your current inventory.

Delete Kit

Opens a confirmation dialog before deleting the selected kit.

Rename Kit

Allows the selected kit to be renamed.

Refresh

Reloads the kit list directly from the server.

Kit Binders

Kit Binders are special items that instantly load a saved kit.

Creating a Binder

/kit bind

Example:

/kit bind crystal

Binder Appearance

The binder is a glowing Nether Star containing:

Custom Name: Kit: Gold and Bold formatting Hidden kit identifier component Instructional lore text Using a Binder

Right-click the binder to instantly load the linked kit.

Binder Protection

If a kit load would overwrite the binder, QuickKit automatically attempts to move it into the next available inventory slot.

Technical Details Kit Storage

Kits are stored per-player in JSON files:

pvppractice_kits/.json

Serialization

QuickKit uses Minecraft's ItemStack.CODEC system to serialize inventory contents.

This preserves:

Enchantments Custom names Lore Components Armor Offhand items Durability Potion data Future vanilla item data Networking

QuickKit uses Fabric API networking.

Custom payloads:

C2SKitActionPayload S2CKitListPayload Data Components

QuickKit registers:

pvppractice:kit_name

which stores the linked kit name inside Kit Binders.

Server Architecture

QuickKit is fully server-authoritative.

The client only sends requests while the server performs:

Validation Kit loading Kit saving Inventory modification Disk persistence FAQ Where are kits stored?

Inside:

pvppractice_kits/.json

in the server run directory.

Are kits shared between players?

No.

Each player has their own kit file.

Do kits save enchantments?

Yes.

All enchantments and item data are preserved.

Can I rename kits?

Yes.

Use:

/kit rename

Can I delete kits?

Yes.

Use:

/kit delete

Do Kit Binders work in multiplayer?

Yes.

They are fully supported on multiplayer servers.

Troubleshooting The GUI does not open

Check that:

QuickKit is installed correctly Fabric API is installed The keybind is assigned Commands do not work

Ensure you have Operator Level 2 permissions.

My kit is missing

Verify that:

The kit was saved successfully The correct name is being used The player's kit JSON file exists A Kit Binder does not load a kit

Check that:

The referenced kit still exists The binder has not been modified by another mod The server and client are running the same QuickKit version Need More Help?

Open an issue on the GitHub repository and include:

Minecraft version Fabric Loader version Fabric API version QuickKit version Steps to reproduce the issue